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.
Response 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-30T15:21:52.0464478+00:00",
"last_login_at": "2026-03-31T13:21:52.0464501+00:00",
"created_at": "2025-09-30T15:21:52.0464506+00:00",
"updated_at": "2026-03-30T15:21:52.0464507+00:00"
},
{
"id": "990e8400-e29b-41d4-a716-446655440004",
"email": "developer@acme.com",
"name": "Jane Developer",
"role": "developer",
"status": "invited",
"invited_at": "2026-03-29T15:21:52.0464512+00:00",
"last_login_at": null,
"created_at": "2026-03-29T15:21:52.0464513+00:00",
"updated_at": "2026-03-29T15:21:52.0464514+00:00"
}
]
},
"error": null,
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-31T15:21:52.0464639+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/docs/reference/api/authentication"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-31T15:21:52.0464682+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "RESOURCE_005",
"message": "Organization not found",
"details": null,
"doc_url": "https://docs.sent.dm/docs/reference/api/error-catalog"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-31T15:21:52.0464686+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/docs/reference/api/error-catalog"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-31T15:21:52.0464694+00:00",
"version": "v3"
}
}