Skip to main content
GET
List Pair Matches

Authorizations

Authorization
string
header
required

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

Path Parameters

player1
integer
required

The player1 ID

player2
integer
required

The player2 ID

Query Parameters

tournament_id
integer | null

Tournament ID to filter matches by.

after_date
string<date> | null

Date after the match was played in YYYY-MM-DD format.

before_date
string<date> | null

Date before the match was played in YYYY-MM-DD format.

round
enum<integer> | null

Round of the match (1 = Final, 2 = Semifinal, 4 = Quarterfinal, 8 = Round of 16, 16 = Round of 32, 32 = Round of 64, 0 = group stage of team tournaments)

Available options:
0,
1,
2,
4,
8,
16,
32
draw
enum<string> | null

Draw the match belongs to: main, qualy, group or placement (team tournaments only), or all for every draw. Defaults to main.

Available options:
main,
qualy,
group,
placement,
all
level
string

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

sort_by
enum<string> | null

Name of the parameter to sort the matches by.

Available options:
played_at,
round
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 MatchResource

data
MatchResource · object[]
required
meta
object
required