Penny Docs
Accounts

Delete Account

DELETE
/v1/households/{household_id}/accounts/{account_id}

Soft-deletes an account, removing it and its transactions from normal household views and reports. The account can be restored while its records are retained.

If every account on a Plaid connection has been deleted for at least seven days, the connection and its accounts, transactions, and balance history can be permanently removed. Restore before then to keep the account. This cleanup does not apply to Apple or manual accounts, or to Plaid connections with an undeleted account.

Also removes the account from rule conditions and deletes rules that are left without criteria. Restoring the account does not recreate those rule conditions. Returns 204 with no response body.

Authorization

PersonalApiToken
AuthorizationBearer <token>

Use your personal API token (penny_pat_…) as the bearer credential. Enter the token only; the client adds the Bearer prefix. Read-only tokens permit read requests. Read/write tokens remain limited by your current household membership and role. See https://penny.finance/docs/api#authentication for setup.

In: header

Path Parameters

household_id*Household Id
account_id*Account Id

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/households/string/accounts/string"
Empty