# Course Fingerprints

## **Endpoint URLs**

`https://dde-api.data.imgarena.com/golf/course_fingerprints/{request_type}/{external_coursew_id}`

**URL Sample:**

`https://dde-api.data.imgarena.com/golf/course_fingerprints/course_difficulty/ET-1553`

`https://dde-api.data.imgarena.com/golf/course_fingerprints/course_fingerprint/ET-1553`

`https://dde-api.data.imgarena.com/golf/course_fingerprints/numbers_to_know/ET-1553`

`https://dde-api.data.imgarena.com/golf/course_fingerprints/three_categories/ET-1553`

`https://dde-api.data.imgarena.com/golf/course_fingerprints/winner_data/ET-1553`<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:**

*course\_difficulty*

*course\_fingerprint*

*numbers\_to\_know*

*three\_categories*

*winner\_data*

**External Course ID**

### Response Model

**Covers all request types**

<table data-header-hidden><thead><tr><th>Field Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Field Name</td><td>Type</td><td>Description</td></tr><tr><td>APP</td><td>array</td><td>Approach Shot SG value within an array from 0 to 10</td></tr><tr><td>ARG</td><td>array</td><td>Around the Green SG Shot value within an array from 0 to 10</td></tr><tr><td>OTT</td><td>array</td><td>Off The Tee SG Shot value within an array from 0 to 10</td></tr><tr><td>PUT</td><td>array</td><td>Putting Shot SG value within an array from 0 to 10</td></tr><tr><td>TOT</td><td>array</td><td>Total SG Shot value within an array from 0 to 10</td></tr><tr><td>external_course_id</td><td>string</td><td>External Tournament ID identifier String, covering DPWT, PGA Tour, Other Golf Tours</td></tr><tr><td>stat_name</td><td>string</td><td><p>course oriented stat name e.g. :</p><pre class="language-json"><code class="lang-json">absolute_slope_x
around_the_green_gsg_difficulty
birdie_chance_inside_10ft
Average approach shot distance (yards)
Green in regulation %
</code></pre></td></tr><tr><td>outOf10</td><td>float</td><td>score from 0 to 10</td></tr><tr><td>stat_average</td><td>float</td><td>average score for the stat in question (ranges in scale)</td></tr><tr><td>rank</td><td>int</td><td>the rank and importance of this stat in relation to the course</td></tr><tr><td>stat_value</td><td>float</td><td>the stat value score on this course</td></tr><tr><td>direction</td><td>string</td><td>an indication of acute context, e.g. hillier, easier, elevation</td></tr><tr><td>average_of_all_courses</td><td>float</td><td>the stat value score average across multiple courses</td></tr><tr><td>comment</td><td>string</td><td>an elaboration on stat_name</td></tr><tr><td>percentageScore</td><td>float</td><td>Average performance on this stat measured by percentages</td></tr><tr><td>playerId</td><td>string</td><td>The internal ID of the Player of the current event</td></tr><tr><td>firstName</td><td>string</td><td>The first name of the player</td></tr><tr><td>lastName</td><td>string</td><td>The surname of the player</td></tr><tr><td>americanodds</td><td>string</td><td>American MoneyLine odds format e.g +2800</td></tr><tr><td>averageWinningScore</td><td>float</td><td>average winning score</td></tr><tr><td>percentagePlayoffs</td><td>float</td><td>Number of play offs this person has had here</td></tr><tr><td>percentageShorter</td><td>float</td><td>Percentage of shorter scores</td></tr><tr><td>tournaments</td><td>int</td><td>Number of tournaments played</td></tr><tr><td>standings_toPar_displayValue</td><td>Number</td><td>variance on standings to Par display e.g. -21</td></tr><tr><td>tournament_year</td><td>int</td><td>Year of tournament (YYYY) e.g. 2022</td></tr><tr><td>winningMargin</td><td>string</td><td>e.g. 2 strokes</td></tr></tbody></table>

### Sample Response for Course Difficulty

```

  {
    "APP": {
      "outOf10": 2.1538461538461537
    },
    "ARG": {
      "outOf10": 4.769230769230769
    },
    "OTT": {
      "outOf10": 4.153846153846154
    },
    "PUT": {
      "outOf10": 3.3076923076923075
    },
    "TOT": {
      "outOf10": 3.5384615384615383
    },
    "external_course_id": "ET-1553"
  }
]
```

