Search and page the tenant's users (admin)
Search and page the tenant's users. Requires users:read and a machine or staff principal — a user token is refused forbidden (403) because listing everyone is not a self-read.
/v1/usersSearch and page the tenant's users. Requires users:read and a machine or staff principal — a user token is refused forbidden (403) because listing everyone is not a self-read. query matches the user's identifying fields. Cursor paged: pass the last id you saw as cursor; limit is clamped to 1-100 and defaults to 50.
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Query Parameters
length <= 128Last seen id from the previous page. The listing resumes after that row, so an id that belongs to no row in the listing is refused invalid_request (400) rather than answered with an empty page.
uuid1 <= value <= 10050Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/users"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "external_id": "string", "kind": "consumer", "display_name": "string", "phone": "string", "email": "user@example.com", "handle": "string", "status": "string", "created_at": "2019-08-24T14:15:22Z" }]