Skip to content

Get tournaments

GET
/v1/tournaments

Gets a list with tournaments.

Authorizations

api_key
TypeAPI Key (header: X-Api-Key)

Parameters

Query Parameters

sorting
Typestring
Defaultnull
page_size

Number of items per page

Typeinteger
Default50
page

Current page

Typeinteger
Default1
region

iso country. For F1/Moto use "world"

Typestring
Example"WORLD"
date_start

date start

Typestring
Example"2022-07-10"
date_stop

date stop

Typestring
Example"2023-12-30"
sport_type

Enum: soccer, motorsport, tennis, rugby, darts, horseracing, boxing, other, motogp, formula1, cricket, basketball, combatsport, icehockey, nba, nfl, mlb, watersport, dtm, indycar, superbike, padel

Typestring
Example"formula1"
tournament_type

Enum: cup, league, oneoff

Typestring
Example"league"
tournament_name

tournament name

Typestring
Example"Formula 1"
query

flexible search query for tournament names

Typestring
Example"Premier League"
season

Season, for example 2024 or 24/25 depending on sport type

Typestring
Example"2023"
tournament_id
Typestring
Example"8a8bd5e3d98347e68cbe50d31953fcbb_trn"

Responses

OK

application/json
JSON
{
"tournaments": [
{
"tournament_id": "8a8bd5e3d98347e68cbe50d31953fcbb_trn",
"official_name": "Formula 1",
"season": "2023",
"tournament_type": "league",
"region": "WORLD",
"sport_type": "formula1",
"date_start": "2022-07-10T00:00:00",
"date_stop": "2023-12-30T00:00:00",
"created": "2024-04-08T14:03:00",
"updated": "2024-04-08T14:03:00",
"slug": "formula-1-2023",
"number_events": 0
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Playground

Server
Authorization
Variables
Key
Value

Samples