GET user/…

Retrieves the details of a user account.

Users are always permitted to retrieve the details of their own user account. Retrieving the details of another user account is only permitted if the calling user is an administrator (staff user) of the same organization that manages the requested user account.

Resource URL





Field Description
user_id or user_email or third_party/third_party_id
The user reference of the user to retrieve details for. If omitted, the details for the own user account are returned. The magic value self may be used to refer to the authenticated user.

Example values: 7OuHq-RcQO_snGWR58TnBw,

💡 Good to know

Instead of the user ID, an email address may also be used to identify the requested user. Be sure to URL encode the @-sign!


A 2.1.1 User object with the details of the requested user account.

Example request



  "id": "7OuHq-RcQO_snGWR58TnBw",
  "name": "Phineas Flynn",
  "memberSince": "2010-03-12T15:47:31Z",
  "emailAddress": "",
  "biography": "",
  "avatar": {
    "type": "image/png",
    "url": ""
  "locale": "en",
  "timeZone": "America/Los_Angeles",
  "organization": {
    "id": "nPjYUn0upc8dIm7yzTIBgQ",
    "name": "Acme Corp"

Error responses

The following error situations are possible:

ID Description
nonexistent_user Requested user account does not exist.
no_access Caller does not have access to the requested user.


Last updated on