GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Tournament Hole Statistics

Detailed information on how the field fared on each hole for a given tournament.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.


Data Points

Course
AttributeParent ElementTypeDescription
idcourseGUIDUnique ID of a course

ex. 7e9462a5-66ea-4205-b37a-81884e3653cf
namecourseStringName of a course

ex. Augusta National
parcourseIntegerPar for a course

ex. 72
yardagecourseIntegerTotal yardage of a course

ex. 7510
Hole Statistics
AttributeParent ElementTypeDescription
avg_diffholeDecimalAverage difference above or below par which a hole played in a tournament

ex. -0.12 or 0.17
birdiesholeIntegerNumber of total birdies on a hole in a tournament round
bogeysholeIntegerNumber of total bogeys on a hole in a tournament round
double_bogeysholeIntegerNumber of total double bogeys on a hole in a tournament round
eaglesholeIntegerNumber of total eagles on a hole in a tournament round
holes_in_oneholeIntegerNumber of total holes in one on a hole in a tournament round
numberholeIntegerHole number (1-18)
playersholeIntegerNumber of total players on a hole in a tournament round
other_scoresholeIntegerNumber of total other scores on a hole in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
parholeIntegerPar for a hole

ex. 4
parsholeIntegerNumber of total pars on a hole in a tournament round
sequenceholeIntegerSequence number of a hole
strokesholeIntegerNumber of total strokes on a hole in a tournament round
strokes_avgholeDecimalAverage number of strokes on a hole in a tournament round
Round
AttributeParent ElementTypeDescription
idroundGUIDUnique ID of a round

ex. 56983b8a-92e6-40b1-8c53-1b38857d712b
numberroundGUIDNumber of a round
statusroundGUIDStatus of a round

scheduled, inprogress, delayed, suspended, cancelled, complete, closed, reopened
Tournament
AttributeParent ElementTypeDescription
course_timezonetournamentStringTimezone of a course

ex. America/New_York
coveragetournamentStringCoverage of a tournament. Click here for a complete breakdown of our tour coverage.

ex. full
end_datetournamentdateTimeEnd date of a tournament in local course time

ex. 2022-11-20
event_typetournamentdateTimeScoring type of a tournament

stroke, match, cup, team, mix
pointstournamentIntegerTotal number of FedEx Cup points for a tournament
idtournamentGUIDUnique ID of a tournament

ex. 42b7bbc2-858a-4c0d-85dc-b30179bb5e9a
nametournamentStringName of a tournament

ex. Wells Fargo Championship
pursetournamentFloatTotal prize money for a tournament

ex. 15000000.0
currencytournamentStringPrize money currency type of a tournament

ex. USD
scoring_systemtournamentStringScoring system for a tournament

stroke, stableford
start_datetournamentdateTimeStart date of a tournament in local course time

ex. 2022-11-20
statustournamentGUIDStatus of a tournament

scheduled, inprogress, delayed, cancelled, created, complete, closed, playoff, reopened
parent_idtournamentGUIDUnique parent ID for a tournament. Use this ID to tie reoccurring events across seasons.

ex. 5c8d8f92-8da7-4d5d-860b-e820d57ff640 (ID for The Masters)
winning_sharetournamentFloatPrize money for first place in a tournament

ex. 1080000.0
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to pga

Golf tour

champ (PGA Tour Champions), euro (PGA European Tour), liv (LIV Golf), lpga (LPGA), oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour), usga (USGA *2019 season only)

string
enum
required
Defaults to en

2-letter code for supported languages

da (Danish), de (German), en (English), es (Spanish), ko (Korean)

Click here for a tabular list of available languages per competition.

Allowed:
string
enum
required
Defaults to 2025

Year of the tour season

string
required
Defaults to 2cba1945-dc1c-4131-92f4-cfdac8c45060

Unique Id of a tournament, found in the Tournament Schedule endpoint

Example: 2cba1945-dc1c-4131-92f4-cfdac8c45060

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json