List users
Retrieves all users who have access to the organization or profile identified by the API key, including their roles and status. Shows invited users (pending acceptance) and active users. Requires developer role or higher.
Header Parameters
x-profile-id?string
Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.sent.dm/v3/users"{
"success": true,
"data": {
"users": [
{
"id": "880e8400-e29b-41d4-a716-446655440003",
"email": "admin@acme.com",
"name": "John Admin",
"role": "admin",
"status": "active",
"invited_at": "2025-09-11T21:50:49.7725221+00:00",
"last_login_at": "2026-03-11T19:50:49.7725233+00:00",
"created_at": "2025-09-11T21:50:49.7725237+00:00",
"updated_at": "2026-03-10T21:50:49.7725239+00:00"
},
{
"id": "990e8400-e29b-41d4-a716-446655440004",
"email": "developer@acme.com",
"name": "Jane Developer",
"role": "developer",
"status": "invited",
"invited_at": "2026-03-09T21:50:49.7725246+00:00",
"last_login_at": null,
"created_at": "2026-03-09T21:50:49.7725248+00:00",
"updated_at": "2026-03-09T21:50:49.7725249+00:00"
}
]
},
"error": null,
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.7725779+00:00",
"version": "v3"
}
}Empty
{
"success": false,
"data": null,
"error": {
"code": "AUTH_004",
"message": "You do not have access to this organization or profile",
"details": null,
"doc_url": "https://docs.sent.dm/errors/AUTH_004"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.7725816+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "RESOURCE_005",
"message": "Organization not found",
"details": null,
"doc_url": "https://docs.sent.dm/errors/RESOURCE_005"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.7725823+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "INTERNAL_001",
"message": "An unexpected error occurred. Please contact support with request ID: req_7X9zKp2jDw",
"details": null,
"doc_url": "https://docs.sent.dm/errors/INTERNAL_001"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.772583+00:00",
"version": "v3"
}
}