Fork me on GitHub


Get a user from its id


[GET] https://{env}{userId}

You’ll need the users_read scope.

Secured by OAuth 2 access token.



The env variable as the host of the route can be changed for testing purpose.

Value Comment
cloud production environment (real client data, Authorization needed)
sandbox sandbox environment (fake data, no Authorization needed)


Header name Header value Mandatory
Authorization Bearer with the OAuth2 access token YES

Url Parameters

Parameter name Parameter value Mandatory
userId The id of the user you are looking for YES

Success Response

    "id": 42,
    "lastName": "Doe",
    "firstName": "John",
    "nickName": "Johny",
    "gender": "MALE",
    "birthDate": "2016-01-11T00:00:00+00:00",
    "licenceDeliveryDate": "2014-08-13T00:00:00+00:00",
    "role": "dev",
    "isLocationEnabled": true,
    "creationDate": "2014-08-13T15:20:58+00:00",
    "lastUpdateDate": "2016-02-12T09:07:47+00:00",
    "email": ""
Property Type Comment
id integer
lastName string
firstName string
nickName string Might be null
gender enum (as string) MALE, FEMALE
birthDate date Might be null
licenceDeliveryDate date Might be null
role enum (as string) user, dev, others
isLocationEnabled boolean true if the user has authorized us to retrieve the Xee’s locations, false otherwise
creationDate date
lastUpdateDate date
email string Email address of the user


See how errors are formed in v3 Readme

Be aware of authentication errors

Reason Status Code Type Message Tip
Scope users_read is missing 403 AUTHORIZATION_ERROR Token does not have the required scope Add the users_read scope to your app scopes and reconnect the user
The token does not have access to this user 403 AUTHORIZATION_ERROR Token can’t access this user Make sure the trip belongs to the user you asked for
User does not exist 404 PARAMETERS_ERROR User not found Please check that the user exists, looks like it does not