---
title: "Get organization and its bank accounts"
method: GET
path: "/v2/organization"
tags: ["Organizations"]
---

# Get organization and its bank accounts

`GET /v2/organization`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/organization`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://oauth.qonto.com/oauth2/auth`
    - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `organization.read`
  - API key in header `Authorization`

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](/reference/openapi_v2.yml/paths/~1v2~1transactions/get).

## Query parameters

- `include_external_accounts` boolean

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

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

- object
  - `organization` object
    - `id` string: UUID of the organization.
    - `name` string: Name of the organization.
    - `slug` string: Slug based on organization's legal name.
    - `legal_name` string, nullable: Registered name of the organization.
    - `locale` string: Default language set for the organization.
    - `legal_share_capital` number: Informed share capital, expressed in euros.
    - `legal_country` string: Country of incorporation of the organization.
    - `legal_registration_date` string, nullable: Date of incorporation of the organization.
    - `legal_form` string: Legal formation of the organization.
    - `legal_address` string: Address of the organization.
    - `legal_sector` string, nullable: Code of the organization's activity sector.
    - `contract_signed_at` string, date-time: Date and time, in UTC, the account was opened.
    - `legal_number` string: Unique number of registration (e.g.: SIRET in France).
    - `bank_accounts` object[]
      - `id` string: UUID of the bank account.
      - `slug` string: Slug of the bank account based on the organ's slug.
      - `iban` string: Might be empty for external accounts (i.e. when `is_external_accounts == true`).
      - `bic` string: Might be empty for external accounts (i.e. when `is_external_accounts == true`).
      - `currency` string: Currency of the bank account.
      - `balance` number, float: Actual amount of money on the account, in euros.
      - `balance_cents` integer: Actual amount of money on the account, in euros.
      - `authorized_balance` number, float: Amount available for payments, taking into account transactions that are being processed. [More information here](https://support.qonto.com/hc/en-us/articles/115000493249-How-is-the-balance-of-my-account-calculated-).
      - `authorized_balance_cents` integer: Amount available for payments, taking into account transactions that are being processed. [More information here](https://support.qonto.com/hc/en-us/articles/115000493249-How-is-the-balance-of-my-account-calculated-).
      - `name` string: Name of the bank account.
      - `updated_at` string: Date and time, in UTC, of the last update of the bank account.
      - `status` 'active' | 'closed': Status of the bank account.
      - `main` boolean: Sets to`true` if the bank account is used for billing. There is only one main account in a given organization.
      - `is_external_account` boolean: Sets to `true` if the bank account is not a Qonto account (cf. https://support-fr.qonto.com/hc/en-us/articles/24231375285777-How-to-connect-my-external-accounts-to-my-Qonto-interface).
      - `account_number` string, nullable: Might be empty for Qonto accounts (i.e. when `is_external_account == false`).

## Other responses

- `401`: Returns an unauthorized error.

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)