Draws vs OOPs

Draw

Endpoint: /tournaments/{id}/draws

The draws endpoint returns draw information that is published pre-tournament. This draw information is then updated on an event by event basis as the tournament progresses. Each time a player wins a match, they are entered into the next round of the draw and the draw is updated accordingly. Draws are also updated when players drop out due to injury and are replaced by lucky losers, or when there is a walkover.

Large numbers of the events in the draw will be placeholders (i.e. with no player information) until the tournament is close to conclusion.

Associated information returned from the endpoint regarding scheduling should be taken as a very rough estimate until the corresponding event has been published on the events endpoint.

Order of Play (OOP)

Endpoint: tournaments/{id}/events

The events endpoint is a direct reflection of the Order of Play (OOP). The OOP is exactly as it says on the tin - the order of play for each court. Each court will have a number of matches lined up, and each match will have a court sequence number, so you know what order matches will be played in on each court.

In addition to this, each match will have a scheduled start time and state. Either 'not before' (the match will not start before this time) or 'follows previous' (the match will follow the previous match on the court). The time attributed with a 'follows previous' state is a rough estimate of the start time of that match.

The tournament director is responsible for publishing the OOP for the following day's play at the end of the current day. This is normally not published until the final match of the current day has ended, unless they need to make exceptions in cases like walkovers or delays. Expect new OOP information on this endpoint around 30 mins after the last match of the day.

The OOP can be used as the definitive point of confirmation around when specific events are going to take place and can be reconciled against the draw accordingly.