Get a business account

OAuth scope: organization.read

Retrieves detailed information about a specific business account identified by its ID.

It is useful for retrieving up-to-date information, including the current balance and authorized balance of the account.

You can use this endpoint when you need to display account details or verify available funds before initiating a transfer.

Restricted Fields

Full details of a business account are restricted to users with specific permissions (more on permissions). Owners and admins can access all fields. Other users, such as managers, will only see a limited set of fields unless granted the appropriate permissions.

Fields Available to All Users:

id
name
status
main
organization_id

Fields Available to Users with Balance Authorization Read:

currency
balance
balance_cents
authorized_balance
authorized_balance_cents

Depending on the user’s permissions, the corresponding fields will be included in the response.

GET

bank_accounts

{id}

curl --request GET \
  --url https://thirdparty.qonto.com/v2/bank_accounts/{id} \
  --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.

Path Parameters

string

required

ID of the business account to retrieve

Response

200

application/json

Business account retrieved successfully

The response is of type object.

curl --request GET \
  --url https://thirdparty.qonto.com/v2/bank_accounts/{id} \
  --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
  }
}