1 of 4

Live Events

This endpoint lists the currently live booked events for which you are licenced. This allows you to determine which events have live streams available.

Endpoint URL

URL: https://dde-api.data.imgarena.com/tournaments/liveevents

We recommend that you request this REST endpoint every 10 seconds so that you have the most up-to-date information on the events that are currently live on the DDE.

You will use the response from this end point to decide which live streams that you should connect to. As soon as you see a live stream available on this end point you should commence connecting to the websocket for that individual live stream event.

Request Parameters

This endpoint currently takes no request parameters, we aim to add them, and once we have they will be detailed here.

Response Model

An array of live event objects.

Live Event Object

Field Name

Type

Description

tournamentName

string

Name of the tournament

eventId

string

Unique identifier for this event

startTime

object

StartTime object indicating when the match was scheduled to start

teamA

object

A team status object describing the first team taking part

teamB

object

A team object describing the second team taking part

Sample Response

An example from the Tournaments Live Events end point in December 2024

New URL: https://dde-api.data.imgarena.com/tournaments/liveevents

{
        "startTime": {
            "status": "FollowsPrevious"
        },
        "teamA": {
            "status": "KnownTennisTeam",
            "team": {
                "player1": {
                    "id": "MN13",
                    "firstName": "Maximilian",
                    "lastName": "Marterer",
                    "country": "GER"
                },
                "entryType": "Standard",
                "seed": 8
            }
        },
        "eventId": "2025-9900-MS028",
        "teamB": {
            "status": "KnownTennisTeam",
            "team": {
                "player1": {
                    "id": "F0BT",
                    "firstName": "Jonas",
                    "lastName": "Forejtek",
                    "country": "CZE"
                },
                "entryType": "Standard"
            }
        },
        "tournamentName": "United Cup"
    },

Full Live events schema

Live Event: Note: api will return a list of LiveEvent when hitting LiveEvents endpoint.

{
  "$id": "LiveEvent$",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "tournamentName": {
      "type": "string"
    },
    "eventId": {
      "type": "string"
    },
    "startTime": {
      "oneOf": [
        {
          "type": "object",
          "description": "Holds default ordering for different types.",
          "additionalProperties": false,
          "properties": {
            "time": {
              "type": "string",
              "format": "time"
            }
          },
          "required": [
            "time"
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "NoInformation",
                "FollowsPrevious"
              ]
            }
          },
          "required": [
            "status"
          ]
        }
      ]
    },
    "teamA": {
      "properties": {
        "status": {
          "type": "string"
        },
        "team": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "player1": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "player2": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "seed": {
              "type": "integer"
            },
            "entryType": {
              "type": "string",
              "enum": [
                "QualifierEntry",
                "Wildcard",
                "SpecialExempt",
                "LuckyLoser",
                "Standard",
                "Alternate",
                "ProtectedRank"
              ]
            }
          },
          "required": [
            "player1",
            "entryType"
          ]
        }
      }
    },
    "teamB": {
      "properties": {
        "status": {
          "type": "string"
        },
        "team": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "player1": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "player2": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "seed": {
              "type": "integer"
            },
            "entryType": {
              "type": "string",
              "enum": [
                "QualifierEntry",
                "Wildcard",
                "SpecialExempt",
                "LuckyLoser",
                "Standard",
                "Alternate",
                "ProtectedRank"
              ]
            }
          },
          "required": [
            "player1",
            "entryType"
          ]
        }
      }
    }
  },
  "required": [
    "teamB",
    "eventId",
    "tournamentName",
    "teamA",
    "eventTiming"
  ]
}

Full Live events schema

Live Event: Note: api will return a list of LiveEvent when hitting LiveEvents endpoint.

{
  "$id": "LiveEvent$",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "tournamentName": {
      "type": "string"
    },
    "eventId": {
      "type": "string"
    },
    "startTime": {
      "oneOf": [
        {
          "type": "object",
          "description": "Holds default ordering for different types.",
          "additionalProperties": false,
          "properties": {
            "time": {
              "type": "string",
              "format": "time"
            }
          },
          "required": [
            "time"
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "NoInformation",
                "FollowsPrevious"
              ]
            }
          },
          "required": [
            "status"
          ]
        }
      ]
    },
    "teamA": {
      "properties": {
        "status": {
          "type": "string"
        },
        "team": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "player1": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "player2": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "seed": {
              "type": "integer"
            },
            "entryType": {
              "type": "string",
              "enum": [
                "QualifierEntry",
                "Wildcard",
                "SpecialExempt",
                "LuckyLoser",
                "Standard",
                "Alternate",
                "ProtectedRank"
              ]
            }
          },
          "required": [
            "player1",
            "entryType"
          ]
        }
      }
    },
    "teamB": {
      "properties": {
        "status": {
          "type": "string"
        },
        "team": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "player1": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "player2": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "lastName": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "firstName",
                "lastName",
                "country"
              ]
            },
            "seed": {
              "type": "integer"
            },
            "entryType": {
              "type": "string",
              "enum": [
                "QualifierEntry",
                "Wildcard",
                "SpecialExempt",
                "LuckyLoser",
                "Standard",
                "Alternate",
                "ProtectedRank"
              ]
            }
          },
          "required": [
            "player1",
            "entryType"
          ]
        }
      }
    }
  },
  "required": [
    "teamB",
    "eventId",
    "tournamentName",
    "teamA",
    "eventTiming"
  ]
}

Response Model

An array of live event objects.

Live Event Object

Field Name

Type

Description

tournamentName

string

Name of the tournament

eventId

string

Unique identifier for this event

startTime

object

StartTime object indicating when the match was scheduled to start

teamA

object

A team status object describing the first team taking part

teamB

object

A team object describing the second team taking part