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

# List Memberships

`GET /v1/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](https://api.huntress.io/docs#pagination) within our docs for more information.

## Query parameters

- `limit` integer
- `page_token` string
- `sort_field` 'id' | 'user_id' | 'created_at' | 'updated_at'
- `sort_direction` 'asc' | 'desc'
- `organization_id` integer
- `user_id` integer
- `permissions` 'Admin' | 'Security Engineer' | 'User' | 'Read-only' | 'Finance' | 'Marketing' | 'Provisioner'

## Response `200`

List Memberships

- object
  - `memberships` Membership[], required
    - `id` integer — A unique identifier for this membership. Note that this is _not_ the id of the user, account, etc. Instead, it identifies this specific relationship, which can be used to modify or delete the membership.
    - `permissions` 'Admin' | 'Security Engineer' | 'User' | 'Read-only' | 'Finance' | 'Marketing' | 'Admin-Read-only' | 'Provisioner' — The specific level of permissions that have been granted to this user in the context of this membership.
    - `account` unknown
    - `organization` unknown
    - `user` unknown
    - `created_at` string — The time and date that this membership was created.
    - `updated_at` string — The time and date that this membership was last updated.
  - `pagination` Pagination, required — Pagination model
    - `next_page_url` string
    - `next_page_token` string

## Other responses

- `403` — There was an issue with your API credential or permissions.

---

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