Close a business account

OAuth scope: bank_account.write

Accessible only using Strong Customer Authentication.

Example of SCA usage: Postman visual flow

Closes a specific business account identified by its ID.

Once closed, the account can no longer be used for transactions. Before closing an account, ensure it has a zero balance and no pending transactions. The main account cannot be closed.

Restrictions:

You cannot close your main account.
You cannot close an businesss account with a non-zero balance.
External businesss accounts cannot be closed through this API.

POST

bank_accounts

{id}

curl --request POST \
  --url https://thirdparty.qonto.com/v2/bank_accounts/{id}/close \
  --header 'Authorization: Bearer <token>'

{
  "bank_account": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Primary bank account",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "active",
    "main": true,
    "iban": "FR7610004000000112345678901",
    "bic": "BNPAFRPPXXX",
    "currency": "EUR",
    "balance": 142188.43,
    "balance_cents": 14218843,
    "authorized_balance": 141148.12,
    "authorized_balance_cents": 14114812,
    "updated_at": "2024-04-03T12:00:00.000Z",
    "is_external_account": false,
    "account_number": 1234567890
  }
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

X-Qonto-Sca-Session-Token

string

SCA session token for strong customer authentication

X-Qonto-MFA

string

MFA token for strong customer authentication

X-Qonto-2fa-Preference

string

2FA preference for the request

Path Parameters

string

required

ID of the business account to close

Response

200

application/json

Business account closed successfully

The response is of type object.

curl --request POST \
  --url https://thirdparty.qonto.com/v2/bank_accounts/{id}/close \
  --header 'Authorization: Bearer <token>'

{
  "bank_account": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Primary bank account",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "active",
    "main": true,
    "iban": "FR7610004000000112345678901",
    "bic": "BNPAFRPPXXX",
    "currency": "EUR",
    "balance": 142188.43,
    "balance_cents": 14218843,
    "authorized_balance": 141148.12,
    "authorized_balance_cents": 14114812,
    "updated_at": "2024-04-03T12:00:00.000Z",
    "is_external_account": false,
    "account_number": 1234567890
  }
}