Tournament API V2

Endpoint

GET /public/api/v2/tournaments/details

Authentication

Requires an API key to be passed in the Authorization header:

http

Authorization: your-api-key

Query Parameters

Filtering

Parameter	Type	Description	Example
`status`	string	Filter by campaign status	status=AC
`start_date`	ISO datetime	Filter by start date	start_date=2020-01-01T00:00:00
`end_date`	ISO datetime	Filter by end date	end_date=2022-12-31T23:59:59
`game_ids`	string	Filter by game IDs (comma-separated)	game_ids=game_id1,game_id2
`tournament_type`	string	Filter by tournament type	tournament_type=PT

Status Codes

AC - Active
SC - Scheduled
FI - Finished

Tournament Types

PT - Point Tournament
HC - Highest Coin
TM - Tournament Mission
IM - Individual Mission
RA - Races
SR - Speed Races

Sorting

Parameter	Type	Description	Example
`sort`	string	Sort by fields (comma-separated). Prefix with - for descending order	sort=start_date

Available sort fields:

start_date - Sort by tournament start date
end_date - Sort by tournament end date
status - Sort by campaign status

Pagination

Parameter	Type	Description	Default
`page`	integer	Page number	1
`page_size`	integer	Items per page (max 25)	8

Language

Parameter	Type	Description	Default
`language`	string	Response language code	en

Request Headers

Header	Description	Accepted values
`Accept-Encoding`	Accepted encoding of the response. Using gzip in particular will cause the server to compress the payload making it smaller.	*, identity, gzip

Response Format

A successful response returns a paginated JSON object with tournament details.

Example Response

{
  "count": 100,
  "next": "http://api.example.com/public/api/v2/tournaments/details?page=2",
  "previous": null,
  "results": [
    {
      "campaign": {
        "id": 123,
        "custom_id": "tournament-123",
        "name": "Tournament Name",
        "image": "https://example.com/image.jpg",
        "start": "2024-03-20T00:00:00Z",
        "end": "2024-03-27T23:59:59Z",
        "status": "AC",
        "status_for_display": "Active",
        "terms": {
          "content": "Tournament terms...",
          "campaign_type": "TOURNAMENT",
          "campaign_type_for_display": "Tournament",
          "tournament_type": "POINT_TOURNAMENT",
          "tournament_type_for_display": "Point Tournament"
        },
        "game_ids": ["game1", "game2"],
        "campaign_info": "Tournament description..."
      },
      "tournament_prizes": [
        {
          "title": "€100 cash",
          "place_from": 1,
          "place_to": 1
        },
        {
          "title": "€50 cash",
          "place_from": 2,
          "place_to": 2
        }
      ],
      "total_prizes": {
        "cash": "€1000",
        "free_spins": "1000",
        "bonus": null,
        "deposit_bonus": null,
        "catalog_item": []
      },
      "leaderboard": [
        {
          "player_id": "player-hash",
          "player_username": "player1",
          "score": 1000,
          "prizes": ["€100 cash"]
        }
      ]
    }
  ]
}

Examples

Get active tournaments sorted by start date (newest first)

GET /public/api/v2/tournaments/details?status=AC&sort=-start_date

Get tournaments for specific games

GET /public/api/v2/tournaments/details?game_ids=game1,game2

Get tournaments with pagination

GET /public/api/v2/tournaments/details?page=2&page_size=10

Get tournaments in a specific language

GET /public/api/v2/tournaments/details?language=es

Multi-column sorting

GET /public/api/v2/tournaments/details?sort=start_date,-status

This will sort by start_date ascending, then by status descending.

Was this helpful?