User Management
Get a list of users
get/users
Query parameters
pageinteger
The page which should be returned
per_pageinteger
The number of returned items
user_idstring uuid4
Example:c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c
A single ID or a comma-separated list of IDs. Only users with the specified IDs are included in the result.
emailstring email
Example:example@example.com
Only users with the specified email are included
sort_direction'asc' | 'desc'
The sort direction of the returned list (always sorted by created_at)
Response
Details about users
Example response
[
{
"id": "c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c",
"user_id": "c339547d-e17d-4ba7-8a1d-b3d5a4d17c1c",
"emails": [
{
"id": "5333cc5b-c7c4-48cf-8248-9c184ac72b65",
"address": "john.doe@example.com",
"is_verified": true,
"is_primary": false
}
],
"passkeys": [
{
"id": "5333cc5b-c7c4-48cf-8248-9c184ac72b65",
"name": "iCloud",
"public_key": "pQECYyagASFYIBblARCP_at3cmprjzQN1lJ...",
"attestation_type": "packed",
"aaguid": "01020304-0506-0708-0102-030405060708",
"last_used_at": "2026-02-24T21:40:36.26936Z",
"created_at": "2026-02-24T21:40:36.26936Z",
"transports": [
"internal"
],
"backup_eligible": true,
"backup_state": true,
"mfa_only": false
}
],
"security_keys": [
{
"id": "f826013e-e7e3-4366-a6d8-9359effc8cdd",
"name": "Yubikey Bio",
"public_key": "aNMEEyadASFYIBblARCP_at3cmp4gg3zQN1lJ...",
"attestation_type": "packed",
"aaguid": "90636e1f-ef82-43bf-bdcf-5255f139d12f",
"last_used_at": "2026-02-24T21:40:36.26936Z",
"created_at": "2026-02-24T21:40:36.26936Z",
"transports": [
"usb"
],
"backup_eligible": true,
"backup_state": false,
"mfa_only": true
}
],
"metadata": {
"public_metadata": {
"role": "admin"
},
"unsafe_metadata": {
"birthday": "2025-05-12"
}
}
}
]