# 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: Legacy - `https://dde-api.data.imgarena.com/golf/tournaments/{tournamentId}/schedule` (Decommissioning on 30th Sept 2026) **NEW** - `https://dde-api.data.srarena.io/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

| | ``` [ { "bookingStatus": "Booked", "courseId": "3", "courseName": "Emirates GC", "date": "2025-01-17", "externalCourseId": "ET-278", "group": { "featureGroup": false, "groupNo": 27, "matchNo": null, "teams": [ { "orderOfPlayWithinGroup": 0, "players": [ { "country": "NIR", "displayName": "Rory McIlroy", "firstName": "Rory", "isAmateur": false, "lastName": "McIlroy", "playerEuropeanTourId": "34024", "playerId": 14, "playerLPGATourId": null, "playerPGATourId": "28237", "playerRandAId": "73414", "status": "Entered" } ], "teamNo": 3 }, { "orderOfPlayWithinGroup": 1, "players": [ { "country": "NOR", "displayName": "Viktor Hovland", "firstName": "Viktor", "isAmateur": false, "lastName": "Hovland", "playerEuropeanTourId": "40148", "playerId": 3347, "playerLPGATourId": null, "playerPGATourId": "46717", "playerRandAId": "145029", "status": "MissedCut" } ], "teamNo": 11 }, { "orderOfPlayWithinGroup": 2, "players": [ { "country": "ENG", "displayName": "Tommy Fleetwood", "firstName": "Tommy", "isAmateur": false, "lastName": "Fleetwood", "playerEuropeanTourId": "35371", "playerId": 12, "playerLPGATourId": null, "playerPGATourId": "30911", "playerRandAId": "129462", "status": "Entered" } ], "teamNo": 5 } ] }, "groupId": 1122833, "hole": 1, "matchType": "Strokeplay", "poolNo": null, "round": 2, "startTime": { "status": "StartsAt", "time": "12:25+04:00" }, "status": "Finished", "teeSeq": 27 }, { "bookingStatus": "Booked", "courseId": "3", "courseName": "Emirates GC", "date": "2025-01-16", "externalCourseId": "ET-278", "group": { "featureGroup": false, "groupNo": 41, "matchNo": null, "teams": [ { "orderOfPlayWithinGroup": 0, "players": [ { "country": "ENG", "displayName": "Dale Whitnell", "firstName": "Dale", "isAmateur": false, "lastName": "Whitnell", "playerEuropeanTourId": "36453", "playerId": 7270, "playerLPGATourId": null, "playerPGATourId": "33117", "playerRandAId": null, "status": "MissedCut" } ], "teamNo": 38 }, { "orderOfPlayWithinGroup": 1, "players": [ { "country": "RSA", "displayName": "Louis de Jager", "firstName": "Louis", "isAmateur": false, "lastName": "de Jager", "playerEuropeanTourId": "35943", "playerId": 795, "playerLPGATourId": null, "playerPGATourId": "31681", "playerRandAId": null, "status": "Entered" } ], "teamNo": 112 }, { "orderOfPlayWithinGroup": 2, "players": [ { "country": "ENG", "displayName": "Marcus Armitage", "firstName": "Marcus", "isAmateur": false, "lastName": "Armitage", "playerEuropeanTourId": "36452", "playerId": 7251, "playerLPGATourId": null, "playerPGATourId": "45194", "playerRandAId": "142329", "status": "Entered" } ], "teamNo": 109 } ] }, "groupId": 1122548, "hole": 10, "matchType": "Strokeplay", "poolNo": null, "round": 1, "startTime": { "status": "StartsAt", "time": "12:45+04:00" }, "status": "Finished", "teeSeq": 41 }, { "bookingStatus": "Booked", "courseId": "3", "courseName": "Emirates GC", "date": "2025-01-17", "externalCourseId": "ET-278", "group": { "featureGroup": false, "groupNo": 18, "matchNo": null, "teams": [ { "orderOfPlayWithinGroup": 0, "players": [ { "country": "AUS", "displayName": "Min Woo Lee", "firstName": "Min Woo", "isAmateur": false, "lastName": "Lee", "playerEuropeanTourId": "41662", "playerId": 266, "playerLPGATourId": null, "playerPGATourId": "37378", "playerRandAId": "146599", "status": "Entered" } ], "teamNo": 51 }, { "orderOfPlayWithinGroup": 1, "players": [ { "country": "DEN", "displayName": "Rasmus Højgaard", "firstName": "Rasmus", "isAmateur": false, "lastName": "Højgaard", "playerEuropeanTourId": "42144", "playerId": 7255, "playerLPGATourId": null, "playerPGATourId": "52686", "playerRandAId": "152144", "status": "Entered" } ], "teamNo": 18 }, { "orderOfPlayWithinGroup": 2, "players": [ { "country": "USA", "displayName": "Akshay Bhatia", "firstName": "Akshay", "isAmateur": false, "lastName": "Bhatia", "playerEuropeanTourId": "43971", "playerId": 7042, "playerLPGATourId": null, "playerPGATourId": "56630", "playerRandAId": "50019324", "status": "Entered" } ], "teamNo": 2 } ] }, "groupId": 1122867, "hole": 10, "matchType": "Strokeplay", "poolNo": null, "round": 2, "startTime": { "status": "StartsAt", "time": "08:15+04:00" }, "status": "Finished", "teeSeq": 18 } ] ``` **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 | ``` "startTime": { "status": "StartsAt", "time": "12:25+04:00" } ``` **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 | | ``` "group": { "featureGroup": false, "groupNo": 1, "matchNo": null, "teams": [] ``` **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 | ``` "teams": [ { "orderOfPlayWithinGroup": 0, "players": [], "teamNo": 38 }, { "orderOfPlayWithinGroup": 1, "players": [], "teamNo": 112 }, { "orderOfPlayWithinGroup": 2, "players": [], "teamNo": 109 } ] ``` **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 | ``` "players": [ { "country": "USA", "displayName": "Scott Piercy", "firstName": "Scott", "isAmateur": false, "lastName": "Piercy", "playerEuropeanTourId": "36202", "playerId": 5009, "playerLPGATourId": null, "playerPGATourId": "25818", "playerRandAId": null, "status": "Entered" } ], ``` 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:- ``` "teams": [ { "orderOfPlayWithinGroup": 0, "players": [ { "country": "ESP", "displayName": "Jon Rahm", "firstName": "Jon", "isAmateur": false, "lastName": "Rahm", "playerEuropeanTourId": "41208", "playerId": 493, "playerLPGATourId": null, "playerPGATourId": "46970", "playerRandAId": "136813", "status": "Entered" }, { "country": "ENG", "displayName": "Tyrrell Hatton", "firstName": "Tyrrell", "isAmateur": false, "lastName": "Hatton", "playerEuropeanTourId": "37626", "playerId": 6, "playerLPGATourId": null, "playerPGATourId": "34363", "playerRandAId": "100599", "status": "Entered" } ], "teamNo": 30 }, { "orderOfPlayWithinGroup": 1, "players": [ { "country": "USA", "displayName": "Scottie Scheffler", "firstName": "Scottie", "isAmateur": false, "lastName": "Scheffler", "playerEuropeanTourId": "41218", "playerId": 5972, "playerLPGATourId": null, "playerPGATourId": "46046", "playerRandAId": "146550", "status": "Entered" }, { "country": "USA", "displayName": "Sam Burns", "firstName": "Sam", "isAmateur": false, "lastName": "Burns", "playerEuropeanTourId": "40327", "playerId": 3474, "playerLPGATourId": null, "playerPGATourId": "47504", "playerRandAId": "146566", "status": "Entered" } ], "teamNo": 25 } ] ``` ### 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/golf-media/untitled/schedule.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.