---
title: "Fetching a list of Account Memberships"
method: GET
path: "/account_memberships"
tags: ["Account Memberships"]
---

# Fetching a list of Account Memberships

`GET /account_memberships`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/account_memberships`
- Auth: none declared

You can request either GET /api/v1/account_memberships.json?only=5 or
GET /api/v1/account_memberships/5.json. In both cases, default filters will be applied.
Unless you provide the is_active:false filter, you won't receive account membership for inactive users, and will get a 404 status
on the "show" route.


This endpoint returns structured Account Membership objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `account_memberships` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `by_full_name` string
- `by_user_id` integer
- `can_log_in` boolean
- `created_after` string, date-time
- `created_before` string, date-time
- `include` string
- `only` string
- `only_active` boolean
- `only_inactive` boolean
- `optional_fields` string[]
- `order` string
- `page` integer
- `per_page` integer
- `search` string
- `updated_after` string, date-time
- `updated_before` string, date-time
- `with_skills` string
- `with_user_ids` string

## Response `200`

A list of Account Memberships have been retrieved.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `account_memberships` object
  - `users` object
  - `roles` object
  - `workweeks` object
  - `skill_memberships` object
  - `backup_approver_associations` object
  - `cost_rates` object
  - `billable_utilizations` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)