Memberships
List 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
get/v2/memberships
Headers
X-Qonto-Staging-Tokenstring
Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.
Response
list memberships for a given organization
Example response
{
"memberships": [
{
"id": "c9f9f051-7558-451c-b310-f4b8521424aa",
"first_name": "Quinn Jast",
"last_name": "Miss Stan Altenwerth",
"role": "owner",
"residence_country": "FR",
"birthdate": "2022-11-27",
"nationality": "FR",
"birth_country": "IT",
"status": "active"
}
],
"meta": {
"current_page": 2,
"prev_page": 1,
"total_pages": 2,
"total_count": 150,
"per_page": 100
}
}