Skip to main content
GET
List Tournament Matches

Authorizations

Authorization
string
header
required

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

Path Parameters

tournament
integer
required

The tournament ID

Query Parameters

played_at
string<date> | null

Date when 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,
all
court
string | null

Name of the court where the match was played.

tie[id]
string | null

Identifier of the tie, matching tie.id in the response. Sent as ?tie[id]=men-main-1-0, it returns the rubbers of that single tie. Team tournaments only.

tie[group]
string | null

Group of the tie (e.g. A), matching tie.group in the response. Sent as ?tie[group]=A. Team tournaments only.

Required string length: 1
tie[team_1]
string | null

Name of the team on the first side of the tie, matching tie.team_1 in the response (case-insensitive). Sent as ?tie[team_1]=Spain. Team tournaments only.

tie[team_2]
string | null

Name of the team on the second side of the tie, matching tie.team_2 in the response (case-insensitive). Sent as ?tie[team_2]=Argentina. Team tournaments only.

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 matches by.

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