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.

GET
/v3/users

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.

Formatuuid

Response Body

Users retrieved successfully

application/json
  1. response

Standard API response envelope for all v3 endpoints

success?boolean

Indicates whether the request was successful

data?|null

The response data (null if error)

error?|null

Error details (null if successful)

meta?

Metadata about the request and response

Example Request
curl -X GET 'https://api.sent.dm/v3/users'
Example Response
{  "success": true,  "data": {    "users": [      {        "id": "880e8400-e29b-41d4-a716-446655440003",        "customer_id": "00000000-0000-0000-0000-000000000000",        "email": "admin@acme.com",        "name": "John Admin",        "role": "admin",        "status": "active",        "invited_at": "2026-05-12T15:32:26.4874658+00:00",        "last_login_at": "2026-11-12T13:32:26.4874666+00:00",        "created_at": "2026-05-12T15:32:26.4874668+00:00",        "updated_at": "2026-11-11T15:32:26.4874669+00:00"      },      {        "id": "990e8400-e29b-41d4-a716-446655440004",        "customer_id": "00000000-0000-0000-0000-000000000000",        "email": "developer@acme.com",        "name": "Jane Developer",        "role": "developer",        "status": "invited",        "invited_at": "2026-11-10T15:32:26.4874673+00:00",        "last_login_at": null,        "created_at": "2026-11-10T15:32:26.4874674+00:00",        "updated_at": "2026-11-10T15:32:26.4874674+00:00"      }    ],    "pagination": null  },  "error": null,  "meta": {    "request_id": "req_7X9zKp2jDw",    "timestamp": "2026-11-12T15:32:26.4874819+00:00",    "version": "v3"  }}