API Documentation

Training Dashboard

The following requests relate to getting information about users' training performance from different points of view via the Schoox Academy API. Note: All requests must be Authenticated. Access Level for all requests: Administrators, Training Managers, Region and Location Managers. Depending on the role the requests return data either for all users (Access level: Administrators and Training Managers or for users that belong to a certain region or location (Access Level: Region Managers, Local Managers. You can simulate a user's view by his/her Schoox ID.

Get a List of Users

Returns a list of current users in your organization with a summary of their training performance (e.g. total training hours, courses and exams). By default only the first 100 people are returned. The list can be filtered on letter, role, region and location and paged using the optional paging parameters.

GET /dashboard/users

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
aboveId Above Unit's ID No Integer 1
unitId Unit's ID No Integer 4
jobId Job's ID No Integer 7
search Search text No String John Doe
start List's starting position No Integer 0
limit Number of users to return per request, up to maximum of 1,000. Default to 100 No Integer 100
sort Sorting criteria No String lastname
order Descending or ascending order No String DESC
Example Request

https://api.schoox.com/v1/dashboard/users?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":473159548,"firstname":"Frank","lastname":"Doe","preferred_name":null,"email":"","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/473159548\/","custom_fields":[],"units":[],"above_units":[],"total_course_hours":"0:00:00","total_courses":0,"total_exams":0,"external_ids":[]},{"id":1326498885,"firstname":"John","lastname":"Doe","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/1326498885\/","custom_fields":[],"units":[],"above_units":[],"total_course_hours":"0:00:00","total_courses":0,"total_exams":0,"external_ids":["ABCDEF"]},{"id":2087879259,"firstname":"John","lastname":"Doe","preferred_name":"ren","email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/2087879259\/","custom_fields":[],"units":[],"above_units":[],"total_course_hours":"0:00:00","total_courses":0,"total_exams":0,"external_ids":["ABCDEFg"]},{"id":2099521483,"firstname":"John","lastname":"Doe","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/2099521483\/","custom_fields":[],"units":[{"id":1006485,"name":"NY - Manhattan","jobs":[{"id":1009130,"name":"Cashier"}]}],"above_units":[{"id":1286994,"name":"New York"}],"total_course_hours":"0:00:11","total_courses":1,"total_exams":1,"external_ids":[]},{"id":138537,"firstname":"Ilias","lastname":"Moustakas","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/138537\/","custom_fields":[],"units":[],"above_units":[],"total_course_hours":"0:00:00","total_courses":0,"total_exams":0,"external_ids":[]},{"id":1660967137,"firstname":"Second","lastname":"Tier","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/1660967137\/","custom_fields":[],"units":[],"above_units":[],"total_course_hours":"0:00:00","total_courses":0,"total_exams":0,"external_ids":[]}]

Get List of a User's Courses

Returns a list of all courses a user is enrolled in with a summary of his or her total training and training information by course (e.g. enrollment/assignment date, due date, total time spent on the course and progress). By default only the first 100 people are returned.

GET /dashboard/users/:userid/courses

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
dropped_out Sets whether the courses are dropped out by the user No String true
Example Request

https://api.schoox.com/v1/dashboard/users/2099521483/courses?apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":3703886,"title":"Course 1","image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/course\/images\/Course_default_image.png","url":"https:\/\/www.schoox.com\/3703886\/course-1","progress":50,"total_time":"0:00:11","due_date":null,"is_due":false,"last_progress":"January 26, 2022","completions_count":0,"completed_by_admin":false,"assignee_first_name":"Dev","assignee_last_name":"Team","enroll_date":"2021-12-01T08:26:38+00:00","certificates":[],"enrolled":true,"archived":false,"completed_as_equivalent":false}]

Get List of a User's Curriculums

Returns a list of all curriculums a user is enrolled in with a summary of his or her total training and training information by curriculum (e.g. enrollment/assignment date, due date, total time spent on the curriculum and progress). By default only the first 100 people are returned.

GET /dashboard/users/:userid/curriculums

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
Example Request

https://api.schoox.com/v1/dashboard/users/2099521483/curriculums?apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":93769,"title":"Curriculum 1","image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/curriculum\/images\/curriculum_default_image.png","url":"https:\/\/www.schoox.com\/academies\/tp\/index.php?tpId=93769","progress":0,"total_time":"0:00:11","enroll_date":"2021-12-01T00:00:00+00:00","archived":false}]

Get List of a User's Exams

Returns a list of all exams a user has taken so far with information about his or her performance on every exam (e.g. number of attempts, date of last attempt, score, points, passing score). By default only the first 100 people are returned.

GET /dashboard/users/:userid/exams

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
Example Request

https://api.schoox.com/v1/dashboard/users/2099521483/exams?apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":2744992,"name":"Exam 1","description":null,"image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/exams\/images\/Exam_default_image.png","instructions":null,"attempts":1,"last_attempt":{"date_start":"2022-01-26T15:11:11+00:00","date_end":"2022-01-26T15:11:35+00:00"},"score":100,"points":{"got":100,"all":100},"passed":true}]

Get a List of Courses

Returns a list of all courses with title, short description and image.

GET /dashboard/courses

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
Example Request

https://api.schoox.com/v1/dashboard/courses?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":3703886,"title":"Course 1","image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/course\/images\/Course_default_image.png","students":1,"completion_rate":0,"publish_date":"2021-12-01T09:08:53+00:00"}]

Get a List of Enrolled Users in a Course

Returns a list of enrolled users in a course with a summary of information for every user (e.g. enrollment date, user’s region and location, total time spent on course and total progress).

