Challenge details

This service returns the details and rules of a challenge.

The most important characteristics of a challenge are the name, the theme and the conditions required to be ranked (minimum number of trips and distance).

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

Retrieve a challenge

get

Authorizations

Path parameters

challengeIdstringRequired

Unique identifier of the challenge

Header parameters

DriveKit-Admin-API-KeystringRequired

Drivekit Admin API key

Responses

200

OK

application/json

401

Unauthorized

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

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

{
  "challengeId": "text",
  "title": "text",
  "description": "text",
  "creationDate": "2025-05-09T05:30:59.032Z",
  "startDate": "2025-05-09T05:30:59.032Z",
  "endDate": "2025-05-09T05:30:59.032Z",
  "conditions": {
    "km": 1,
    "nbTrip": 1
  },
  "theme": "SAFETY",
  "type": "ALL_DRIVERS",
  "reportAvailabilityDate": "2025-05-09T05:30:59.032Z",
  "groups": [
    "text"
  ],
  "rules": "text",
  "admin": {
    "username": "text",
    "firstname": "text",
    "lastname": "text"
  },
  "status": "DRAFT",
  "registeredUsers": 1,
  "rankedUsers": 1
}

---

Response

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

Field	Type	Description
challengeId	string	Unique identifier of the challenge
title	string	Title of the challenge
description	string	Detailed description of the challenge
creationDate	string	Creation date of the challenge Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
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
conditions	ChallengeConditions	Conditions that need to be filled for a user to be ranked
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
groups	array[string]	List of groups participating in the challenge (empty if type is ALL_DRIVERS)
rules	string	Rules of the challenge (in html format)
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

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

ChallengeConditions

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

Field	Type	Description
km	int	Minimum distance required to be ranked (in km)
nbTrip	int	Minimum number of trips required to be ranked