List users in the caller's tenant
Returns a paginated list of users (identities) in the caller's tenant. Supports free-text search on email and display_name.
Returns a paginated list of users (identities) in the caller's tenant. Supports free-text search on email and display_name.
Authorization
bearerAuth AuthorizationBearer <token>
JWT Bearer access token. Clock skew tolerance is ±60 seconds.
In: header
Query Parameters
page?integer
Default
1Range
1 <= valuelimit?integer
Default
20Range
1 <= value <= 100search?string
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/admin/users"{
"users": [
{
"id": "018f1a2b-0001-7000-8000-000000000001",
"email": "[email protected]",
"display_name": "Alice",
"status": "active",
"created_at": "2026-01-15T08:00:00Z"
}
],
"total": 0
}{
"error": "unauthenticated",
"message": "missing or invalid bearer token",
"request_id": "req_01abc123"
}Was this page helpful?