# Golf Entry List Data

## **Endpoint URLs**

`https://dde-api.data.imgarena.com/golf/golf/entrylist/{tournamentID}/{stats_type}`

**URL Sample:**

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/season_sg`

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/season_stats`

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/season_results`

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/aggregated_results`

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/recent_weeks`

`https://dde-api.data.imgarena.com/golf/golf/entrylist/750/tournament_results`<br>

### 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

**Request Types:**

**Tournament Id**

*season\_sg*

*season\_stats*

*season\_results*

*aggregated\_results*

*recent\_weeks*

*tournament\_results*

### Response Model

| Field Name        | Type     | Description                                                                                                            |
| ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| APP               | Array    | Description of Strokes Gained performance for each player's Approach Shots                                             |
| ARG               | Array    | Description of Strokes Gained performance for each player's Around The Green Shots                                     |
| OTT               | Array    | Description of Strokes Gained performance for each player's Off The Tee Shots                                          |
| PUT               | Array    | Description of Strokes Gained performance for each player's Putting Shots                                              |
| overallSG         | Array    | Description of Strokes Gained performance for each player's Overall shot performance covering al stroke types combined |
| percentile        | int      | The percentile among peers the player ranks for this shot type                                                         |
| rank              | int      | The Rank of the player among peers the player sits for performance of this shot type                                   |
| sgSum             | float    | The actual strokes gained sum of the shot type across all times across the season                                      |
| sgValue           | float    | The average sg value for this shot type this season                                                                    |
| avgValue          | float    | The average value of this stat across the season                                                                       |
| endDate           | Date     | The Date this tournament in question ended                                                                             |
| position          | string   | The final position for the player at this tournament                                                                   |
| score             | string   | The final score for the player at this tournament                                                                      |
| totalSG           | float    | The Sum of the overall SG for the player at this tournament                                                            |
| madeCuts          | int      | The number of cuts made by this player                                                                                 |
| madeCutsPerc      | float    | The percentage number of cuts made by this player against all tournaments played                                       |
| roundsPlayed      | int      | The number of rounds played by this player                                                                             |
| top10s            | int      | The number of Top 10 finishes by this player                                                                           |
| top10sPerc        | float    | The percentage number of Top 10 finishes by this player against all finishes                                           |
| top20s            | int      | The number of Top 20 finishes by this player                                                                           |
| top5s             | int      | The number of Top 5 finishes by this player                                                                            |
| totalSG           | float    | The aggregated Total Strokes Gained by this player across multiple tournaments                                         |
| tournamentsPlayed | int      | The aggregated number of tournaments played by this player                                                             |
| teeTime           | DateTime | The tee time for this tournament                                                                                       |
| positionDisplay   | string   | Final position at this recent tournament                                                                               |
| positionScaling   | float    | Position scaling at the recent tournament (how secure was their position during this tournament)                       |
| weeksAgo          | int      | How long ago was this tournament in weeks                                                                              |
| R1                | int      | The player final score on this round only in this tournament                                                           |
| R2                | int      | The player final score on this round only in this tournament                                                           |
| R3                | int      | The player final score on this round only in this tournament                                                           |
| R4                | int      | The player final score on this round only in this tournament                                                           |
| tournament\_year  | DateYear | The Year of the tournament (YYYY)                                                                                      |
| tournamentName    | string   | The name of the Tournament                                                                                             |
| tournamentId      | string   | The unique Tournament ID of the current event                                                                          |
| firstName         | string   | The first name of the player                                                                                           |
| lastName          | string   | The surname of the player                                                                                              |
| playerName        | string   | The first name and last name of the player                                                                             |
| playerCountry     | string   | The nationality of the player                                                                                          |
| teamId            | Number   | The player's Team ID for the current Tournament format                                                                 |
| playerId          | Number   | The player ID                                                                                                          |

### Sample Response for Season SG