### Sample Response for Course Fingerprint

```
[
  {
    "external_course_id": "ET-1553",
    "stats": [
      {
        "stat_name": "absolute_slope_x",
        "values": {
          "outOf10": "8.846153846153845",
          "stat_average": "0.0035148266536710357"
        }
      },
      {
        "stat_name": "absolute_slope_y",
        "values": {
          "outOf10": "7.076923076923077",
          "stat_average": "0.003963628422724988"
        }
      },
      {
        "stat_name": "altitude_in_feet",
        "values": {
          "outOf10": "7.0",
          "stat_average": "28.23680848043165"
        }
      },
      {
        "stat_name": "approach_gsg_difficulty",
        "values": {
          "outOf10": "2.1538461538461537",
          "stat_average": "0.06969603810630402"
        }
      },
      {
        "stat_name": "around_the_green_gsg_difficulty",
        "values": {
          "outOf10": "4.769230769230769",
          "stat_average": "0.06980111963818746"
        }
      },
      {
        "stat_name": "average_approach_shot",
        "values": {
          "outOf10": "8.0",
          "stat_average": "189.85738576119988"
        }
      },
      {
        "stat_name": "average_driving_distance",
        "values": {
          "outOf10": "3.4615384615384617",
          "stat_average": "296.7888611130697"
        }
      },
      {
        "stat_name": "birdie_chance_inside_10ft",
        "values": {
          "outOf10": "3.769230769230769",
          "stat_average": "0.21908305839518766"
        }
      },
      {
        "stat_name": "birdie_chance_inside_20ft",
        "values": {
          "outOf10": "3.3846153846153846",
          "stat_average": "0.4205938029765444"
        }
      },
      {
        "stat_name": "birdie_or_better_average",
        "values": {
          "outOf10": "3.846153846153846",
          "stat_average": "0.23791889795504279"
        }
      },
      {
        "stat_name": "bogey_or_worse_average",
        "values": {
          "outOf10": "4.3076923076923075",
          "stat_average": "0.1367226764087517"
        }
      },
      {
        "stat_name": "double_or_worse_average",
        "values": {
          "outOf10": "2.5384615384615388",
          "stat_average": "0.011024423998713022"
        }
      },
      {
        "stat_name": "driver_hit_average",
        "values": {
          "outOf10": "4.428571428571429",
          "stat_average": "0.8042703488598812"
        }
      },
      {
        "stat_name": "eagle_average",
        "values": {
          "outOf10": "4.923076923076923",
          "stat_average": "0.006570205161474597"
        }
      },
      {
        "stat_name": "elevation_change",
        "values": {
          "outOf10": "7.538461538461538",
          "stat_average": "7.530984604514016"
        }
      },
      {
        "stat_name": "extra_feet_distance_elevation",
        "values": {
          "outOf10": "7.0",
          "stat_average": "0.5109453344747463"
        }
      },
      {
        "stat_name": "fairway_hit_average",
        "values": {
          "outOf10": "3.769230769230769",
          "stat_average": "0.6052046865567015"
        }
      },
      {
        "stat_name": "go_for_green_average",
        "values": {
          "outOf10": "5.6923076923076925",
          "stat_average": "0.18478914258151685"
        }
      },
      {
        "stat_name": "go_for_green_sum",
        "values": {
          "outOf10": "8.0",
          "stat_average": "9.108223743469646"
        }
      },
      {
        "stat_name": "green_in_regulation_average",
        "values": {
          "outOf10": "2.5384615384615388",
          "stat_average": "0.7396010938926597"
        }
      },
      {
        "stat_name": "green_size",
        "values": {
          "outOf10": "5.0",
          "stat_average": "7107.858457746012"
        }
      },
      {
        "stat_name": "green_under_regulation_average",
        "values": {
          "outOf10": "4.923076923076923",
          "stat_average": "0.02412365855240047"
        }
      },
      {
        "stat_name": "greenside_bunkers_found_average",
        "values": {
          "outOf10": "5.307692307692308",
          "stat_average": "0.07497828380028018"
        }
      },
      {
        "stat_name": "hole_wind_impact_mph",
        "values": {
          "outOf10": "4.0",
          "stat_average": "6.579755849297505"
        }
      },
      {
        "stat_name": "median_proximity",
        "values": {
          "outOf10": "3.3846153846153846",
          "stat_average": "26.417091641573393"
        }
      },
      {
        "stat_name": "miss_fairway_penalty",
        "values": {
          "outOf10": "5.384615384615385",
          "stat_average": "0.3816926874724374"
        }
      },
      {
        "stat_name": "obstructed_stroke_sum",
        "values": {
          "outOf10": "3.0",
          "stat_average": "2.206431745568368"
        }
      },
      {
        "stat_name": "off_the_tee_gsg_difficulty",
        "values": {
          "outOf10": "4.153846153846154",
          "stat_average": "-0.019345163034511798"
        }
      },
      {
        "stat_name": "over_2percent_break",
        "values": {
          "outOf10": "4.923076923076923",
          "stat_average": "0.00047815528008778014"
        }
      },
      {
        "stat_name": "par_3_scoring",
        "values": {
          "outOf10": "4.3076923076923075",
          "stat_average": "3.032680023076923"
        }
      },
      {
        "stat_name": "par_4_scoring",
        "values": {
          "outOf10": "2.8461538461538463",
          "stat_average": "3.9551667944230773"
        }
      },
      {
        "stat_name": "par_5_scoring",
        "values": {
          "outOf10": "4.846153846153847",
          "stat_average": "4.654170808447414"
        }
      },
      {
        "stat_name": "players",
        "values": {
          "outOf10": "9.307692307692307",
          "stat_average": "50.600311850311854"
        }
      },
      {
        "stat_name": "putting_gsg_difficulty",
        "values": {
          "outOf10": "3.3846153846153846",
          "stat_average": "0.012073019888329055"
        }
      },
      {
        "stat_name": "sand_save_average",
        "values": {
          "outOf10": "6.3076923076923075",
          "stat_average": "0.4605773025672481"
        }
      },
      {
        "stat_name": "score_average",
        "values": {
          "outOf10": "4.846153846153847",
          "stat_average": "3.926212111343111"
        }
      },
      {
        "stat_name": "scrambling_average",
        "values": {
          "outOf10": "4.230769230769231",
          "stat_average": "0.5905436633680246"
        }
      },
      {
        "stat_name": "three_putt_average",
        "values": {
          "outOf10": "7.0",
          "stat_average": "0.03682390979820924"
        }
      },
      {
        "stat_name": "total_penalty_sum",
        "values": {
          "outOf10": "5.0769230769230775",
          "stat_average": "0.49085376754131904"
        }
      },
      {
        "stat_name": "tree_fairway_obstruction",
        "values": {
          "outOf10": "4.230769230769231",
          "stat_average": "0.08331663093104864"
        }
      },
      {
        "stat_name": "up_and_down_average",
        "values": {
          "outOf10": "5.153846153846154",
          "stat_average": "0.582369231643576"
        }
      },
      {
        "stat_name": "vspar_score_average",
        "values": {
          "outOf10": "3.5384615384615383",
          "stat_average": "-0.09567855760638173"
        }
      },
      {
        "stat_name": "water_fairway_obstruction",
        "values": {
          "outOf10": "4.0",
          "stat_average": "0.0028652461402400705"
        }
      },
      {
        "stat_name": "water_green_obstruction",
        "values": {
          "outOf10": "6.769230769230769",
          "stat_average": "0.029452268244073657"
        }
      },
      {
        "stat_name": "width_fairway_feet",
        "values": {
          "outOf10": "6.0",
          "stat_average": "66.59707431712137"
        }
      }
    ]
  }
]

```

