Using the API

On this page, you can find all the necessary information on how to call our REST APIs.

Base URL

Identifiers

The following ID formats are used in the Challengermode API:

ID

Regular IDs are formatted as 32-digit string guids separated by hyphens: 00000000-0000-0000-0000-000000000000.Example of an ID:
"8e1ae7b7-683a-44c7-290e-08d89c6e5cd2"

Slug

Slugs are formatted as short, human-readable, string identifiers without spaces that are commonly used in URLs: https://www.challengermode.com/s/{slug}Example of slugs used in URLs:
"https://www.challengermode.com/s/fnatic" // slug identifying the FNATIC Space
"https://www.challengermode.com/dota2" // slug identifying the game title Dota 2

Date formats

Timestamps and dates are formatted and represented in accordance with ISO-8601.

Timestamps

All timestamps are provided in UTC and the string ends with Z.Example of a timestamp:
"2021-10-26T07:48:14.2830852Z"

Durations

Durations are represented using the following format: [-][d.]hh:mm:ss[.fffffff].Example of a duration:
"4:00:00" // 4 hours

Error responses

Our general API error response body contains both a numeric error code and a human-readable description. In addition to the response payload, the API documentation can specify an individual HTTP status code it will respond with depending on the error.

Authentication

All APIs require authentication. See the Auth API for more information.

Rate limiting

When using the API, please consider the following rate limiting response headers:On 429 Too Many Requests:
Retry-After: 58 //seconds
On successful calls:
X-Rate-Limit-Limit: the rate limit period (eg. 1m, 12h, 1d)
    X-Rate-Limit-Remaining: number of request remaining
    X-Rate-Limit-Reset: UTC date time (ISO-8601) when the limit resets