Skip to main content
GET
/
v2
/
user_organizations
List organizations for the authenticated user
curl --request GET \
  --url https://thirdparty.qonto.com/v2/user_organizations \
  --header 'Authorization: Bearer <token>'
{
  "organizations": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Acme Corp",
      "legal_name": "Acme Corporation SAS",
      "legal_number": "12345678900010",
      "legal_country": "FR",
      "membership_role": "owner"
    },
    {
      "id": "987fcdeb-51a2-43f7-9012-345678901234",
      "name": "Omega Ltd",
      "legal_name": "Omega Limited GmbH",
      "legal_number": "HRB 12345",
      "legal_country": "DE",
      "membership_role": "admin"
    }
  ]
}
This endpoint returns a list of organizations that the user consented to give access to. This endpoint is only available for user oauth flow. It gives you the list of organizations that the user has consented to give access to, and the organization_id for each organization. You can use the organization_id to make API calls on behalf of that organization.

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.

Response

Returns the list of organizations the authenticated user belongs to.

​
organizations
object[]
required