Skip to main content
GET
/
users
/
{id}
Get a user
curl --request GET \
  --url https://api.smokeball.com/users/{id} \
  --header 'Authorization: <api-key>' \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "href": "<string>",
  "relation": "<string>",
  "method": "GET",
  "self": {
    "id": "<string>",
    "href": "<string>",
    "relation": "<string>",
    "method": "GET"
  },
  "userId": "23d2a4bc-8529-462e-8560-dfbf4fa24e49",
  "email": "user@domain.com",
  "isInternal": true,
  "bypassMfa": true
}

Authorizations

​
x-api-key
string
header
required
​
Authorization
string
header
required

Path Parameters

​
id
string<uuid>
required

Response

When request is successful. Returns a 'User' object.

​
id
string | null
​
href
string | null
​
relation
string | null
​
method
string | null
default:GET
​
self
object
​
userId
string | null

Unique identifier of the user.

Example:

"23d2a4bc-8529-462e-8560-dfbf4fa24e49"

​
email
string | null

Email address of the user.

Example:

"user@domain.com"

​
isInternal
boolean

Returns true if the user is flagged as an internal user.

Example:

true

​
bypassMfa
boolean

Returns true if multi-factor authentication is bypassed for the user.

Example:

true