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

# Get organization and its bank accounts

`GET /v2/organization`

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.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/revisions/25208d6f9deb/schema)