---
title: "List memberships"
method: GET
path: "/organization_memberships"
tags: ["Organization memberships"]
---

# List memberships

`GET /organization_memberships`

## Request

- Base URL: `https://www.happyscribe.com/api/v1`
- URL: `https://www.happyscribe.com/api/v1/organization_memberships`
- Auth: API key in header `Authorization`

Returns memberships across all workspaces the caller belongs to, paginated at
25 results per page. Owners and admins see every member; regular members see only
their own row.

## Query parameters

- `organization_id` string
- `role` 'owner' | 'admin' | 'member' | 'guest'
- `email` string
- `name` string
- `page` integer

## Response `200`

A paginated list of memberships.

- object
  - `members` Membership[]
    - `id` integer
    - `organization_id` string: Workspace ID, beginning with `wks_`. Treat it as an opaque string.
    - `organization_name` string
    - `email` string
    - `name` string
    - `role` 'owner' | 'admin' | 'member' | 'guest'
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `_links` PaginationLinks: Pagination links. `next` is omitted on the last page.
    - `next` object: The next page, with the same filters. Absent on the last page.
      - `url` string: URL of the next page.

## Other responses

- `401`: Your API key is missing (`missing_api_key`) or wrong (`invalid_api_key`), or it may not access this resource (`unauthorized`).

---

[API](https://skmtc.dev/happyscribe/apis/happyscribe-api.md) - [All operations](https://skmtc.dev/happyscribe/apis/happyscribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happyscribe/apis/happyscribe-api/revisions/1281bd968c3d?raw)