Schedule
This endpoint returns information on all off the tee times of all the groups within a single tournament. This will return the tee times for all days of the tournament. It contains information on:
Course
Round
Tee sequence
Hole
Start date and time
Player and group number (and team number for Match Play tournaments.)
Endpoint URL
Endpoint for tournament schedule:
https://dde-api.data.imgarena.com/golf/tournaments/{tournamentId}/schedule
To view a schedule, enter the ID of the event for example, the ID for The American Express 2025 is 1092, which will display the schedule for all 4 rounds. Note that you can pass ID as 1 to return sample data.
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 currently takes no request parameters, we aim to add them, and once we have they will be detailed here. It will be query-able by date and this doc will be updated when that is ready.
Response Model
Event Object
Field Name
Type
Description
Optional
date
date
The day that the round will be played for that group
round
integer
The round that is being played for that group
hole
integer
The hole in which the round is starting for that group
teeSeq
integer
The sequence on the tee for that group
courseId
integer
The ID of the course for the round for that group
courseName
string
The name of the course for the round for that group
status
string
The status of the round for that group. The values are either: NotStarted, InProgress or Finished.
matchType
string
"Strokeplay" or "Matchplay"
bookingStatus
string
If an end user has got a license for that group; always set to “Booked”
startTime
object
See object docs
groupId
integer
Unique ID for the group
group
object
See object docs
poolNo
integer
[Optional] number of the pool the match is in
YES
externalCourseId
string
The Golf Course Id
from the federation database. This is composed of the ID number concatenated with the federation abbreviation, either ET or PGA
Start Time Object
Field Name
Type
Description
status
string
The status of the start time – e.g. ‘StartsAt’
time
date
The time of the group are scheduled to start their round. Time is returned in UTC format
Group Object
Field Name
Type
Description
Optional
featureGroup
boolean
Returned as "true" if group is a featured grope. Note PGA only
groupNo
integer
The group’s number, an identifier for the group within that round.
MatchNo
integer
For Match Play tournaments only
When is Match Play tournament "matchNo" = "groupNo"
YES
teams
object
See object doc
Teams Object
Field Name
Type
Description
teamNo
integer
The ID of the team within the Tournament
orderOfPlayWithinGroup
integer
The order within the Group (or Match for Match Play.) Useful for ordering the display name of the Teams on the Front End.
players
object
Contains player objecy
Players Object
Field Name
Type
Description
playerId
integer
The ID of the player across the whole of Golf
displayName
string
The display name of the player
playerPGATourId
integer
Player's PGA tour Id (if relevant)
playerEuropeanTourId
integer
Player's European tour Id (if relevant)
playerRandAId
integer
Player's R&A Id (if relevant)
playerLPGATourId
integer
Player's LPGA tour Id (if relevant)
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
The player’s entry type into the tournament
The above example is for Stroke Play, if two players will appear in a Team much like the Ryder Cup, this formation will look as follows:-
Playoffs
During a playoff, the schedule will be used in the same way as before. The only way of discerning whether or not a scheduled round would be a play off would be to understand the round type from the isPlayOff is True from the Tournaments end point.
Last updated