### Sample Response for Numbers to Know

```
[
  {
    "external_course_id": "ET-1553",
    "stats": [
      {
        "rank": 1,
        "stat_name": "Average approach shot distance (yards)",
        "values": {
          "average_of_all_courses": "175.4",
          "comment": "approachShot",
          "direction": "longer",
          "stat_value": "189.9"
        }
      },
      {
        "rank": 2,
        "stat_name": "Green in regulation %",
        "values": {
          "average_of_all_courses": "66.0",
          "comment": "greenInRegulation",
          "direction": "easier",
          "stat_value": "73.9"
        }
      },
      {
        "rank": 3,
        "stat_name": "Average driving distance (yards)",
        "values": {
          "average_of_all_courses": "285.6",
          "comment": "drivingDistance",
          "direction": "longer",
          "stat_value": "296.8"
        }
      },
      {
        "rank": 4,
        "stat_name": "% of drives hitting driver",
        "values": {
          "average_of_all_courses": "75.1",
          "comment": "driverHit",
          "direction": "more",
          "stat_value": "80.4"
        }
      },
      {
        "rank": 5,
        "stat_name": "Average side break in putts",
        "values": {
          "average_of_all_courses": "0.6",
          "comment": "slope",
          "direction": "more",
          "stat_value": "1.0"
        }
      },
      {
        "rank": 6,
        "stat_name": "Driving accuracy %",
        "values": {
          "average_of_all_courses": "54.7",
          "comment": "fairwayHit",
          "direction": "easier",
          "stat_value": "60.5"
        }
      },
      {
        "rank": 7,
        "stat_name": "Par 4 scoring average",
        "values": {
          "average_of_all_courses": "4.06",
          "comment": "par4",
          "direction": "easier",
          "stat_value": "3.96"
        }
      },
      {
        "rank": 8,
        "stat_name": "Obstructed shots per round",
        "values": {
          "average_of_all_courses": "6.0",
          "comment": "obstructed",
          "direction": "less",
          "stat_value": "2.0"
        }
      },
      {
        "rank": 9,
        "stat_name": "% of holes with birdie or better",
        "values": {
          "average_of_all_courses": "20.4",
          "comment": "birdieOrBetter",
          "direction": "more",
          "stat_value": "23.7"
        }
      },
      {
        "rank": 10,
        "stat_name": "Proximity to pin (feet)",
        "values": {
          "average_of_all_courses": "29.1",
          "comment": "proximity",
          "direction": "closer",
          "stat_value": "26.4"
        }
      },
      {
        "rank": 11,
        "stat_name": "Average change in elevation (up or down) between tee and green",
        "values": {
          "average_of_all_courses": "15.1",
          "comment": "elevationChange",
          "direction": "hillier",
          "stat_value": "24.4"
        }
      },
      {
        "rank": 12,
        "stat_name": "Average score to par",
        "values": {
          "average_of_all_courses": "0.0",
          "comment": "vsParScore",
          "direction": "easier",
          "stat_value": "-0.1"
        }
      },
      {
        "rank": 13,
        "stat_name": "Penalties per round",
        "values": {
          "average_of_all_courses": "0.57",
          "comment": "penalty",
          "direction": "less",
          "stat_value": "0.49"
        }
      },
      {
        "rank": 14,
        "stat_name": "Three putt %",
        "values": {
          "average_of_all_courses": "3.0",
          "comment": "threePutt",
          "direction": "more",
          "stat_value": "3.59"
        }
      },
      {
        "rank": 15,
        "stat_name": "Average green size (sq ft)",
        "values": {
          "average_of_all_courses": "6020.0",
          "comment": "greenSize",
          "direction": "larger",
          "stat_value": "7110.0"
        }
      },
      {
        "rank": 16,
        "stat_name": "Scrambling %",
        "values": {
          "average_of_all_courses": "56.8",
          "comment": "scrambling",
          "direction": "easier",
          "stat_value": "59.0"
        }
      },
      {
        "rank": 17,
        "stat_name": "% of holes with bogey or worse",
        "values": {
          "average_of_all_courses": "18.4",
          "comment": "bogeyOrWorse",
          "direction": "less",
          "stat_value": "13.6"
        }
      },
      {
        "rank": 18,
        "stat_name": "Par 3 scoring average",
        "values": {
          "average_of_all_courses": "3.06",
          "comment": "par3",
          "direction": "easier",
          "stat_value": "3.03"
        }
      },
      {
        "rank": 19,
        "stat_name": "% of holes with eagle",
        "values": {
          "average_of_all_courses": "0.5",
          "comment": "eagles",
          "direction": "more",
          "stat_value": "0.6"
        }
      },
      {
        "rank": 20,
        "stat_name": "Sand save %",
        "values": {
          "average_of_all_courses": "48.0",
          "comment": "sand_save",
          "direction": "harder",
          "stat_value": "46.0"
        }
      },
      {
        "rank": 21,
        "stat_name": "Par 5 scoring average",
        "values": {
          "average_of_all_courses": "4.68",
          "comment": "par5",
          "direction": "easier",
          "stat_value": "4.65"
        }
      },
      {
        "rank": 22,
        "stat_name": "% of holes where players find GS Bunker",
        "values": {
          "average_of_all_courses": "7.39",
          "comment": "greensideBunkers",
          "direction": "more",
          "stat_value": "7.39"
        }
      },
      {
        "rank": 23,
        "stat_name": "Change in score between hitting and missing fairway",
        "values": {
          "average_of_all_courses": "0.38",
          "comment": "missFairwayPenalty",
          "direction": "smaller",
          "stat_value": "0.38"
        }
      }
    ]
  }
]
```