GET /dashboard/courses/:courseid

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
aboveId Above Unit's ID No Integer 1
unitId Unit's ID No Integer 4
jobId Job's ID No Integer 7
search Search text No String John Doe
start List's starting position No Integer 0
limit Number of users to return per request, up to maximum of 1,000. Default to 100 No Integer 100
sort Sorting criteria No String lastname
order Descending or ascending order No String DESC
Example Request

https://api.schoox.com/v1/dashboard/courses/3703886?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":2099521483,"firstname":"John","lastname":"Doe","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/user\/2099521483\/","custom_fields":[],"units":[{"id":1006485,"name":"NY - Manhattan","jobs":[{"id":1009130,"name":"Cashier"}]}],"above_units":[{"id":1286994,"name":"New York"}],"enrolment_date":"2021-12-01T08:26:38+00:00","progress":50,"time":"0:00:11","certificates":[],"external_ids":[]}]

Get detailed Course Progress for a User

Courses can consist of one or more lectures and exams. This request returns detailed information about a user's progress on a course for every single lecture and exam of it (e.g. lecture name, progress, time spent, number of attempts, name of exam, score, date of last attempt).

GET /dashboard/courses/:courseid/users/:userid

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
Example Request

https://api.schoox.com/v1/dashboard/courses/3703886/users/2099521483?&role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
{"lectures":[{"id":1997763,"title":"API","progress":0,"time":"0:00:00"}],"exams":[{"id":2744992,"title":"Exam 1","last_attempt":"1970-01-01T00:00:00+00:00","passed":true,"score":100,"points":{"got":100,"all":100}}]}

Get a List of Curriculums

Returns a list of all curriculums with title, short description, image and number of courses.

GET /dashboard/curriculums

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
Example Request

https://api.schoox.com/v1/dashboard/curriculums?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":93769,"title":"Curriculum 1","image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/curriculum\/images\/curriculum_default_image.png","students":1,"completion_rate":0,"publish_date":"2021-12-01T08:26:04+00:00"}]

Get a List of Enrolled Users in a Curriculum

Returns a list of enrolled users in a curriculum with a summary of information for every user (e.g. enrollment date, total time spent on the curriculum and total progress).

GET /dashboard/curriculums/:curriculumid

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
aboveId Above Unit's ID No Integer 1
unitId Unit's ID No Integer 4
jobId Job's ID No Integer 7
search Search text No String John Doe
start List's starting position No Integer 0
limit 'Number of users to return per request, up to maximum of 1,000. Default to 100 No Integer 100
sort Sorting criteria No String firstname
order Descending or ascending order No String DESC
Example Request

https://api.schoox.com/v1/dashboard/curriculums/93769?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":2099521483,"firstname":"John","lastname":"Doe","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/academies\/profile.php?acadId=226581108&user=2099521483","custom_fields":[],"units":[{"id":1006485,"name":"NY - Manhattan","jobs":[{"id":1009130,"name":"Cashier"}]}],"above_units":[{"id":1286994,"name":"New York"}],"enrolment_date":"2021-12-01T08:26:38+00:00","progress":0,"time":"0:00:11","external_ids":[]}]

Get detailed Curriculum Progress for a User

Curriculums can consist of one or more courses. This request returns detailed information about a user’s progress on a curriculum for every single course of it (e.g. course name, image, time spent and total progress).

GET /dashboard/curriculums/:curriculumid/users/:userid

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
external_id Sets whether the id given is the external_id of the User.
By default, the value is "false"
No String true
Example Request

https://api.schoox.com/v1/dashboard/curriculums/93769/users/2099521483?&role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":3703886,"title":"Course 1","time":"0:00:11","progress":50}]

Get a List of Exams

Returns a list of all exams with title, image and publishing date.

GET /dashboard/exams

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
Example Request

https://api.schoox.com/v1/dashboard/exams?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":2744992,"name":"Exam 1","image":"https:\/\/www.schoox.com\/theme\/schoox\/assets\/exams\/images\/Exam_default_image.png","students":1,"success_rate":100,"average_score":100}]

Get a List of Enrolled Users in an Exam

This returns a list of all users for an exam with detailed information about every user's performance (e.g. user’s name, number of attempts, date of last attempt, starting date, ending date, score, points and status: passed / failed).

GET /dashboard/exams/:examid

Parameters
Name Description Required Type Sample Value
acadId Your academy ID Yes Integer 226581108
apikey Your academy's API key Yes String 9d3419535b0c8d76f7f6f72800f62f92
role Users' role Yes String employee
aboveId Above Unit's ID No Integer 1
unitId Unit's ID No Integer 4
jobId Job's ID No Integer 7
search Search text No String John Doe
start List's starting position No Integer 0
limit 'Number of users to return per request, up to maximum of 1,000. Default to 100 No Integer 100
sort Sorting criteria No String firstname
order Descending or ascending order No String DESC
Example Request

https://api.schoox.com/v1/dashboard/exams/2744992?role=employee&apikey=9d3419535b0c8d76f7f6f72800f62f92&acadId=226581108

Response Object
Show All
[{"id":2099521483,"firstname":"John","lastname":"Doe","preferred_name":null,"email":"[email protected]","image":"https:\/\/www.schoox.com\/user\/images\/no-user-image_small.gif","url":"https:\/\/www.schoox.com\/academies\/profile.php?acadId=226581108&user=2099521483","custom_fields":[],"units":[{"id":1006485,"name":"NY - Manhattan","jobs":[{"id":1009130,"name":"Cashier"}]}],"above_units":[{"id":1286994,"name":"New York"}],"attempts":1,"last_attempt":"2022-01-26T15:11:11+00:00","passed":true,"score":100,"points":{"got":"100","all":"100"},"external_ids":[]}]