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

# List members

`GET /org/members`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/members`
- Auth: API key in header `X-API-Key`

Returns one page of your organization's members — the people with access — with their role.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `sort` 'name_asc' | 'name_desc' | 'email_asc' | 'email_desc' | 'created_asc' | 'created_desc'

## Response `200`

One page of members.

- OrgMemberListResponse: A paginated list of organization members.
  - `members` OrgMemberResponse[], required
    - `org_user_id` string, uuid, required
    - `org_id` string, uuid, required
    - `user_id` string, uuid, required
    - `email` string, required
    - `given_name` string, required
    - `family_name` string, required
    - `role_id` string, uuid, required
    - `role_display_name` string, required: The member's role name.
    - `groups` GroupSummary[], required: The knowledge-base permission groups the member belongs to.
      - `group_id` string, uuid, required
      - `name` string, required
  - `total` integer, required: Total members matching the filter, across all pages.
  - `limit` integer, required: The page size that was applied.
  - `offset` integer, required: The row offset that was applied.

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `404`: The requested resource does not exist or is not visible to this key.

---

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