🔵GET users

Fetches a list of users in the organisation.

URL

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

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.
email	string	An email address to filter the list of users by. This will search the both the username and email fields. The provided value can be a partial email.
orgId	string	A full or partial identifier to filter the list of users by. This will search the organisationIdentifier (Employee ID) field.
userId	string	A user ID to select a specific user to view. This must be formatted as a full and valid GUID. If a user does not exist with the given ID, the returned list will be empty.

Example

Responses

200 - OK

A list of users from the database.

Schema

Name	Type	Description
entities	array	The list of the results returned.
┃ id	string	The Id of the user. Formatted as a GUID.
┃ username	string	The username of the user. For SSO provisioned accounts this will be the Id passed by your SSO provider. For standard accounts this will be the same as the users email address.
┃ email	string	The users email address.
┃ firstName	string	The users first name.
┃ lastName	string	The users last name.
┃ birthYear	integer	The users birth year. -1 if unspecified.
┃ gender	string	The selected gender of the user.
┃ role	string	The access level of the user for the organisation.
┃ organisationIdentifier	string	The custom identifier set by the organisation.
┃ hasAccess	boolean	Specifies if the user is currently allowed to access the organisations training.
┃ usingSeat	boolean	Whether the user currently using an unlimited use seat. False if the organisation is not on an unlimited use plan.
┃ accountType	string	Specifies the method used to create the user account.
┃ deletionStatus	string	Specifies whether the user account can be deleted, or the reason it cannot be.
┗ userFilters	string[]	A list of the filter answers the user currently has applied.
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.