```
[
  {
    "APP": {
      "percentile": 100,
      "rank": 1,
      "sgSum": 62.0056145142,
      "sgValue": 0.9842161034
    },
    "ARG": {
      "percentile": 54,
      "rank": 24,
      "sgSum": 10.730382125399998,
      "sgValue": 0.1703235258
    },
    "OTT": {
      "percentile": 92,
      "rank": 5,
      "sgSum": 36.9267314031,
      "sgValue": 0.5861385937
    },
    "PUT": {
      "percentile": 64,
      "rank": 19,
      "sgSum": 16.987089004199998,
      "sgValue": 0.2696363334
    },
    "firstName": "Jon",
    "lastName": "Rahm",
    "overallSG": {
      "percentile": 94,
      "rank": 4,
      "sgSum": 125.99107488450001,
      "sgValue": 1.9998583315
    },
    "playerCountry": "ESP",
    "playerId": 493,
    "playerName": "Jon Rahm",
    "teamId": 45
  },
  {
    "APP": {
      "percentile": 98,
      "rank": 2,
      "sgSum": 62.960297723400004,
      "sgValue": 0.8176662042
    },
    "ARG": {
      "percentile": 74,
      "rank": 14,
      "sgSum": 23.5380729892,
      "sgValue": 0.3056892596
    },
    "OTT": {
      "percentile": 98,
      "rank": 2,
      "sgSum": 67.17067514850001,
      "sgValue": 0.8723464305
    },
    "PUT": {
      "percentile": 62,
      "rank": 20,
      "sgSum": 20.2761791848,
      "sgValue": 0.2633270024
    },
    "firstName": "Rory",
    "lastName": "McIlroy",
    "overallSG": {
      "percentile": 98,
      "rank": 2,
      "sgSum": 173.74437670589998,
      "sgValue": 2.2564204767
    },
    "playerCountry": "NIR",
    "playerId": 14,
    "playerName": "Rory McIlroy",
    "teamId": 2
  }
]
```

### Sample Response for Season Stats

```
[
  {
    "big_miss_sum": {
      "avgValue": 3.0257170341,
      "percentile": 100,
      "rank": 1
    },
    "birdie_or_better_sum": {
      "avgValue": 0.1909545838,
      "percentile": 60,
      "rank": 21
    },
    "bogey_or_worse_sum": {
      "avgValue": 0.2023055555,
      "percentile": 78,
      "rank": 12
    },
    "driver_hit_average": {
      "avgValue": 0.833297542,
      "percentile": 96,
      "rank": 3
    },
    "driving_distance_average": {
      "avgValue": 290.7421374475,
      "percentile": 76,
      "rank": 13
    },
    "fairway_hit_average": {
      "avgValue": 0.4865024845,
      "percentile": 2,
      "rank": 50
    },
    "firstName": "Robert",
    "go_for_green_sum": {
      "avgValue": 2.6403465681,
      "percentile": 68,
      "rank": 17
    },
    "green_in_regulation_average": {
      "avgValue": 0.6237004146,
      "percentile": 10,
      "rank": 46
    },
    "gsg_binned_11_20_feet": {
      "avgValue": -0.021389547,
      "percentile": 40,
      "rank": 31
    },
    "gsg_binned_125_175_yards": {
      "avgValue": -0.1895133843,
      "percentile": 22,
      "rank": 40
    },
    "gsg_binned_175_225_yards": {
      "avgValue": -0.0789892721,
      "percentile": 56,
      "rank": 23
    },
    "gsg_binned_21_40_feet": {
      "avgValue": -0.0866919662,
      "percentile": 16,
      "rank": 43
    },
    "gsg_binned_225_plus_yards": {
      "avgValue": -0.0646799941,
      "percentile": 58,
      "rank": 22
    },
    "gsg_binned_3_10_feet": {
      "avgValue": -0.1799840403,
      "percentile": 16,
      "rank": 43
    },
    "gsg_binned_50_125_yards": {
      "avgValue": -0.0393273857,
      "percentile": 16,
      "rank": 43
    },
    "lastName": "MacIntyre",
    "par_3_vspar_score": {
      "avgValue": 0.2063119751,
      "percentile": 42,
      "rank": 30
    },
    "par_5_vspar_score": {
      "avgValue": -1.3197433089,
      "percentile": 34,
      "rank": 34
    },
    "penalty_shots": {
      "avgValue": 0.3860360639,
      "percentile": 78,
      "rank": 12
    },
    "playerCountry": "SCO",
    "playerId": 209,
    "playerName": "Robert MacIntyre",
    "scrambling_average": {
      "avgValue": 0.5931744594,
      "percentile": 40,
      "rank": 31
    },
    "teamId": 7
  }
]
```

### Sample Response for Season Results

