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

Request

Base URL
https://thirdparty.qonto.com
Auth
- OAuth 2
  Authorization codehttps://oauth.qonto.com/oauth2/auth
  Token URLhttps://oauth.qonto.com/oauth2/token
  Scopesorganization.read
- or API key in header Authorization

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"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.