Sign in
latestSwagger 2.02026-08-109450223.9 KB

94acb422c07d

Users

List Memberships

Shows a list of memberships.

By default, this endpoint returns both account and organization memberships, but if an organization ID is supplied, it will return only organization memberships, instead.

The example return value shows both an organization and an account, but a given membership will only have one or the other.

Note: This endpoint will also return a pagination key on the root level.
Please refer to the pagination section within our docs for more information.

get/v1/memberships

Query parameters

limitinteger

Max number of resources returned in a paged collection. Defaults to 10, with a minimum of 1 and maximum 500.

page_tokenstring

Token used to request the next page in paginated results. Defaults to 'null'

sort_field'id' | 'user_id' | 'created_at' | 'updated_at'

Field to sort by. Defaults to 'id'.

sort_direction'asc' | 'desc'

Sort direction. Defaults to 'desc'.

organization_idinteger

Filter by organization ID to return only memberships for that organization.

user_idinteger

Filter by user ID to return only memberships for that user.

permissions'Admin' | 'Security Engineer' | 'User' | 'Read-only' | 'Finance' | 'Marketing' | 'Provisioner'

Filter by permission label.

Response

List Memberships

Example response

{
  "memberships": [
    {
      "id": 1,
      "permissions": "Read-only",
      "account": {
        "id": 1234,
        "name": "Exemplary Accounting, LLC"
      },
      "organization": {
        "id": 5678,
        "name": "Organic Zations"
      },
      "user": {
        "id": 90210,
        "email": "little_bobby@example.com",
        "name": "Robert Tables"
      },
      "created_at": "2026-01-22 01:07:08 UTC",
      "updated_at": "2026-01-22 01:07:08 UTC"
    }
  ]
}