Close Account

POST /v1/accounts/{id}/close

Closes an account. The remaining balance is drained to the system control account. No further transfers can touch this account.

This is reversible. See Reopen Account.

Response 200

{
  "data": {
    "tenant_id": "f714f6af-...",
    "closing_transfer_id": "19d4f06537a8e467070f0cfe766b5be0",
    "account": {
      "id": "ba9755d7e835cdeea6bca803721c7eba",
      "ledger": 1001,
      "code": 100,
      "balance_type": "credit",
      "status": "closed",
      "created_at": "2026-04-06T22:45:01Z"
    }
  }
}

Save the closing_transfer_id. You need it to reopen the account.

Headers

Authorization: Bearer qk_live_...
Idempotency-Key: <unique-string>

Errors

Code	Type	Meaning
404	not_found	Account not found
422	account_closed	Already closed