# Tournament(s) This endpoint returns information on all golf tournaments, past and future. Per each tournament, this endpoint will return the following information: * Dates of the tournament * Name of the tournament * Tournament format * Round information * Detailed information of the golf course(s) for the tournament. ## Endpoint URLs #### All tournaments: `https://dde-api.data.imgarena.com/golf/tournaments` #### Live tournaments: `https://dde-api.data.imgarena.com/golf/tournaments/live` {% hint style="info" %} The above endpoint can be filtered by `tournamentDataStatus` "Scheduled" is a real tournament with data coming from the course "Test" is a pseudo tournament for the the purpose of testing, can be subset of an entire tournament aimed at specific use cases "Simulation" is either an entire pseudo tournament or replay of old tournament for the purpose of testing "Disabled" is soft deleted, actioned internally "All" returns all tournaments **Examples:** `https://dde-api.data.imgarena.com/golf/tournaments` returns all tournaments **except** "tournamentDataStatus":"Disabled" `https://dde-api.data.imgarena.com/golf/tournaments?tournamentDataStatus=All` returns **all tournaments** `https://dde-api.data.imgarena.com/golf/tournaments?tournamentDataStatus=Scheduled` returns **only** tournaments with "tournamentDataStatus":"Scheduled" `https://dde-api.data.imgarena.com/golf/tournaments/live?tournamentDataStatus=Scheduled` returns **all live tournaments** with tournamentDataStatus":"Scheduled" {% endhint %} **Specific tournament:** If you require information for a particular tournament, please enter the tournament Id which is returned via the IMG Arena Golf tournaments endpoint. i.e: `https://dde-api.data.imgarena.com/golf/tournaments/{id}` ## Required Headers | Key | Value | | ------------- | ------------------------------------------------ | | Accept | application/vnd.imggaming.dde.api+json;version=1 | | Content-Type | application/json | | Authorization | Bearer eyvhaoudfgpdfgo\* | ## Request Parameters If no parameters are used, this endpoint will return all tournaments that start within one month either side of the date of the request. i.e By passing “dateFrom = 2025-07-01” and “dateTo = 2025-07-31”, endpoint will return all tournaments FROM the 1st of July 2025 To the 31st of July 2025. This endpoint currently takes the following parameters: | Parameter | Description | | --------- | ---------------------------------------------------------------------------------------------------------------------------- | | dateFrom | e.g. dateFrom=2025-04-15. To be used in conjunction with dateTo to return a list of tournaments within a certain date range. | | dateTo | e.g. dateTo=2025-04-15. To be used in conjunction with dateFrom to return a list of tournaments within a certain date range. | Note that if the dateFrom parameter overlaps when a particular tournament is being played, then the startDate returned will be before the dateFrom parameter. i.e if you are passing dateFrom=2025-11-01 and dateTo=2025-11-30", if round 4 is on the 1st, then the startDate returned will be "2025-10-29". Please note that If you do not pass any parameters, this endpoint will return all tournaments that start within one month either side of the date of the request. i.e if request was made on the 1st of July, tournaments from the 1st of June to 1st August. ## Response Model \ **Tournament Object** | Field Name | Type | Description | Optional | | ------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | format | string |

The format of the tournament. The current possible values you can expect are:

StrokePlay, RyderCup, HeroCup, BelgianKO, GolfSixes, MatchPlay5Days, MatchPlay4Days, Custom, Stroke, Match, TeamMatch, Team, Stableford, StrokePlayProAm, Other

| | | tour | string | The Tour on which the tournament is taking place. Can be "PGA tour", "LPGA Tour", "European Tour" or LIV Tour | | | tourID | integer |

Returns an ID for the Tour in which the tournament is taking place.

ID 0 = Unknown
ID 1 = PGA Tour
ID 2 = European Tour
ID 3 = LPGA Tour
ID 4 = LIV Tour

