---
title: "List user memberships"
method: GET
path: "/v0/users/{user-id}/memberships"
tags: ["Memberships"]
---

# List user memberships

`GET /v0/users/{user-id}/memberships`

Returns this [user's](#tag/Users) [memberships](#tag/Memberships).

## Path parameters

- `user-id` string, required

## Query parameters

- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object
  - `memberships` object[], required
    - `membership-url` union, required — Link to the [membership](#tag/Memberships).
      - string
      - string
    - `membership-roles-url` union, required — Link to the assigned [roles](#tag/Roles) for this [membership](#tag/Memberships).
      - string
      - string
    - `organization` object, required
      - `own-legal-person-url` union, required — Link to the [legal person](#tag/Legal-persons) that represents the [organization](#tag/Organizations); this can be an individual or a company.
        - string
        - string
      - `organization-mode` 'test-mode' | 'live-mode', required — The organization can either be a sandbox organization or a live one; Check out our guide for [sandbox mode vs live mode](/docs/guides/sandbox-vs-live-mode).
      - `organization-memberships-url` string, required — Link to the [memberships](#tag/Memberships) for this [organization](#tag/Organizations).
      - `organization-invitations-url` string, required — Link to the resource that enables you to [invite](#tag/Invites) new [users](#tag/Users) to this [organization](#tag/Organizations).
      - `organization-payments-url` union, required — Link to the [payments](#tag/Payments) associated with this organization.
        - string
        - string
      - `organization-bank-account-products-url` union, required — Link to the [bank account](#tag/Bank-accounts) products owned by this [organization](#tag/Organization).
        - string
        - string
      - `organization-onboarding-applications-url` string — Link to the [Reliance onboarding](#tag/Reliance-onboarding).
      - `display-name` string, required — The mutable display name for the Organisation
      - `organization-bank-accounts-search-url` union, required — Link to search [bank accounts](#tag/Bank-accounts) associated with this [organization](#tag/Organizations).
        - string
        - string
      - `organization-api-keys-url` string, required
      - `organization-live-access-url` string, required — Link to the resource that enables you to request live access.
      - `organization-webhooks-url` string, required — Link to the endpoint which enables webhook creation.
      - `organization-workflows-url` string, required — Link to the onboarding [workflows](#tag/Workflows) configured for this [organization](#tag/Organizations).
      - `organization-bank-accounts-url` string, required — Link to the [bank accounts](#tag/Bank-accounts) managed by this [organization](#tag/Organizations).
      - `available-roles` object[], required — The subset of [roles](#tag/Roles) available to [members](#tag/Members) of this [organization](#tag/Organizations).
        - `display-name` string, required — The mutable display name for the Organisation
        - `description` string, required
        - `role-url` union, required — Link to the [role](#tag/Roles).
          - string
          - string
        - `role-category` string
      - `can-decide-on-verifications?` boolean, required — Is this organization able to make manual decisions on verifications?
      - `organization-url` string, required — Link to the [organization](#tag/Organizations).
      - `organization-payments-search-url` union, required — Link to search [payments](#tag/Payments) associated with this organization.
        - string
        - string
      - `organization-individuals-url` string, required
      - `organization-corporations-url` string, required
      - `organization-legal-persons-url` string, required — Link to the [legal persons](#tag/Legal-persons) grouped under this [organization](#tag/Organizations).
      - `organization-legal-persons-search-url` string, required — Link to search [legal persons](#tag/Legal-persons) grouped under this [organization](#tag/Organizations).
      - `organization-events-url` string, required — Link to the endpoint which lists an organization's events.
    - `roles` object[], required — Shows a collection of [roles](#tag/Roles).
      - `display-name` string, required — The mutable display name for the Organisation
      - `description` string, required
      - `role-url` union, required — Link to the [role](#tag/Roles).
        - string
        - string
      - `role-category` string
    - `user` object, required — Shows the associated [user](#tag/Users).
      - `user-email` string, required — The user's email address.
      - `user-url` string, required — Link to the user.
      - `user-username` string, required — The username.
      - `api-keys-url` union, required — Link to the user's [api keys](#tag/API-keys).
        - string
        - string
      - `user-memberships-url` union, required — Link to the user's [memberships](#tag/Memberships).
        - string
        - string
      - `given-name` string
      - `surname` string
    - `created-at` string, date-time, required — ISO 8601 formatted date-time.
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Requires an API key to continue

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/e56cd4bb9677/schema)