Last updated on 16th April 2026

View User via API

This method allows you to view the details of a specific user in your DeployHQ account.

Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.

URL

/users/:identifier

HTTP Method

GET

Supported Parameters

This endpoint does not accept any parameters. The user identifier (UUID) is specified in the URL.

Example cURL Request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/users/9e11def8-8c43-454e-8c99-3c5b9cf08396

Example Response

{
  "id": 12345,
  "identifier": "9e11def8-8c43-454e-8c99-3c5b9cf08396",
  "first_name": "John",
  "last_name": "Doe",
  "email_address": "john@example.com",
  "time_zone": "Etc/UTC",
  "account_administrator": true,
  "activated": true,
  "can_manage_users": true,
  "can_manage_billing": true,
  "can_create_projects": true,
  "can_manage_agents": true,
  "all_projects_allowed": true
}

Notes

  • The :identifier in the URL is a UUID that uniquely identifies the user
  • Returns all user details including permissions and role information