| | | name | string | The name of the tournament | | | id | integer | The id of the tournament | | | startDate | - | Returned as null. please pass the tournament Id to retrieve this information. | | | endDate | date | The end date of the tournament (In UTC timezone) | | | startTeeTime | date/time or null | The starting tee time of the 1st round. Please note by default, this value will be "start date of event + midnight", i,e YYYY-MM-DDT00:00:00Z and will be updated once tee-times are made available | | | countryCode | string | The country code of the country in which the tournament is taking place (3 uppercase letters, eg "USA" or "FRA") | | | utcOffset | float | The UTC offset of the local time of the tournament, e.g. if “1” the local time of the tournament is UTC+1 | | | year | integer | The year in which the tournament is taking place | | | rounds | object | See object details below | | | golfCourses | object | See object details below | | | venue | string | String containing name or address of the venue | YES | | mainGolfCourseId | integer | The Golf Course Id of the main course, i.e. where the shot data happens or the Host Course | YES | | mainGolfCourseName | string | The Golf Course name of the main course, i.e. where the shot data happens or the Host Course | YES | | mainExternalGolfCourseId | string | The Golf Course Id of the main course, from the federation database. This is composed of the ID number concatenated with the federation abbreviation, either ET or PGA | YES | | externalId | string | A unique Federation generated Tournament ID | | | tournamentDataStatus | string | can be either "Scheduled", "Test", "Simulation" or "Disabled" see [Endpoint URLs](https://docs.sportradar.com/golf/feed-specifications/end-of-round-strokes#endpoint-urls) section for more info | | | mainGolfCourseAssetId | string | The main course asset Id- internal use | | | historicalDetails | object | Historical details about the event, i,e Id and previous name of event. | | ``` { "countryCode": "USA", "endDate": "2025-01-19", "externalId": "PGA-R2025002", "format": "Stroke", "golfCourses": [], "historicalDetails": {}, "id": 1971, "mainExternalGolfCourseId": "PGA-704", "mainGolfCourseAssetId": null, "mainGolfCourseId": "62", "mainGolfCourseName": "Pete Dye Stadium Course", "name": "The American Express", "rounds": [], "startDate": "2025-01-16", "startTeeTime": "2025-01-16T16:30:00Z", "status": "Finished", "tour": "PGA Tour", "tourId": 1, "tournamentDataStatus": "Scheduled", "utcOffset": -8, "venue": null, "year": 2025 } ``` **Rounds Object** | Field Name | Type | Description | | --------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | roundNo | int | The number of the round. The possible values are 1, 2, 3, 4 and 401 (Playoff) | | roundType | string |

Specifies the type of round. Possible values:

"StrokePlay", "MatchPlay", "RoundRobin"

| | format | string | Specifies play format for a round. Possible values: "BEST\_BALL", "FOUR\_BALL", "FOURSOMES", "GREENSOMES", "GRUESOMES", "REGULAR", "OTHER" | | isPlayOff | boolean | “True” if that round is a Play Off | | scoring | string | Defines how each hole is scored for that round. Possible values; AggregatedStrokes, HoleWonPoint\_TieZero, HoleWonPoint\_TieHalved, Stableford, Other | | advancementRule | string |

Defines how players will be qualified for the next round. Possible values:

"ALL\_QUALIFY", "CUT\_64", "CUT\_60", "CUT\_50", "CUT\_36\_HOLES\_ET", "CUT\_54\_HOLES\_ET", "CUT\_36\_HOLES\_PGA", "CUT\_54\_HOLES\_PGA", "CUT\_TEN\_STROKE", "FINAL", "KNOCK\_OUT", "WON\_1\_POINTS\_DRAW\_HALF\_POINT", "WON\_3\_POINTS\_DRAW\_1\_POINT", "FINAL", "OTHER"

| | playersToMakeCut | integer | Cut value for the round. | | maxStrokesFromLeadCut | integer | To make cut, max strokes from lead value. If not applicable, this will be set to null. | | cutIncludeTies | boolean | If ties are including in the cut. If not applicable this value will be set to null. | ``` "rounds": [ { "advancementRule": "AllQualify", "format": "Other", "isPlayOff": false, "playersToMakeCut": null, "maxStrokesFromLeadCut": null, "cutIncludeTies": null "roundNo": 1, "roundType": "StrokePlay", "scoring": "StrokeSingles" }, { "advancementRule": "Cut", "format": "Other", "isPlayOff": false, "playersToMakeCut": 65, "maxStrokesFromLeadCut": 10, "cutIncludeTies": true, "roundNo": 2, "roundType": "StrokePlay", "scoring": "StrokeSingles" }, { "advancementRule": "AllQualify", "format": "Other", "isPlayOff": false, "playersToMakeCut": null, "maxStrokesFromLeadCut": null, "cutIncludeTies": null "roundNo": 3, "roundType": "StrokePlay", "scoring": "StrokeSingles" }, { "advancementRule": "AllQualify", "format": "Other", "isPlayOff": false, "maxStrokesFromLeadCut": null, "cutIncludeTies": null "playersToMakeCut": null, "roundNo": 4, "roundType": "StrokePlay", "scoring": "StrokeSingles" } ] ``` **Golf Courses Object** | Field Name | Type | Description | | ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | courseName | string | The name of (one of) the golf course(s) at which the event is being played | | courseId | integer | The unique ID of the course | | isMain | boolean | True if the main course at the tournament, false if not | | courseDetails | object | Please view the courseDetails Object table | | externalCourseID | string | The Golf Course Id of the main course, from the federation database. This is composed of the ID number concatenated with the federation abbreviation, either ET or PGA | | scoringLevel | Integer |

This integer value is linked to scoringType value.


1 = Shot link with laser

2 = Scored with walking scorer

3 = Holes scores Only

null = not scored

| | scoringType | string | Type of scoring method being applied that week. See possible values below. | ``` "golfCourses": [ { "courseDetails": [], "courseId": "113", "courseName": "Waialae Country Club", "externalCourseId": "PGA-6", "isMain": true, "scoringLevel": 1, "scoringType": "ShotlinkWithLaser" } ] ``` #### **ScoringTypes** For each Golf Course within a Tournament a particular Scoring Method is employed per round, these are described below. | **Type** | **Description** | | ----------------------- | ------------------------------------------------------------------------------------------------------------- | | ShotlinkWithLaser | Full Shot by Shot coverage across the complete Course. Including distanceToPin, shotDistance, x, y, z values. | | ScoredWithWalkingScorer | Only Shot Counts available during the in play Hole. This Course will not have distance values per Shot. | | HoleScoresOnly | Only Scores at the end of each Hole. Only useful for keeping a Scorecard up to date. | | NotScored | Scores on this Course will not be available. Note that, this value is unlikely to be used operationally. | **Course Details Object** | Field Name | Type | Description | | ---------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- | | roundNo | int | The round number for which the following course details information applies. The possible values are 1, 2, 3, 4 and 401 (Playoff) | | holes | object | Please view the holes object | ``` "courseDetails": [ { "roundNo": 1, "holes": [**see object below** ] }, { "roundNo": 2, "holes": [**see object below** ] }, { "roundNo": 3, "holes": [**see object below** ] }, { "roundNo": 4, "holes": [**see object below** ] }, { "roundNo": 401, "holes": [**see object below** ] } ``` **Holes Object** | Field Name | Type | Description | | --------------------- | ------- | ------------------------------------------------------------------ | | holeNo | int | The number of the hole | | officialYardage | int | The official yardage of the hole | | actualYardage | int | the actual yardage of the hole | | officialMetres | decimal | The official metres length of the hole | | actualMetres | decimal | The actual metres length of the hole | | par | int | The par score of the hole | | isOfficialDrivingHole | boolean | Whether it is the official driving hole on the course (true/false) | | displayName | string | Display name of the hole | | isStreaming | boolean | Is video streaming available on this hole? | | teeBoxes | object | See teeBoxes object | | pinPlacement | object | See pinPlacement object | | stimpReading | string | Returns the green speed effectively. null if not known | ``` "holes": [ { "actualMetres": 440.74, "actualYardage": 482, "displayName": null, "holeNo": 1, "isOfficialDrivingHole": true, "isStreaming": false, "officialMetres": 438.91, "officialYardage": 480, "par": 4, "pinPlacement": { "x": 8895.898, "y": 10520.29, "z": 18.081 }, "stimpReading": null, "teeBoxes": [ { "colour": "Black", "x": 10244.591, "y": 10046.862, "z": 11.087 } ] ``` **Pin Placement Object** | Field Name | Type | Description | | ---------- | ------- | --------------------------------------------------------- | | x | decimal | x co-ordinate of pin (previously longitude of the pin) | | y | decimal | y co-ordinate of pin (previously latitude of the tee pin) | | z | decimal | z co-ordinate of pin | ``` "pinPlacement": { "x": 8895.898, "y": 10520.29, "z": 18.081 } ``` **Tee Boxes Object** Occasionally multiple tee boxes are used at a single tournament. This describes each Tee Box. | Field Name | Type | Description | | ---------- | ------- | -------------------------------------------------------------- | | x | decimal | x co-ordinate of tee box (previously longitude of the tee box) | | y | decimal | y co-ordinate of tee box (previously latitude of the tee box) | | z | decimal | z co-ordinate of tee box | | colour | string | the colour of the tee box, an identifier | ``` "teeBoxes": [ { "colour": "Black", "x": 10244.591, "y": 10046.862, "z": 11.087 } ```