Docs
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.

⏱️

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:

Attribute

Parent Element

Type

Description

abbr_name

player

String

Abbreviated name of a player
ex. R.McIlroy

amateur

player

Boolean

Signifies a player is in amateur status when true

country

player

String

Country of a player
ex. NORTHERN IRELAND

first_name

player

String

First name of a player
ex. Rory

id

player

GUID

Unique player ID
ex. da226913-b804-48de-adbf-96e956eb75ac

last_name

player

String

Last name of a player
ex. McIlroy

status

player

String

Status 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:

Attribute

Parent Element

Type

Description

course_timezone

tournament

String

Timezone of a course
ex. America/New_York

coverage

tournament

String

Coverage of a tournament. Click *here for a complete breakdown of our tour coverage.
ex. full

cut_round

tournament

Integer

Round number in which the cut is made

cutline

tournament

Integer

Cut line for a tournament (score a player must shoot to remain in the tournament)
ex. -2

currency

tournament

String

Prize money currency type of a tournament
ex. USD

end_date

tournament

dateTime

End date of a tournament in local course time

ex. 2022-11-20

event_type

tournament

dateTime

Scoring type of a tournament
stroke, match, cup, team, mix

id

tournament

GUID

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

name

tournament

String

Name of a tournament
ex. Wells Fargo Championship

points

tournament

Integer

Total number of FedEX Cup points for a tournament

projected_cutline

tournament

Integer

Projected cut line for an in progress tournament (score a player must shoot to remain in the tournament)
ex. -2

purse

tournament

Float

Total prize money for a tournament
ex. 15000000.0

scoring_system

tournament

String

Scoring system for a tournament
stroke, stableford

start_date

tournament

dateTime

Start date of a tournament in local course time

ex. 2022-11-20

status

tournament

GUID

Status of a tournament
scheduled, inprogress, delayed, cancelled, created, complete, closed, playoff, reopened

parent_id

tournament

GUID

Unique 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_share

tournament

Float

Prize money for first place in a tournament
ex. 1080000.0

Language
Credentials
Header
Click Try It! to start a request and see the response here!