GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Tournament Leaderboard

Provides a real-time leaderboard position for a given tournament, including player statistics at tournament and per-round level.

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

Leaderboard & Summary
AttributeParent ElementTypeDescription
positiontournament - leaderboard - playerShortLeaderboard position for a player
lossestournament - leaderboard - playerIntegerNumber of player losses in match play
moneytournament - leaderboard - playerFloatTournament money won (in US dollars) for a player
scoretournament - leaderboard - playerIntegerOverall player score in a tournament or playoff

ex. -10
pointstournament - leaderboard - playerFloatFedEx points earned for a player in a tournament
starting_scoretournament - leaderboard - playerIntegerThe pre-tournament starting score for a player in a tournament. Used in the Tour Championship.

ex. -4
strokestournament - leaderboard - playerShortOverall player strokes in a tournament or playoff
tiedtournament - leaderboard - playerBooleanSignifies a tie for a leaderboard spot
winstournament - leaderboard - playerIntegerNumber of player wins in match play
birdiestournament - leaderboard - player - roundIntegerNumber of birdies for a player in a tournament round
bogeystournament - leaderboard - player - roundIntegerNumber of bogeys for a player in a tournament round
double_bogeystournament - leaderboard - player - roundIntegerNumber of double bogeys for a player in a tournament round
eaglestournament - leaderboard - player - roundIntegerNumber of eagles for a player in a tournament round
thrutournament - leaderboard - player - roundIntegerNumber of holes completed for a player in a tournament round
holes_in_onetournament - leaderboard - player - roundIntegerNumber of holes in one for a player in a tournament round
other_scorestournament - leaderboard - player - roundIntegerNumber of other scores for a player in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
parstournament - leaderboard - player - roundIntegerNumber of pars for a player in a tournament round
sequencetournament - leaderboard - player - roundIntegerTournament round number
scoretournament - leaderboard - player - roundIntegerPlayer score in a round

ex. -4
strokestournament - leaderboard - player - roundShortPlayer strokes in a round

ex. 68
partpartIntegerSequential number of a tournament section/part. Used only in mix format events.

ex. 1 or 2
statuspartStringStatus of a tournament section/part. Used only in mix format events.

ex. inprogress or closed
typepartStringType of a tournament section/part. Used only in mix format events.

ex. stroke or match
Match & Cup Event Scoring
AttributeParent ElementTypeDescription
birdiestournament - leaderboard - player - matchIntegerNumber of birdies for a player in a match
bogeystournament - leaderboard - player - matchIntegerNumber of bogeys for a player in a match
double_bogeystournament - leaderboard - player - matchIntegerNumber of double bogeys for a player in a match
eaglestournament - leaderboard - player - matchIntegerNumber of eagles for a player in a match
holes_in_onetournament - leaderboard - player - matchIntegerNumber of holes in one for a player in a match
other_scorestournament - leaderboard - player - matchIntegerNumber of other scores for a player in a match (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
parstournament - leaderboard - player - matchIntegerNumber of pars for a player in a match
scoretournament - leaderboard - player - matchIntegerPlayer score in a match

ex. -4
thrutournament - leaderboard - player - matchIntegerNumber of holes completed for a player in a match
unplayedtournament - leaderboard - player - matchIntegerNumber of holes unplayed in a match
Match
AttributeParent ElementTypeDescription
idmatchGUIDUnique ID of a match

ex. 09a5bbfd-595b-4c83-b803-6f0b78679ae1
sequencematchIntegerSequence number of a match within a tournament
statusmatchStringStatus of a match

ex. inprogress, closed
titlematchStringTitle of a match

ex. Round 4 Match 8
match_typematchStringType of a match

regular, semifinal, championship, consolation
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. R.McIlroy
amateurplayerBooleanSignifies that a player is in amateur status when true
countryplayerStringCountry of a player

ex. NORTHERN IRELAND
first_nameplayerStringFirst name of a player

ex. Rory
idplayerGUIDUnique player ID

ex. da226913-b804-48de-adbf-96e956eb75ac
last_nameplayerStringLast name of a player

ex. McIlroy
statusplayerStringStatus of a player for a particular tournament

CUT, WD, MDF, DQ, DNS

See our Golf FAQ for more info and definitions of each status
Team
AttributeParent ElementTypeDescription
aliasleaderboard - teamStringAlias of a team

ex. EUR
idleaderboard - teamGUIDUnique ID of a team

ex. 450b30b7-c73c-4164-8439-6656c89c0e58
moneyleaderboard - teamFloatTournament money won (in US dollars) for a team
nameleaderboard - teamStringName of a team

ex. Europe or P.Cantlay/X.Schauffele
pointsleaderboard - teamDecimalFedEx points earned for a team in a tournament
positionleaderboard - teamIntegerLeaderboard position for a team
scoreleaderboard - teamDoubleOverall team score in a match or event

ex. -29 or 19.0
strokesleaderboard - teamShortOverall team strokes in a match or event
tiedleaderboard - teamBooleanSignifies a tie for a leaderboard spot
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
cut_roundtournamentIntegerRound number in which the cut is made
cutlinetournamentIntegerCut line for a tournament (score a player must shoot to remain in the tournament)

ex. -2
currencytournamentStringPrize money currency type of a tournament

ex. USD
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
idtournamentGUIDUnique ID of a tournament

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

ex. Wells Fargo Championship
pointstournamentIntegerTotal number of FedEx Cup points for a tournament
projected_cutlinetournamentIntegerProjected cut line for an in progress tournament (score a player must shoot to remain in the tournament)

ex. -2
pursetournamentFloatTotal prize money for a tournament

ex. 15000000.0
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