--- title: "Delete a bank account" method: DELETE path: "/v1/bankaccounts/{id}" tags: ["BankAccounts"] --- # Delete a bank account `DELETE /v1/bankaccounts/{id}` ## Request - Base URL: `https://api.altoviz.com` - URL: `https://api.altoviz.com/v1/bankaccounts/{id}` - Auth: none required - TypeScript: (a function with typed inputs; its response is checked against the schema) Deleting a bank account is irreversible and reaches past the account itself. It removes every transaction the account holds, and — unless another account shares it — the accounting journal attached to it together with every accounting entry written in that journal. There is no undo, and no export is taken first. Three cases are refused rather than deleted, so the destructive path is narrow: — 409 when the account holds transactions already reconciled with a receipt, a supplier or colleague payment, or a miscellaneous operation. This API never overrides that check, so an account with any bookkeeping against it cannot be deleted here at all: detach or delete those settlements in the Altoviz application first, and consider whether you meant to. — 400 when the account is connected to a provider, i.e. its `provider` is set. — 400 when the account is the company's main one. What survives the 409 gate is an account with no reconciled transactions, so in practice this deletes an account that was created by mistake or never used. If you only want it out of the way of day-to-day work, there is nothing to delete: leave it in place. ## Path parameters - `id` integer, required ## Response `200` OK ## Other responses - `400`: Bad Request - `404`: Not Found - `409`: Conflict ## Changes - **2026-09-14** `4f7fa64cf9e3`: 1 info - endpoint added [Operation history](https://skmtc.dev/altoviz/apis/altoviz-api/changes/v1/bankaccounts/:id/delete.md) --- [API](https://skmtc.dev/altoviz/apis/altoviz-api.md) - [All operations](https://skmtc.dev/altoviz/apis/altoviz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altoviz/apis/altoviz-api/revisions/4f7fa64cf9e3?raw)