Skip to main content
POST
Search Head to Head Matches

Authorizations

Authorization
string
header
required

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

Body

application/json
team_1
integer[]
required

Player IDs on the first team. Pass one player or two.

Required array length: 1 - 2 elements
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.

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.

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
team_2
(integer | null)[] | null

Player IDs on the opposing team. Omit it to get every match of team_1 regardless of the rival.

Required array length: 1 - 2 elements

Response

Paginated set of MatchResource

data
MatchResource ยท object[]
required
meta
object
required