Skip to main content
GET
List Tournaments

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

id
string

Tournament ID(s) to filter by. Accepts comma-separated values (e.g. 1,2,3) or repeated parameters (e.g. id[]=1&id[]=2). IDs that don't exist are left out.

name
string | null

Name of the tournament to search for.

location
string | null

Name of the city/location to held the tournament.

country
string | null

2 letters country-code of the tournament location.

Required string length: 2
level
string

Tournament level(s) to filter by. Accepts one or multiple comma-separated values (e.g. major,p1,p2 for all Premier Padel tournaments) or repeated parameters (e.g. level[]=major&level[]=p1). Valid values are the level codes in the coverage tables.

court_type
enum<string> | null

Court type to filter by. Either indoor, outdoor or covered.

Available options:
indoor,
outdoor,
covered
format
enum<string> | null

How the tournament is contested: pairs for regular draws or teams for team competitions such as the FIP World Cup.

Available options:
pairs,
teams
after_date
string<date> | null

Return tournaments still running on or after this date, in YYYY-MM-DD format.

before_date
string<date> | null

Return tournaments already started on or before this date, in YYYY-MM-DD format.

updated_after
string<date-time> | null

Filter tournaments updated after this datetime in ISO 8601 format.

updated_before
string<date-time> | null

Filter tournaments updated before this datetime in ISO 8601 format.

sort_by
enum<string> | null

Name of the parameter to sort the tournaments by.

Available options:
name,
location,
country,
level,
start_date,
end_date,
updated_at
order_by
enum<string> | null

Order of the sorting, either asc or desc.

Available options:
asc,
desc
page
integer | null
default:1

Page number to return, starting at 1.

Required range: x >= 1
per_page
integer | null
default:15

Number of results per page, from 1 to 50. Larger values return 50.

Required range: x >= 1

Response

Paginated set of TournamentResource

data
TournamentResource · object[]
required
meta
object
required