---
title: "Close Account"
method: DELETE
path: "/digital-banking/v1/accounts/{account_id}"
tags: ["Accounts"]
---

# Close Account

`DELETE /digital-banking/v1/accounts/{account_id}`

## Request

- Base URL: `https://api.modernfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.modernfi.com/digital-banking/v1/accounts/{account_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/modernfi/apis/endpoints/docs/digital-banking/v1/accounts/:account_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint closes an account after verifying access. The account's ledger balance must be zero before closure: requests for accounts with a non-zero balance are rejected. Withdraw remaining funds first, via your integration or a booked withdrawal.

## Path parameters

- `account_id` string, uuid, required

## Response `200`

Successful Response

- CloseAccountResponse
  - `account_id` string, required
  - `liquidation_amount` string, required
  - `scheduled_to_close_date` string, date, required

## Other responses

- `400`: Bad Request - Invalid input or validation error
- `401`: Unauthenticated - Invalid or missing authentication credentials
- `403`: Unauthorized - Insufficient permissions to access resource
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/modernfi/apis/endpoints.md) - [All operations](https://skmtc.dev/modernfi/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/modernfi/apis/endpoints/revisions/4bf4ac474dc0?raw)