Response Model

Tournament Object

Field Name

Type

Description

tournamentName

string

The name of the tournament

city

string

The city where the tournament is being held

status

string

The status of the tournament - Cancelled, Confirmed or Unconfirmed. Note that occasionally scheduled tournaments will not take place (e.g. a sponsor pulls out) in which case the status will be set to Cancelled

location

string

The country or state (US only) and country where the tournament is being held. See countryCode for a fixed format location field

countryCode

string

ISO-3166-1 alpha-3 country code of the country where the tournament is taking place. If the country is currently unknown, the code “ZZZ” will be returned.

startDate

date

The date the tournament starts

endDate

date

The date the tournament starts

year

int

The year of the tournament

identifier

int

Identifier for the tournament

numberOfMatches

int

The number of matches to be played in this tournament. Note that for Tennis and Badminton this number is initially an estimate and will become more accurate as the order of play is released

utcOffset

double

The number of hours difference between the tournament location’s timezone and UTC. This accounts for daylght savings.

eventsSummary

object

The number of matches to be played on each day, if known. This data is only available once the order of play for the tournament is released. See object definition below

competitions

array [object]

The competitions which are played as part of the tournament. See object definition below

EventsSummary Object

Field Name

Type

Description

eventsSummary

object

Object containing the number of events on the specified date. There are codes for the types of events: MS - Mens Singles, LS - Ladies Singles, MD - Mens Doubles, LD - Ladies Doubles, XD - Mixed Doubles. The above codes can be prefixed with ‘Q’ to indicate they are part of qualifying for the competition

Competition Object

Field Name

Type

Description

organisation

string

Name of the organisation running the competition (ITTF or WTT)

externalId

string

External identifier for the competition.

competitionId

int

Identifier for the competition

participantType

string

The competition type - possible values are: MS - Mens Singles, LS - Ladies Singles, MD - Mens Doubles, LD - Ladies Doubles, XD - Mixed Doubles

drawSize

int

Draw size for the main competition

qualifyingDrawSize

int

Draw size for the qualifying competition

Last updated