List of challenges

This service returns a list of all the challenges belonging to your organisation.

Each challenge has a unique identifier, which can be used as a parameter in all challenge services to access other challenge specific data. Of notice, archived challenges are excluded from this list.

If you have your admin API key, you can try the API via this link.

List all challenges

get

Authorizations

API_Key

DriveKit-Admin-API-KeystringRequired

Header parameters

DriveKit-Admin-API-KeystringRequired

Drivekit Admin API key

Responses

200

OK

application/json

challengeIdstringOptional

Unique identifier of the challenge

titlestringOptional

Title of the challenge

startDatestring · date-timeOptional

Starting date of the challenge

Pattern: YYYY-MM-dd'T'HH:mm:ss.SSSZ

endDatestring · date-timeOptional

Ending date of the challenge

Pattern: YYYY-MM-dd'T'HH:mm:ss.SSSZ

themestring · enumOptional

Theme of the challenge

Possible values:

typestring · enumOptional

Type of the challenge

Possible values:

reportAvailabilityDatestring · date-timeOptional

Estimated date at which the results report of the challenge will be available

Pattern: YYYY-MM-dd'T'HH:mm:ss.SSSZ

statusstring · enumOptional

Current status of the challenge

Possible values:

registeredUsersintegerOptional

Total number of users registered to the challenge

rankedUsersintegerOptional

Total number of users ranked in the challenge

401

Unauthorized

application/json

get

/drivekit/admin/challenges

HTTPcURLJavaScriptPython

GET /v3/drivekit/admin/challenges HTTP/1.1
Host: service.drivequant.com
DriveKit-Admin-API-Key: text
Accept: */*

---

Response

The service returns an array of ChallengeResponse.

ChallengeResponse

The table below summarizes the elements included in the ChallengeResponse object.

Field	Type	Description
challengeId	string	Unique identifier of the challenge
title	string	Title of the challenge
startDate	string	Starting date of the challenge Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
endDate	string	Ending date of the challenge Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
theme	string	Theme of the challenge Possible values: SAFETY, ACCELERATION, BRAKING, PHONE_DISTRACTION, ECODRIVING, SPEEDING
type	string	Type of the challenge Possible values: ALL_DRIVERS, SINGLE_GROUP, MULTIPLE_GROUPS
reportAvailabilityDate	string	Estimated date at which the results report of the challenge will be available Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
admin	AdminInfo	Creator of the challenge
status	string	Current status of the challenge Possible values: DRAFT, PLANNED, IN_PROGRESS, FINISHED
registeredUsers	int	Total number of users registered to the challenge
rankedUsers	int	Total number of users ranked in the challenge

The challenges which were archived from the administration dashboard cannot be retrieved in this service. These challenges are also absent from the DriveKit SDK services.

AdminInfo

The table below summarizes the elements included in the AdminInfo object.

Field	Type	Description
username	string	Unique identifier of the user
firstname	string	First name of the user
lastname	string	Last name of the user