Response Model

The response format is the same as the one of the /tournaments/{id}/draws endpoint.

Draw Object (Tennis)

Field Name

Type

Description

competitionId

string

Unique identifier for this competition

competitionType

string

Identifies the competition type e.g MD - Mens Doubles, LS - Ladies singles. There will be a draw object for each singles competition in the tournament and each doubles competition. Therefore, for a tournament with both ATP & WTA events there may be 4 or 5 draws

drawSize

int

Number of positions in the draw

entrySize

int

Number of teams in the draw (if not equal to drawSize then some teams will be given byes)

numberOfPools

int

(Round robin tournament only) The number of pools in the round robin

matches

array[object]

Array of Match objects describing the matches that are to be played

Match Object (Tennis)

Field Name

Type

Description

eventId

string

Unique identifier for this match within the competition - to match this with the eventID returned in the /[id]/events end point you just need to concatenate it with the competitionID

round

int

(Knockout tournament only) Which round of the draw this match is in. The rounds work backwards, with 1 being the final, 2 being the semi finals, 3 the quarters etc

stageType

string

(Round robin only) Indicates if this match is in the group stage or the knockout stage. Values are Group or Knockout

groupId

int

(Round robin only) If a group stage match then this shows the id of the group the match is in

teamA

object

A team status object describing the first team taking part (if known)

teamB

object

A team status object describing the second team taking part (if known)

estimatedDate

date

Indicates the date when the match is likely to be played

estimatedTime

timestamp

Please be advised that this is merely a placeholder until the official Order of Play has been released and will be defaulted to 10am local time

Team Status Object (Tennis)

Field Name

Type

Description

status

string

Indicates if the player detail is known for this team. Values are KnownTennisTeam, UnknownTennisTeam or Bye. For UnknownTennisTeam or Bye, no other fields will be present

team

object

A tennis team object

Team Object (Tennis)

Field Name

Type

Description

Player1

object

Player object containing details for the first player in the team

Player2

object

Player object containing details for the second player in the team. Only present if a doubles team

seed

int

This team’s seeding for the competition

entryType

string

This team’s entry type for the competition. Possible values are: Wildcard, Qualifier, LuckyLoser, ProtectedRank, Alternate, SpecialExempt or Standard

Last updated