# Course Fingerprints

## **Endpoint URLs**

`https://dde-api.data.srarena.io/golf/course_fingerprints/{request_type}/{external_coursew_id}`

**URL Sample:**

`https://dde-api.data.srarena.io/golf/course_fingerprints/course_difficulty/ET-1553`

`https://dde-api.data.srarena.io/golf/course_fingerprints/course_fingerprint/ET-1553`

`https://dde-api.data.srarena.io/golf/course_fingerprints/numbers_to_know/ET-1553`

`https://dde-api.data.srarena.io/golf/course_fingerprints/three_categories/ET-1553`

`https://dde-api.data.srarena.io/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"
      }
    ]
  }
]
```


---

# 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/course-fingerprints.md?ask=<question>
```

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.