```
[
  {
    "firstName": "Jens",
    "lastName": "Dantorp",
    "past": [
      {
        "endDate": "2023-06-18",
        "position": "T119",
        "score": "+7",
        "totalSG": -3.4038461538461604,
        "tournament": "U.S. Open",
        "tournamentId": "643"
      },
      {
        "endDate": "2023-07-16",
        "position": "T127",
        "score": "+3",
        "totalSG": -5.109677419354838,
        "tournament": "Barbasol Championship",
        "tournamentId": "647"
      },
      {
        "endDate": "2023-02-12",
        "position": "T82",
        "score": "-1",
        "totalSG": -1.298114735137645,
        "tournament": "Singapore Classic",
        "tournamentId": "668"
      },
      {
        "endDate": "2023-02-05",
        "position": "T120",
        "score": "+4",
        "totalSG": -5.770992366412216,
        "tournament": "Ras Al Khaimah Championship",
        "tournamentId": "671"
      },
      {
        "endDate": "2023-02-19",
        "position": "T69",
        "score": "-2",
        "totalSG": -0.2869535045107483,
        "tournament": "Thailand Classic",
        "tournamentId": "672"
      },
      {
        "endDate": "2023-05-14",
        "position": "2",
        "score": "-16",
        "totalSG": 13.372973004196524,
        "tournament": "Soudal Open",
        "tournamentId": "677"
      },
      {
        "endDate": "2023-03-26",
        "position": "T64",
        "score": "-7",
        "totalSG": -1.025641025641022,
        "tournament": "Jonsson Workwear Open",
        "tournamentId": "678"
      },
      {
        "endDate": "2023-04-23",
        "position": "T88",
        "score": "E",
        "totalSG": -1.3820422535211208,
        "tournament": "ISPS HANDA - CHAMPIONSHIP",
        "tournamentId": "680"
      },
      {
        "endDate": "2023-05-07",
        "position": "T47",
        "score": "+2",
        "totalSG": 2.366595233317099,
        "tournament": "DS Automobiles Italian Open",
        "tournamentId": "682"
      },
      {
        "endDate": "2023-06-04",
        "position": "145",
        "score": "+15",
        "totalSG": -9.912382363192748,
        "tournament": "Porsche European Open",
        "tournamentId": "683"
      },
      {
        "endDate": "2023-05-28",
        "position": "T144",
        "score": "+9",
        "totalSG": -7.2662531017369645,
        "tournament": "KLM Open",
        "tournamentId": "684"
      },
      {
        "endDate": "2023-07-02",
        "position": "T141",
        "score": "+8",
        "totalSG": -6.224275724275714,
        "tournament": "Betfred British Masters hosted by Sir Nick Faldo",
        "tournamentId": "686"
      },
      {
        "endDate": "2023-09-10",
        "position": "T45",
        "score": "-5",
        "totalSG": 2.9965507610668993,
        "tournament": "Horizon Irish Open",
        "tournamentId": "690"
      },
      {
        "endDate": "2023-07-09",
        "position": "T45",
        "score": "-4",
        "totalSG": 2.684163594004218,
        "tournament": "Made in HimmerLand",
        "tournamentId": "693"
      },
      {
        "endDate": "2023-09-17",
        "position": "T92",
        "score": "+1",
        "totalSG": -2.0773868790795404,
        "tournament": "BMW PGA Championship",
        "tournamentId": "695"
      },
      {
        "endDate": "2023-09-03",
        "position": "T94",
        "score": "-1",
        "totalSG": -0.8529776674937892,
        "tournament": "Omega European Masters",
        "tournamentId": "696"
      },
      {
        "endDate": "2023-08-27",
        "position": "T31",
        "score": "-11",
        "totalSG": 3.875211744776962,
        "tournament": "D+D Real Czech Masters",
        "tournamentId": "697"
      },
      {
        "endDate": "2023-09-24",
        "position": "T28",
        "score": "-4",
        "totalSG": 5.803475208331108,
        "tournament": "Cazoo Open de France",
        "tournamentId": "699"
      },
      {
        "endDate": "2023-03-19",
        "position": "T3",
        "score": "-10",
        "totalSG": 11.63509917207135,
        "tournament": "SDC Championship",
        "tournamentId": "700"
      },
      {
        "endDate": "2023-11-12",
        "position": "T26",
        "score": "-3",
        "totalSG": 2.287878787878782,
        "tournament": "Nedbank Golf Challenge",
        "tournamentId": "703"
      },
      {
        "endDate": "2023-10-09",
        "position": "T67",
        "score": "-6",
        "totalSG": 0.14887427607165193,
        "tournament": "Alfred Dunhill Links Championship",
        "tournamentId": "704"
      },
      {
        "endDate": "2023-11-19",
        "position": "T27",
        "score": "-8",
        "totalSG": -0.980000000000004,
        "tournament": "DP World Tour Championship",
        "tournamentId": "705"
      },
      {
        "endDate": "2023-04-30",
        "position": "T112",
        "score": "+4",
        "totalSG": -2.794830996817751,
        "tournament": "Korea Championship Presented by Genesis",
        "tournamentId": "706"
      },
      {
        "endDate": "2023-10-22",
        "position": "T56",
        "score": "-1",
        "totalSG": -1.7066268656716517,
        "tournament": "Estrella Damm N.A. Andalucía  Masters",
        "tournamentId": "812"
      },
      {
        "endDate": "2023-10-29",
        "position": "T67",
        "score": "-2",
        "totalSG": -0.2686321186595819,
        "tournament": "Commercial Bank Qatar Masters",
        "tournamentId": "813"
      },
      {
        "endDate": "2023-12-17",
        "position": "T49",
        "score": "E",
        "totalSG": -0.3094447890818799,
        "tournament": "AfrAsia Bank Mauritius Open",
        "tournamentId": "856"
      },
      {
        "endDate": "2024-01-14",
        "position": "59",
        "score": "+14",
        "totalSG": -16.500000000000014,
        "tournament": "Dubai Invitational",
        "tournamentId": "857"
      },
      {
        "endDate": "2024-01-21",
        "position": "125",
        "score": "+13",
        "totalSG": -12.976190476190482,
        "tournament": "Hero Dubai Desert Classic",
        "tournamentId": "858"
      },
      {
        "endDate": "2024-01-28",
        "position": "T119",
        "score": "+3",
        "totalSG": -6.473282442748086,
        "tournament": "Ras Al Khaimah Championship",
        "tournamentId": "862"
      }
    ],
    "playerCountry": "SWE",
    "playerId": "102",
    "playerName": "Jens Dantorp",
    "teamId": 38
  }
]
```

