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.

Live Events

GET https://dde-api.imggaming.com/tabletennis/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. This endpoint currently takes no request parameters.

Headers

Name	Type	Description
Authorization	string	OAuth2 Bearer token
Accept	string	application/vnd.imggaming.dde.api+json;version=1

200 The response is typically used to decide which live streams should get connected to. As soon as a live stream is available, connecting to the websocket for that individual live stream event should be commenced.

[
    {
        "eventId": 85413,
        "eventState": "InProgress",
        "startTime": {
            "status": "StartsAt",
            "time": "18:40"
        },
        "teamA": {
            "status": "KnownTableTennisTeam",
            "team": {
                "entryType": "Standard",
                "player1": {
                    "externalId": "104257",
                    "firstName": "Youngsik",
                    "id": 115,
                    "lastName": "JEOUNG"
                },
                "seed": 12
            }
        },
        "teamB": {
            "status": "KnownTableTennisTeam",
            "team": {
                "entryType": "Standard",
                "player1": {
                    "externalId": "112409",
                    "firstName": "Jonathan",
                    "id": 116,
                    "lastName": "GROTH"
                },
                "seed": 29
            }
        },
        "tournamentExternalId": "5365",
        "tournamentId": 33,
        "tournamentName": "WTT China Champions 2021 - IMGSIM 2"
    },
    {
        "eventId": 4648,
        "eventState": "InProgress",
        "startTime": {
            "status": "StartsAt",
            "time": "19:05"
        },
        "teamA": {
            "status": "KnownTableTennisTeam",
            "team": {
                "entryType": "Qualifier",
                "player1": {
                    "externalId": "120284",
                    "firstName": "Tibor",
                    "id": 6357,
                    "lastName": "SPANIK"
                },
                "seed": 34
            }
        },
        "teamB": {
            "status": "KnownTableTennisTeam",
            "team": {
                "entryType": "Qualifier",
                "player1": {
                    "externalId": "120765",
                    "firstName": "Eric",
                    "id": 6360,
                    "lastName": "THILLEN"
                },
                "seed": 70
            }
        },
        "tournamentExternalId": "2480",
        "tournamentId": 18,
        "tournamentName": "2021 ITTF Czech International Open"
    }
]

302

304

400

The value of HTTP header 'Accept' was malformed:
Accept must match .*application/vnd.imggaming.dde.api\+json;\s?version=(\d).*, image/* or text/csv

401

The supplied authentication is invalid