### Sample Response for Three Categories

```
[
  {
    "external_course_id": "ET-1553",
    "stats": [
      {
        "stat_name": "Difficulty of Hitting Fairway",
        "values": {
          "comment": "difficultyFairway",
          "direction": "more",
          "percentageScore": "0.3769230769230769"
        }
      },
      {
        "stat_name": "Difficulty of Hitting Green",
        "values": {
          "comment": "difficultyGreen",
          "direction": "more",
          "percentageScore": "0.2538461538461539"
        }
      },
      {
        "stat_name": "Difficulty of Short Game",
        "values": {
          "comment": "difficultyShortGame",
          "direction": "less",
          "percentageScore": "0.4230769230769231"
        }
      },
      {
        "stat_name": "Difficulty of Slope on Greens",
        "values": {
          "comment": "difficultySlope",
          "direction": "more",
          "percentageScore": "0.8846153846153845"
        }
      },
      {
        "stat_name": "Frequency of Birdie Putts",
        "values": {
          "comment": "freqBirdiePutts",
          "direction": "more",
          "percentageScore": "0.7"
        }
      },
      {
        "stat_name": "Frequency of Birdie or Better",
        "values": {
          "comment": "freqBirdieOrBetter",
          "direction": "more",
          "percentageScore": "0.7153846153846154"
        }
      },
      {
        "stat_name": "Frequency of Bogey or Worse",
        "values": {
          "comment": "freqBogeyOrWorse",
          "direction": "fewer",
          "percentageScore": "0.43076923076923074"
        }
      },
      {
        "stat_name": "Frequency of Going for Green",
        "values": {
          "comment": "freqGFG",
          "direction": "fewer",
          "percentageScore": "0.5"
        }
      },
      {
        "stat_name": "Frequency of Short Game Shots",
        "values": {
          "comment": "freqShortGame",
          "direction": "fewer",
          "percentageScore": "0.4"
        }
      },
      {
        "stat_name": "Frequency of Taking Penalties",
        "values": {
          "comment": "freqPenalty",
          "direction": "less",
          "percentageScore": "0.5076923076923078"
        }
      },
      {
        "stat_name": "Frequency of Three Putts",
        "values": {
          "comment": "freqThreePutts",
          "direction": "more",
          "percentageScore": "0.7"
        }
      },
      {
        "stat_name": "Importance Hitting Green",
        "values": {
          "comment": "importGreen",
          "direction": "more",
          "percentageScore": "0.6038461538461538"
        }
      },
      {
        "stat_name": "Importance of Hitting Fairway",
        "values": {
          "comment": "importFairway",
          "direction": "less",
          "percentageScore": "0.5384615384615385"
        }
      },
      {
        "stat_name": "Importance of Using Driver",
        "values": {
          "comment": "importDriver",
          "direction": "more",
          "percentageScore": "0.6571428571428573"
        }
      }
    ]
  }
]
```

### Sample Response for Winner Data

```
[
  {
    "external_course_id": "ET-1553",
    "stats": {
      "averageWinningScore": -19.333333333333332,
      "percentagePlayoffs": 0,
      "percentageShorter": 0.6666666666666666,
      "tournaments": 3
    },
    "winners": [
      {
        "americanOdds": "+2800",
        "firstName": "Nicolai",
        "lastName": "Højgaard",
        "playerId": "1799",
        "standings_toPar_displayValue": "-21",
        "tournament_year": 2023,
        "winningMargin": "2 strokes"
      },
      {
        "americanOdds": "+500",
        "firstName": "Jon",
        "lastName": "Rahm",
        "playerId": "493",
        "standings_toPar_displayValue": "-20",
        "tournament_year": 2022,
        "winningMargin": "2 strokes"
      },
      {
        "americanOdds": "+750",
        "firstName": "Collin",
        "lastName": "Morikawa",
        "playerId": "3378",
        "standings_toPar_displayValue": "-17",
        "tournament_year": 2021,
        "winningMargin": "3 strokes"
      }
    ]
  }
]
```