### Sample Response for Aggregated Results

```
[
  {
    "firstName": "Jens",
    "lastName": "Dantorp",
    "playerCountry": "SWE",
    "playerId": "102",
    "playerName": "Jens Dantorp",
    "stats": [
      {
        "madeCuts": 30,
        "madeCutsPerc": 0.5172413793103449,
        "roundsPlayed": 66,
        "top10s": 4,
        "top10sPerc": 0.06896551724137931,
        "top20s": 4,
        "top5s": 4,
        "totalSG": -1.3601845949000002,
        "tournamentsPlayed": 58
      }
    ],
    "teamId": 38,
    "teeTime": "04:30:00 UTC"
  },
  {
    "firstName": "Adrian",
    "lastName": "Otaegui",
    "playerCountry": "ESP",
    "playerId": "103",
    "playerName": "Adrian Otaegui",
    "stats": [
      {
        "madeCuts": 40,
        "madeCutsPerc": 0.7407407407407407,
        "roundsPlayed": 79,
        "top10s": 6,
        "top10sPerc": 0.1111111111111111,
        "top20s": 14,
        "top5s": 4,
        "totalSG": -0.14774444509999995,
        "tournamentsPlayed": 54
      }
    ],
    "teamId": 23,
    "teeTime": "05:55:00 UTC"
  },
  {
    "firstName": "Tommy",
    "lastName": "Fleetwood",
    "playerCountry": "ENG",
    "playerId": "12",
    "playerName": "Tommy Fleetwood",
    "stats": [
      {
        "madeCuts": 44,
        "madeCutsPerc": 0.88,
        "roundsPlayed": 86,
        "top10s": 22,
        "top10sPerc": 0.44,
        "top20s": 32,
        "top5s": 14,
        "totalSG": 2.069582744100001,
        "tournamentsPlayed": 50
      }
    ],
    "teamId": 4,
    "teeTime": "06:35:00 UTC"
  }
]
```

### Sample Response for Recent Weeks

