HUhuntress
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.

get/v1/memberships

Request

  • Base URL
    https://api.huntress.io
  • URL
    https://api.huntress.io/v1/memberships
  • Auth
    basic (a scheme the document does not define)

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"
    }
  ]
}

Changes

No recorded changes to this operation across all 8 revisions of this API.