🔵GET results

Fetches a list of results from the organisation.

URL

GET https://training.tapintosafety.com.au/api/v2/results

Parameters

Schema

Query Parameters

Name	Type	Description
page	integer	The page of results to select. Defaults to the first page. 50 results are returned per page.
startDate	string	Show only results after the date specified. Date is converted to a DateTimeOffset and supports specifying a time zone. ISO 8601 format is recommended.
endDate	string	Show only results before the date specified. Date is converted to a DateTimeOffset and supports specifying a time zone. ISO 8601 format is recommended.
reportingFilters	string[]	Show only results that have the specified filter answers. Note that a result only needs to match one of the specified answers. A list of available answers can be found using GET filters.
userId	string	The ID of a user to fetch results for. This must be formatted as a full and valid GUID, and a user with the given ID must exist.

* required

Example

Responses

200 - OK

A list of results from the database. List may be empty if no results are found for the specified parameters.

Schema

Name	Type	Description
entities	array	The list of the results returned.
┃ id	string	The Id of the result. Formatted as a GUID.
┃ userId	string	The Id of the user the result is for. Formatted as a GUID.
┃ courseId	string	The Id of the course the result is for. Formatted as a GUID.
┃ multiCourseResultId	string	The Id of the parent result if this result is part of a multi-course module. Formatted as a GUID.
┃ isComplete	boolean	Whether the user has completed the course for this result.
┃ dateCompleted	string	The completion time of this result, or the start time if isComplete is false. Formatted in ISO 8601.
┃ score	integer	The score the user obtained for this result.
┃ maximumScore	integer	The maximum possible score for this result.
┃ passRate	integer	The pass rate in percent from 0-100, or null if the organisation has not specified a pass rate.
┃ courseType	string	The type of the course. (SINGLE_COURSE or MULTI_COURSE)
┗ resultFilters	string[]	A list of the filter answers the user had at the time of completion.
page	integer	The current page of results (Starts at 1).
entitiesReturned	integer	The number of courses in the entities array.
totalEntities	integer	The total entities across all pages for the current parameters.
links	array	A list of links relevant to the current request. No links are currently returned with this request.
┃ type	string	The type of the given link (e.g. Next Page, Previous Page).
┃ href	string	The URL to call for the given link.
┗ method	string	The HTTP method to use for the link (e.g. GET, POST).

Example

400 - Bad Request

Error Code: INVALID_MODEL

One or more parameters provided are invalid. See details for more information.