---
title: "List members"
method: GET
path: "/orgs/members/list/v1"
tags: ["/orgs"]
---

# List members

`GET /orgs/members/list/v1`

Lists all members of the caller's organization with their roles and details. Supports search by name, filtering by role and user IDs, sorting, and pagination. | () -> (OrgMemberListRes)

## Query parameters

- `filter_role` OrgRoleEnum[], nullable — Filter by organization role(s)
- `filter_user_ids` string[], nullable — Filter by user ID(s)
- `sort_by` 'first_name' | 'last_name'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer
- `search` string, nullable — Search by first or last name

## Response `200`

Successful Response

- OrgMemberListRes
  - `items` OrgMemberDetails[], required
    - `role` 'owner' | 'admin' | 'operator' | 'member', required — Organization roles used in authenticated caller claims. Hierarchy (highest to lowest): owner > admin > operator > member Role availability by org type: {owner, admin, operator, member} → PROVIDER | SHIPPER Note: Hierarchical enforcement depends on utils_shipping_authz helper functions. WorkOS role slugs match these enum values.
    - `user_id` string, required — Must be a string starting with `user_`
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-11** `7cf361125675` — 1 info
  - added the new optional `query` request parameter `filter_user_ids`

[Change history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/orgs/members/list/v1/get.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/1a1e5a995fc9?raw)