Get org members
GET /api/organizations/{org_id}/members
Get all members of an organization with pagination and optional email filter. This endpoint retrieves a paginated list of organization members. Access requires the VIEW_ORG_SETTINGS permission, which is granted to all organization members (member, admin, and owner roles). Args: org_id: Organization ID (UUID) page_id: Optional page offset for pagination limit: Maximum number of members to return (1-100, default 10) email: Optional email filter (case-insensitive partial match) user_id: Authenticated user ID (injected by require_permission dependency) Returns: OrgMemberPage: Paginated list of organization members with current_page and per_page metadata. Use the /count endpoint to get the total count separately. Raises: HTTPException: 401 if user is not authenticated HTTPException: 403 if user lacks VIEW_ORG_SETTINGS permission HTTPException: 400 if org_id or page_id format is invalid HTTPException: 500 if retrieval fails
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org_id | path | `string | null` | yes |
page_id | query | `string | null` | no |
limit | query | integer | no | — |
email | query | `string | null` | no |
X-Org-Id | header | `string | null` | no |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
items | OrgMemberResponse[] | yes | — |
current_page | integer | no | — |
per_page | integer | no | — |
Operation ID: get_org_members_api_organizations__org_id__members_get