Tournament API (v2)

Endpoint

GET /public/api/v2/tournaments/details

Authentication

Requires an API key to be passed in the Authorization header:
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=2024-03-20T00:00:00Z
end_date
ISO datetime
Filter by end date
end_date=2024-03-27T23:59:59Z
game_ids
string
Filter by game IDs (comma-separated)
game_ids=game1,game2
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,-status
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

Response Format

{
    "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.