This endpoint lists all tournaments for which you are licensed, and you have booked at least one event. With unlimited licences, you will see all tournaments and events as they are automatically booked for you
The /tournaments endpoint will display the following types of information on each tournament:
City (LA)
Location (California)
Country (USA)
Surface
Year
Environment (Indoors or outdoors)
Name
Number of matches
Match Schedule Plan info (expected matches each day)
Draw Sizes
Start/End Date
Competition IDs (2024-0540)
Organisation (ATP/AELTC/USTA/FFT)
We recommend that you request the https://dde-api.data.imgarena.com/tournaments REST endpoint every 12 hours so that you have the most up-to-date information on the tournaments that we offer at all times.
Example requests of this end point:
https://dde-api.data.imgarena.com/tournaments?includeUnbooked=true (includes all matches, booked and unbooked, that you may have for this tournament)
https://dde-api.data.imgarena.com/tournaments?dateFrom=2024-02-28&dateTo=2024-03-01 (All matches between 28 Feb and 1 March)
This endpoint takes the following parameters:
Parameter
Type
Purpose
includeUnbooked
boolean
When set to true we will return a list of all tournaments for which you are licensed irrespective of whether you have booked events in them. If not specified then only booked tournaments are returned
dateFrom
date
Filter the tournaments by date. Only tournaments which have events on or after the specified date will be included.
E.g. dateFrom=2024-06-01
dateTo
date
Filter the tournaments by date. Only tournaments which have events on or before the specified date will be included.
E.g. dateTo=2024-06-30
Field Name
Type
Description
sport
string
The sport of the tournament
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. Note that when a tournament is cancelled, the location will be set to CANCELLED as well. 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
surface
string
The surface the tournament is being played on. Can be one of Hard, Clay, Grass or Carpet
year
int
The year of the tournament
identifier
int
Identifier for the tournament
environment
string
Whether the tournament is held Indoor or Outdoor
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. Note that this offset does not account for Daylight Saving Time (DST) rules, so at the time of the tournament the actual offset may be slightly different
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. Generally there is a single tournament but some events have both ATP and WTA competitions. See object definition below
eventsResource
url
Location of details of the tournament events
bookingStatus
string
Indicates if this tournament is booked. One of: “Booked”, “Autobooked”, “NotBooked” or “PartiallyBooked”. PartiallyBooked indicates that some of the events have been booked
venueNames
array [object]
Venue name of where the tournament is hosted. Note if available
Field Name
Type
Description
numberOfMatchesBookedToday
int
Optional field indicating the number of events booked from the tournament if the bookingStatus was “PartiallyBooked”
Field Name
Type
Description
{date}
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/MX - 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
Field Name
Type
Description
organisation
string
Name of the organisation running the competition (ATP, FFT, AELTC, USTA)
externalId
string
Identifier for the competition. Note that the tournament year and this id uniquely identify a competition e.g. 2024-9028
competitionId
string
Identifier for the competition - this is the year and the externalId
competitionType
string
The competition type - possible values are: Challenger, 250, 500, 1000, GrandSlam, WorldChampionships, Premier, Premier5, Qualifying, Internationals, PremierMandatory, ITF
singlesDrawSize
int
Draw size for the singles competition
singlesQualifyingDrawSize
int
Draw size for the singles qualifying competition
doublesDrawSize
int
Draw size for the doubles competition
doublesQualifyingDrawSize
int
Draw size for the doubles qualifying competition
startDate
date
Start date of the competition
endDate
date
End date of the competition
licensingProperty
string
The license covering the event
drawPoolSize (Round Robin only)
int
The number of teams within each group in the **round robin tournament**
drawNumPools (Round Robin only)
int
The number of groups within the **round robin tournament**
Tournament: Note - Multiple tournaments can be returned after a call in an array.