Skip to main content
GET
List Matches

Authorizations

Authorization
string
header
required

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

Query Parameters

id
string

Match ID(s) to filter by. Accepts comma-separated values (e.g. 1,2,3) or repeated parameters (e.g. id[]=1&id[]=2). Only returns matches of the default draw=main unless draw=all is passed; IDs that don't exist are left out.

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
category
enum<string> | null

Category of the match. Either men or women.

Available options:
men,
women
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
court
string | null

Name of the court where the match was played.

updated_after
string<date-time> | null

Filter matches updated after this datetime in ISO 8601 format.

updated_before
string<date-time> | null

Filter matches updated before this datetime in ISO 8601 format.

sort_by
enum<string> | null

Name of the parameter to sort the tournaments by.

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

data
MatchResource · object[]
required
meta
object
required