---
title: "List members"
method: GET
path: "/members"
tags: ["Members"]
---

# List members

`GET /members`

## Request

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

The members of one workspace, oldest first. Members who joined through the
HappyScribe app are listed too and get a `mem_` id the first time they are read.

## Query parameters

- `workspace_id` string, required
- `email` string, email
- `limit` integer
- `cursor` string

## Response `200`

One page of members.

- MemberList
  - `object` string: Always `list`.
  - `data` Member[]: The members on this page.
    - `id` string: Stable typed member ID beginning with `mem_`. Treat it as an opaque string.
    - `object` string: Always `member`.
    - `workspace_id` string: Workspace ID, beginning with `wks_`. Treat it as an opaque string.
    - `email` string, email: The member's email, unique within the workspace.
    - `name` string, nullable: `null` for a person who also has workspaces of their own: their name is theirs.
    - `metadata` Metadata: Your own key-value pairs, for your ids and context. HappyScribe stores them, returns them on the object and in every webhook that carries it, and never acts on them. Up to 50 keys of up to 40 characters (no square brackets), values up to 500 characters. See [metadata](/meetingkit/setup#a-workspace-per-customer).
    - `created_at` string, date-time: When the member was created, in ISO 8601.
  - `has_more` boolean: Whether more results follow this page.
  - `_links` object: Empty on the last page.
    - `next` object: The next page. Absent on the last page.
      - `url` string, uri: The next page, with the same filters. Follow it rather than building a cursor.

## Other responses

- `400`: Missing `workspace_id`, or a `limit` or `cursor` that cannot be read.
- `401`: Missing or invalid API key, or the key is not an owner or admin of the workspace.
- `404`: The workspace is not one the key belongs to.

---

[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)