Skip to main content

Close a bank account

This guide will show you how to close a bank account via the API. It covers all types of bank accounts.

Prerequisites​

The bank account's account-status must be open and must not be your organization's primary account.

Closing the account​

caution

Account closure is permanent. Once closed, a bank account cannot be reopened. Learn more about the bank account lifecycle.

You will need the close-account-url for the bank account, which was returned in the response when the account was first created, and can be retrieved by getting the account.

note

A close-account-url will not be provided in the response when retrieving your organization's primary account.

curl "https://api.griffin.com${CLOSE_ACCOUNT_URL}" \
  -X 'POST' \
  -H "Authorization: GriffinAPIKey $GRIFFIN_API_KEY"
info

There is no POST data for this action.

A successful response will look like this:

{
  "account-url": "/v0/bank/accounts/ba.3XbMWgUWQMumdJBCMilreA",
  "primary-account": false,
  "available-balance": {
    "currency": "GBP",
    "value": "0.00"
  },
  "display-name": "Acme Operational Account",
  "account-restricted": false,
  "beneficiary-url": "/v0/legal-persons/lp.nrycmOSNVyC2t_5JAxn0Zw",
  "account-balance": {
    "currency": "GBP",
    "value": "0.00"},
  "account-transactions-url": "/v0/bank/accounts/ba.3XbMWgUWQMumdJBCMilreA/transactions",
  "account-payments-url": "/v0/bank/accounts/ba.3XbMWgUWQMumdJBCMilreA/payments",
  "bank-product-type": "operational-account",
  "bank-addresses": [
    {
      "account-holder": "Acme Ltd.", 
      "bank-id": "000000", 
      "account-number": "17990030"}],
  "owner-url": "/v0/legal-persons/lp.nrycmOSNVyC2t_5JAxn0Zw",
  "close-account-url": "/v0/bank/accounts/ba.3XbMWgUWQMumdJBCMilreA/actions/close",
  "account-status": "closing",
  "controller-url": "/v0/legal-persons/lp.nrycmOSNVyC2t_5JAxn0Zw"}

The account is placed into a closing state and will no longer accept inbound payments. Any payment sent to a closing account will be marked with status failed.

The account-status will not move from closing to closed until any accrued interest has been paid out and the account balance is zero. You may need to transfer any remaining funds out of the account, at which point the the account-status will move to closed automatically.

Errors​

Closing an account might fail for the following reasons. Each will return HTTP status 422.

  • account-not-found. Could not find the account.
  • account-already-closing. The account-status is already closing.
  • account-already-closed. The account-status is already closed.
  • account-not-open. The account-status is opening. The account cannot be closed until it is fully open.
  • primary-account-not-closeable. The account is a primary account, which cannot be closed.