Reach 360: Users API

What This API Endpoint Does

With the Users API you can get a list of all users in your Reach 360 account as well as the details of a single user.

• Endpoints
• User Object
• Retrieving a List of Users
• Retrieving Specific User Details

Endpoints

• GET /users - list users
• GET /users/{userId} - get details of a user by user id

User Object

• id (string) - the unique identifier of the user
• email (string) - the user's email address
• groupsUrl (string) - URL to list user's groups from the API
• role (string) - the user's role (one of learner, author, or admin)
• firstName (string) - the user's first name
• lastName (string) - the user's last name
• lastActiveAt (string) - the date and time of the user's last activity in rise
• learnerReportUrl (string) - URL to fetch the user's learner report from the API
• favoritesUrl (string) - URL to fetch the user's favorites list from the API
• url (string) - URL to fetch user's details from the API
• articulate360User (boolean) - whether or not the user is managed in Articulate 360

Retrieving a List of Users

GET /users

Request Parameters (Query String)

• limit (integer, optional) - the maximum number of results to return in a single response (see Pagination); must be between 1 and 100 (defaults to 50)
• email (string, optional) - if provided, only return users with this email address

Example Response

{ 
 "users": [ 
   { 
    "id": "example-user-id-1", 
    "email": "foo@example.com", 
    "groupsUrl": "https://api.reach360.com/users/example-user-id-1/groups", 
    "role": "learner", 
    "firstName": "Example First Name 1", 
    "lastName": "Example Last Name 1", 
    "lastActiveAt": "2021-10-28T20:39:52.659Z",
    "learnerReportUrl": "https://api.reach360.com/reports/learners/example-user-id-1", 
    "favoritesUrl": "https://api.reach360.com/users/example-user-id-1/favorites",
    "url": "https://api.reach360.com/users/example-user-id-1"
    "articulate360User": false
   }, ... 
 ], 
 "nextUrl": "https://url-for-next-page-of-results" 
}

Retrieving Specific User Details

GET /users/{userId}

Example Response

{ 
  "id": "example-user-id", 
  "email": "example@example.com", 
  "groupsUrl": "https://api.reach360.com/users/example-user-id-1/groups", 
  "role": "learner", 
  "firstName": "Example First Name", 
  "lastName": "Example Last Name", 
  "lastActiveAt": "2021-10-28T20:39:52.659Z",
  "learnerReportUrl": "https://api.reach360.com/reports/learners/example-user-id", 
  "favoritesUrl": "https://api.reach360.com/users/example-user-id/favorites",
  "url": "https://api.reach360.com/users/example-user-id" 
  "articulate360User": false
}

Endpoint-specific Error Codes

• user_not_found - cannot retrieve user because user does not exist