```
[
  {
    "firstName": "Jens",
    "lastName": "Dantorp",
    "past_weeks": [
      {
        "endDate": "2024-01-14",
        "positionDisplay": "59",
        "positionScaling": 0.016666668,
        "tournamentId": "857",
        "weeksAgo": 2
      },
      {
        "endDate": "2024-01-21",
        "positionDisplay": "125",
        "positionScaling": 0.007936508,
        "tournamentId": "858",
        "weeksAgo": 1
      },
      {
        "endDate": "2024-01-28",
        "positionDisplay": "T119",
        "positionScaling": 0.10526316,
        "tournamentId": "862",
        "weeksAgo": 0
      }
    ],
    "playerCountry": "SWE",
    "playerId": "102",
    "playerName": "Jens Dantorp",
    "teamId": 38
  },
  {
    "firstName": "Adrian",
    "lastName": "Otaegui",
    "past_weeks": [
      {
        "endDate": "2024-01-14",
        "positionDisplay": "T20",
        "positionScaling": 0.6666667,
        "tournamentId": "857",
        "weeksAgo": 2
      },
      {
        "endDate": "2024-01-21",
        "positionDisplay": "T56",
        "positionScaling": 0.5555556,
        "tournamentId": "858",
        "weeksAgo": 1
      },
      {
        "endDate": "2024-01-28",
        "positionDisplay": "T90",
        "positionScaling": 0.32330826,
        "tournamentId": "862",
        "weeksAgo": 0
      }
    ],
    "playerCountry": "ESP",
    "playerId": "103",
    "playerName": "Adrian Otaegui",
    "teamId": 23
  }
]
```

### Sample Response for Tournament Results

```
[
  {
    "past": [
      {
        "R1": "-4",
        "R2": "-5",
        "R3": "-3",
        "R4": "+4",
        "endDate": "2023-11-19",
        "position": "T27",
        "score": "-8",
        "totalSG": -0.9799999999999995,
        "tournament": "DP World Tour Championship",
        "tournamentId": "705",
        "tournament_year": 2023
      }
    ],
    "playerCountry": "SWE",
    "playerId": "102",
    "playerName": "Jens Dantorp",
    "teamId": 38
  },
  {
    "past": [
      {
        "R1": "-1",
        "R2": "-4",
        "R3": "E",
        "R4": "-1",
        "endDate": "2021-03-28",
        "position": "T16",
        "score": "-6",
        "totalSG": 2.2399999999999998,
        "tournament": "WGC - Dell Technologies Match Play",
        "tournamentId": "524",
        "tournament_year": 2021
      },
      {
        "R1": "-1",
        "R2": "-4",
        "R3": "E",
        "R4": "-1",
        "endDate": "2022-11-20",
        "position": "T16",
        "score": "-6",
        "totalSG": 2.2399999999999998,
        "tournament": "DP World Tour Championship",
        "tournamentId": "524",
        "tournament_year": 2022
      },
      {
        "R1": "-1",
        "R2": "E",
        "R3": "-4",
        "R4": "-6",
        "endDate": "2023-11-19",
        "position": "T18",
        "score": "-11",
        "totalSG": 2.0199999999999996,
        "tournament": "DP World Tour Championship",
        "tournamentId": "705",
        "tournament_year": 2023
      }
    ],
    "playerCountry": "ESP",
    "playerId": "103",
    "playerName": "Adrian Otaegui",
    "teamId": 23
  },
  {
    "past": [
      {
        "R1": "-2",
        "R2": "E",
        "R3": "-3",
        "R4": "-2",
        "endDate": "2021-11-21",
        "position": "T27",
        "score": "-7",
        "totalSG": 2.220446049250313e-16,
        "tournament": "DP WORLD TOUR CHAMPIONSHIP, DUBAI",
        "tournamentId": "411",
        "tournament_year": 2021
      },
      {
        "R1": "-4",
        "R2": "-2",
        "R3": "-4",
        "R4": "-3",
        "endDate": "2021-03-28",
        "position": "T5",
        "score": "-13",
        "totalSG": 9.239999999999998,
        "tournament": "WGC - Dell Technologies Match Play",
        "tournamentId": "524",
        "tournament_year": 2021
      },
      {
        "R1": "-4",
        "R2": "-2",
        "R3": "-4",
        "R4": "-3",
        "endDate": "2022-11-20",
        "position": "T5",
        "score": "-13",
        "totalSG": 9.239999999999998,
        "tournament": "DP World Tour Championship",
        "tournamentId": "524",
        "tournament_year": 2022
      },
      {
        "R1": "-3",
        "R2": "-6",
        "R3": "-6",
        "R4": "-4",
        "endDate": "2023-11-19",
        "position": "T2",
        "score": "-19",
        "totalSG": 10.02,
        "tournament": "DP World Tour Championship",
        "tournamentId": "705",
        "tournament_year": 2023
      }
    ],
    "playerCountry": "ENG",
    "playerId": "12",
    "playerName": "Tommy Fleetwood",
    "teamId": 4
  }
]
```
