---
title: "List Memberships"
method: GET
path: "/v1/accounts/{account_id}/memberships"
tags: ["Reseller"]
---

# List Memberships

`GET /v1/accounts/{account_id}/memberships`

## Request

- Base URL: `https://api.huntress.io`
- URL: `https://api.huntress.io/v1/accounts/{account_id}/memberships`
- Auth: `basic` (a scheme the document does not define)

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.

## Path parameters

- `account_id` integer, required

## 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.dev/huntress/apis/huntress-api-reference.md) - [All operations](https://skmtc.dev/huntress/apis/huntress-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/huntress/apis/huntress-api-reference/revisions/f593a257b4cc?raw)