---
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, sorting, and pagination. | () -> (OrgMemberListRes)

## Query parameters

- `filter_role` OrgRoleEnum[], nullable — Filter by organization role(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

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)