---
title: "List users"
method: GET
path: "/v3/users"
tags: ["Users"]
---

# List users

`GET /v3/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.

## Headers

- `x-profile-id` string, uuid

## Response `200`

Users retrieved successfully

- SentDmServicesEndpointsCustomerAPIv3ResponsesApiResponseOfUsersListResponse — Standard API response envelope for all v3 endpoints
  - `success` boolean — Indicates whether the request was successful
  - `data` SentDmServicesEndpointsCustomerAPIv3ResponsesUsersListResponse — List of users response
    - `users` SentDmServicesEndpointsCustomerAPIv3ResponsesUserResponse[] — List of users in the organization
      - `id` string, uuid — User unique identifier
      - `email` string — User email address
      - `name` string — User full name
      - `role` string — User role in the organization: admin, billing, developer
      - `status` string — User status: active, invited, suspended, rejected
      - `invited_at` string, date-time, nullable — When the user was invited
      - `last_login_at` string, date-time, nullable — When the user last logged in
      - `created_at` string, date-time — When the user was added to the organization
      - `updated_at` string, date-time, nullable — When the user record was last updated
  - `error` SentDmServicesEndpointsCustomerAPIv3ResponsesApiError — Error information
    - `code` string — Machine-readable error code (e.g., "RESOURCE_001")
    - `message` string — Human-readable error message
    - `details` object, nullable — Additional validation error details (field-level errors)
    - `doc_url` string, nullable — URL to documentation about this error
  - `meta` SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta — Request and response metadata
    - `request_id` string — Unique identifier for this request (for tracing and support)
    - `timestamp` string, date-time — Server timestamp when the response was generated
    - `version` string — API version used for this request

## Other responses

- `401` — Unauthorized - Invalid API credentials
- `403` — Forbidden - User does not have access to this organization
- `404` — Organization not found
- `500` — Internal server error

---

[API](https://skmtc.net/sentdm/apis/sent-dm-api-v3.md) · [All operations](https://skmtc.net/sentdm/apis/sent-dm-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sentdm/sent-dm-api-v3/versions/c451eca46f1b/schema)