v2

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-245593419.2 KB
Organizations

Get organization and its bank accounts

OAuth scope: organization.read


Retrieves the details and the list of bank accounts for the authenticated organization.


The bank account's id or iban will be required to retrieve the list of transactions inside that bank account, using /v2/transactions.

get/v2/organization

Query parameters

include_external_accountsboolean

By default includes only Qonto accounts. Set to 'true' if you also want to include your connected externals account(s).

Headers

X-Qonto-Staging-Tokenstring

Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.

Response

Returns the organization and its bank accounts. The organization returned is determined from the secret_key or the OAuth2.0 access_token.

Example response

{
  "organization": {
    "slug": "elektro-tesla-gmbh-3066",
    "legal_name": "Elektro Tesla GmbH",
    "locale": "de",
    "legal_share_capital": 1000,
    "legal_country": "DE",
    "legal_registration_date": "2022-11-27",
    "legal_form": "GmbH",
    "legal_address": "Fritz-Arnold-Str. 18 85614 Kirchseeon GERMANY",
    "legal_sector": "6200Z",
    "contract_signed_at": "2022-12-01 08:57:00.123047",
    "legal_number": "12A34FC5",
    "bank_accounts": [
      {
        "id": "018f71db-c635-78b5-b90a-ea05de98c2bf",
        "iban": "FR7616798000010000005663951",
        "currency": "EUR",
        "updated_at": "2024-07-02T08:25:11.155Z"
      }
    ]
  }
}