--- title: "POST /v0/bank/accounts/{bank-account-id}/actions/close" method: POST path: "/v0/bank/accounts/{bank-account-id}/actions/close" tags: ["Bank accounts"] --- # POST /v0/bank/accounts/{bank-account-id}/actions/close `POST /v0/bank/accounts/{bank-account-id}/actions/close` ## Request - Base URL: `https://api.griffin.com` - URL: `https://api.griffin.com/v0/bank/accounts/{bank-account-id}/actions/close` - Auth: API key in header `Authorization` Close a bank account ## Path parameters - `bank-account-id` string, required ## Response `200` OK - object - `account-submissions-url` union, required: Link to the [payment submissions](#tag/Payments) debiting from this account. - string - string - `bank-account-product-url` union: Link to the [bank account](#tag/Bank-accounts) product. - string - string - `account-restricted` boolean, required: Specifies whether the bank account has restrictions applied by Griffin. - `account-payments-url` union, required: Link to the [payments](#tag/Payments) associated with this account. - string - string - `pooled-account-memberships-url` union: Link to the list of [pool members](#tag/Pooled-account-membership) associated with this account. - string - string - `account-admissions-url` union, required: Link to the [payment admissions](#tag/Payments) crediting to this account. - string - string - `bank-product-type` 'savings-account' | 'client-money-account' | 'safeguarding-account' | 'embedded-account' | 'operational-account', required: Specifies the type of bank account. (For more detail on bank account types, see our guide for [types of bank accounts](/docs/guides/types-of-bank-accounts). - `account-mandates-url` union: Link to the direct debit mandates associated with this account. - string - string - `display-name` string, required: The mutable display name for the bank account - `controller-url` string, required: Link to the [legal person](#tag/Legal-persons) that represents the [controller](/docs/terms/controller) of the account. - `pooled-funds` boolean, required: Specifies whether the bank account holds funds belonging to multiple beneficiaries. - `accrued-interest` object, required: Shows the [accrued interest](/docs/terms/accrued-interest). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `account-status` 'closing' | 'open' | 'closed' | 'opening', required: Shows the status of the account. An account can be moved between statuses during its lifecycle. The status value affects the operations that you can perform. An account must be `"open"` to be fully operational. - `client-money-type` 'designated-client-fund' | 'designated-client-money' | 'general-client-money': Specifies the type of client money account. - `owner-url` union, required: Link to the [legal person](#tag/Legal-persons) that represents the [owner](/docs/terms/owner) of the account. - string - string - `closed-at` string, date-time: ISO 8601 formatted date-time. - `created-at` string, date-time, required: ISO 8601 formatted date-time. - `opened-at` string, date-time: ISO 8601 formatted date-time. - `close-account-url` union: Link to the endpoint that enables account closure for this account. - string - string - `available-balance` object, required: Shows the [available balance](/docs/terms/available-balance). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `pooled-account-membership-updates-url` union: Link to manage [pooled account membership](#tag/Pooled-account-membership) - string - string - `bank-account-restrictions-url` union: Link to the [restrictions](#tag/Bank-account-restrictions) on this account. - string - string - `bank-addresses` object[]: Shows a collection of public addresses which uniquely identify the account. Any one of these can be used to pay into the account. - `account-holder` string, required: The name of the [account holder](/docs/terms/account-holder). - `bank-id-code` 'gbdsc', required - `bank-id` string, required: A UK sort code. - `account-number` string, required: A UK account number. - `account-number-code` 'bban', required - `account-transactions-url` union, required: Link to the [transactions](#tag/Transactions) associated with this account. - string - string - `account-url` union, required: Link to the bank account resource. - string - string - `bank-account-events-url` union: Link to the events for this bank account. - string - string - `beneficiary-url` union: Link to the [legal person](#tag/Legal-persons) that represents the [beneficiary](/docs/terms/beneficiary) of the account. - string - string - `primary-account` boolean, required: Specifies whether the bank account is the organization's [primary account](/docs/guides/primary-account). - `account-balance` object, required: Shows the [account balance](/docs/terms/account-balance). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `savings-type` 'easy-access' | 'bare-trust': Specifies the type of savings account. - `account-statements-url` union, required: Link to the [statements](#tag/Statements) requested for this account. - string - string ## Other responses - `401`: Requires an API key to continue - `404`: Not Found - `422`: An error occurred when trying to close the bank account. See [https://docs.griffin.com/docs/errors/account-close](https://docs.griffin.com/docs/errors/account-close) for details. ## Changes - **2026-09-19** `3e69d9e24ef6`: 1 info - api operation id `post-bank-accounts-bank-account-id-actions-close` was added [Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/bank/accounts/:bank-account-id/actions/close/post.md) --- [API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)