---
title: "List memberships"
method: GET
path: "/v2/memberships"
tags: ["Memberships"]
---

# List memberships

`GET /v2/memberships`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/memberships`
- 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`

---

Retrieve all memberships within the organization.

---

The response contains the list of memberships that are linked to the authenticated company.
A member is a user who's been granted access to the Qonto account of a company. There is no limit currently to the number of memberships a company can have.

The response contains the following attributes:
  - `id` - The membership's id. It uniquely identifies the membership
  - `first_name` - The first name of the membership
  - `last_name` - The last name of the membership
  - `role` - Role of the membership: `owner`, `admin`, `manager`, `reporting`, `employee`

For Spain companies, the list also contains data about the UBOs (Ultimate Beneficiary Owner) of the company in addition to the fields above:
  - `residence_country` - Residential country of the member
  - `birthdate` - Date of birth of the member
  - `nationality` - The nationality of the member
  - `ubo` - The possession of the member: `true`, `false`
  - `birth_country` - The birth country of the member

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

list memberships for a given organization

- object
  - `memberships` object[]
    - `id` string, uuid
    - `first_name` string
    - `last_name` string
    - `role` 'owner' | 'admin' | 'manager' | 'reporting' | 'employee'
    - `residence_country` string, nullable
    - `birthdate` string, date, nullable
    - `nationality` string, nullable
    - `ubo` boolean, nullable
    - `birth_country` string, nullable
    - `status` string
  - `meta` Pagination
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `401`: returns an unauthorized error
- `403`: returns a forbidden error

## Changes

- **2025-01-24** (v2) `25208d6f9deb`: 2 breaking
  - the `meta/next_page` response's property type changed from no type to `integer` for status `200`
  - the `meta/prev_page` response's property type changed from no type to `integer` for status `200`

[Operation history](https://skmtc.dev/hiit-consulting-fr/apis/qonto/changes/v2/memberships/get.md)

---

[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)