Bank accounts

Delete a bank account

Soft-deletes a bank account, which is only allowed while it has no transactions and no reconciliation periods. Requires the bank_accounts:delete permission.

DELETE

https://services.magicdoor.com/accounting/company-portal/bank-accounts/{bankAccountId}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

bankAccountIdstringrequired

Snowflake id of the bank account.

example: 1830472847398404096

Response

200 · The bank account, now deleted. It no longer appears in the list.

idstring

Snowflake id of the bank account.

createdstring · date-time

When the bank account was created, in the company's timezone.

updatedstring · date-time

When the bank account was last changed, in the company's timezone.

namestring

The name property managers see in account pickers, for example "Operating — Chase".

descriptionstring

Free-text note about the account. Absent when none was set.

accountNumberstring

The bank account number, 4 to 17 digits. Absent when the account was created without one.

routingNumberstring

The nine-digit ABA routing number. Absent when the account was created without one.

typeenum<string>

What kind of account this is at the bank. Absent when it was never set.

checkingsavings

companyAccountboolean

true when the money in this account belongs to the management company itself rather than to owners or tenants. Fixed at creation; no endpoint changes it.

activeboolean

false after a deactivate call. An inactive account stays readable and keeps its history, and its routing and account number no longer block another account from using the same pair.

scheduledSweepDaysinteger[]

Days of the month, 1 to 31, on which a sweep is scheduled for this account. Empty when no sweep is scheduled.

chartOfAccountIdsstring[]

Snowflake ids of the asset chart-of-account entries this bank account posts its cash side to. Always at least one.

creatorobject

Who last touched the bank account. Deprecated mirrors of id — propertyManagerId, tenantId, vendorId, ownerId — are also present, whichever matches type.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `bank_accounts:delete` permission.

404 · No bank account with this id belongs to the caller's company, or it has been deleted.

422 · The bank account has transactions, or it has reconciliation periods. The `detail` says which.

Deletion is not the way to retire a used account

A bank account that has ever carried a transaction, or that has been reconciled even once, can never be deleted. Deactivate it instead — it drops out of pickers, keeps its history, and releases its routing and account number.