---
title: "Delete a bank account and everything that belongs to it"
method: DELETE
path: "/api/v1/banking/accounts/{id}"
tags: ["Money"]
---

# Delete a bank account and everything that belongs to it

`DELETE /api/v1/banking/accounts/{id}`

## Request

- Base URL: `http://localhost:5180`
- URL: `http://localhost:5180/api/v1/banking/accounts/{id}`
- Auth: API key in cookie `better-auth.session_token`

Removes the account, its feed, every movement on it and every statement import that brought one in. Where a bank was reading it, it is let go at the service first, which is what stops it being billed there. A payment that named the account is kept: the money did arrive, so it keeps its amount, its date and its allocations and loses only the account it landed on. This cannot be undone, and reconciliation over the removed movements goes with them. To keep the history and only stop the feed, set the feed to `closed` instead. Owners only.

## Path parameters

- `id` string, required

## Response `200`

Gone.

- object
  - `ok` unknown, required
  - `data` object, required
    - `deleted` boolean, required
    - `movements` number, required: Movements removed with it.
    - `statements` number, required: Statement imports removed with it.
    - `payments` number, required: Payments that kept their amount and lost the account they arrived on.
    - `atService` boolean, required: Where it was read from a bank, whether the service confirmed it stopped.
  - `meta` object, required
    - `requestId` string, required: Echoed in the x-request-id header. Quote it in a bug report.

## Other responses

- `403`: Owners only.
- `404`: No such bank account on this team.

---

[API](https://skmtc.dev/dardaris/apis/dardaris-api.md) · [All operations](https://skmtc.dev/dardaris/apis/dardaris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dardaris/apis/dardaris-api/revisions/4aff33835c73?raw)