Live Events
This endpoint is to be used in conjunction with the Team Round Details web socket endpoint. You should use the response from this end point to decide which live streams you should connect to. As soon as you see a live stream available on this endpoint you should commence connecting to the web socket for that individual live stream event (I.e a Team playing a Round of Golf).
Per each live event, the endpoint will return the following information:
Name of the live tournament
Round number of the live tournament
Start time and status of the live tournament
Group and team identification number (also match identifier for match play and Ryder Cup)
Detailed information of the player
Entry type of each player
Endpoint URL
Endpoint for all live tournaments:
https://dde-api.data.imgarena.com/golf/tournaments/liveevents
Required Headers
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
*Authorization header includes a truncated Bearer token, contact IMG for your auth token if you do not have.
Request Parameters
This endpoint takes no request parameters.
Response Model
Live Events Object
Field Name
Type
Description
tournamentId
int
The unique id of the tournament
tournamentName
string
The name of the tournament
roundNo
int
The number of the round
startTime
object
see object below
Group
object
see object below
matchNo
int
[Optional] will only be available for match play and Ryder Cup formats in which case matchNo = groupNo
Start Time Object
Field Name
Type
Description
status
string
The status of the start time – e.g. ‘StartsAt’
time
date
The time the group are scheduled to start their round
Group Object
Field Name
Type
Description
groupNo
int
The official group’s number, an identifier for the group within the round and course.
teams
object
see object docs
Teams and Players Object
There are typically only 2 or 3 teams in a Groups - but below is an example of 4.
Field Name
Type
Description
teamNo
int
The ID of the team within the Tournament
displayName
string
Lowercase first name, uppercase surname
country
string
ISO country code of player's country
isAmateur
boolean
true/false statement of amateur status
lastName
string
Last name of the player
firstName
string
First name of the player
entryType
string
How the player entered the tournament possible values include ************************************************************
Players Object
Field Name
Type
Description
playerId
int
The ID of the player
displayName
string
The display name of the player
playerPGATourId
int
The PGA Tour Id of the player where applicable
playerEuropeanTourId
int
The European Tour Id of the player where applicable
playerLPGATourId
int
The LPGA Tour Id of the player where applicable
firstName
string
The first name of the player
lastName
string
The last name of the player
country
string
The country code of the player’s country
isAmateur
boolean
Is the player an amateur or not
status
string
Players' status, one of the following: Entered, Alternate, Playing, Withdrawn, Retired, Disqualified, MissedCut, Removed, Unknown.
Sample Code
Last updated