Get user

​

Retrieves a single user by ID. The user must be a member of the caller's organization. Soft-deleted users are not returned.

The last_login_at and last_active_at fields on the returned user are global — they track the user's most recent activity across all orgs. For activity scoped to the caller's org, use GET /orgs/{id}/memberships.

Permissions
Key type Accepted Permission required Notes
Org API key yes member:read Looks up the user within the key's org scope
Personal API key yes member:read Caller must have an active membership in the org identified by X-Org-ID; the target user must be a member of that org
Error Codes
Code HTTP Description
authorize.unauthenticated 401 No valid auth credentials
authorize.forbidden 403 Missing member:read permission or wrong org
user.invalid_user_id 400 User ID is malformed or has wrong prefix
user.not_found 404 No user with this ID in the organization
user.unauthorized 401 Authentication required
user.org_required 400 An active organization is required for this request
user.get_failed 500 Failed to retrieve user
Path Parameters
  • id
    Type: string
    required

    User ID (e.g. user_01h455vb4pex5vsknk084sn02q)

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/users/{id}
curl 'https://api.nametrust.com/users/{id}'

{
  "object": "user",
  "last_login_at": "2025-06-15T09:30:00Z",
  "last_active_at": "2025-06-15T09:30:00Z",
  "id": "user_01h455vb4pex5vsknk084sn02q",
  "email": "jane@acme.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "avatar_url": "https://example.com/avatar.jpg",
  "mfa_enabled": true,
  "created_at": "2025-06-01T12:00:00Z",
  "updated_at": "2025-06-15T09:30:00Z"
}

User profile