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

# List memberships

`GET /v2/memberships`

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

---

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