Tournaments

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 (2022-7699)

• Organisation (ATP/UTR)

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.

Note legacy URL: https://dde-api.imggaming.com/tournaments/

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=2022-02-28&dateTo=2022-03-01 (All matches between 28 Feb and 1 March)

Legacy URL examples:

• https://dde-api.imggaming.com/tournaments?includeUnbooked=true (includes all matches, booked and unbooked, that you may have for this tournament)

• https://dde-api.imggaming.com/tournaments?dateFrom=2022-02-28&dateTo=2022-03-01 (All matches between 28 Feb and 1 March)

Request Parameters

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=2022-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=2022-06-30