Tournament Leaderboard

get https://api.sportradar.com/golf/{access_level}/{golf_tour}/v3/{language_code}/{season_year}/tournaments/{tournament_id}/leaderboard.{format}

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:

Attribute	Parent Element	Type	Description
`position`	`tournament` - `leaderboard` - `player`	Short	Leaderboard position for a player
`losses`	`tournament` - `leaderboard` - `player`	Integer	Number of player losses in match play
`money`	`tournament` - `leaderboard` - `player`	Float	Tournament money won (in US dollars) for a player
`score`	`tournament` - `leaderboard` - `player`	Integer	Overall player score in a tournament or playoff ex. `-10`
`points`	`tournament` - `leaderboard` - `player`	Float	FedEX points earned for a player in a tournament
`starting_score`	`tournament` - `leaderboard` - `player`	Integer	The pre-tournament starting score for a player in a tournament. Used in the Tour Championship. ex. `-4`
`strokes`	`tournament` - `leaderboard` - `player`	Short	Overall player strokes in a tournament or playoff
`tied`	`tournament` - `leaderboard` - `player`	Boolean	Signifies a tie for a leaderboard spot
`wins`	`tournament` - `leaderboard` - `player`	Integer	Number of player wins in match play
`birdies`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of birdies for a player in a tournament round
`bogeys`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of bogeys for a player in a tournament round
`double_bogeys`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of double bogeys for a player in a tournament round
`eagles`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of eagles for a player in a tournament round
`thru`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of holes completed for a player in a tournament round
`holes_in_one`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of holes in one for a player in a tournament round
`other_scores`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of other scores for a player in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
`pars`	`tournament` - `leaderboard` - `player` - `round`	Integer	Number of pars for a player in a tournament round
`sequence`	`tournament` - `leaderboard` - `player` - `round`	Integer	Tournament round number
`score`	`tournament` - `leaderboard` - `player` - `round`	Integer	Player score in a round ex. `-4`
`strokes`	`tournament` - `leaderboard` - `player` - `round`	Short	Player strokes in a round ex. `68`
`part`	`part`	Integer	Sequential number of a tournament section/part. Used only in mix format events. ex. `1` or `2`
`status`	`part`	String	Status of a tournament section/part. Used only in mix format events. ex. `inprogress` or `closed`
`type`	`part`	String	Type of a tournament section/part. Used only in mix format events. ex. `stroke` or `match`

Match & Cup Event Scoring:

Attribute	Parent Element	Type	Description
`birdies`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of birdies for a player in a match
`bogeys`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of bogeys for a player in a match
`double_bogeys`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of double bogeys for a player in a match
`eagles`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of eagles for a player in a match
`holes_in_one`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of holes in one for a player in a match
`other_scores`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of other scores for a player in a match (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
`pars`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of pars for a player in a match
`score`	`tournament` - `leaderboard` - `player` - `match`	Integer	Player score in a match ex. `-4`
`thru`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of holes completed for a player in a match
`unplayed`	`tournament` - `leaderboard` - `player` - `match`	Integer	Number of holes unplayed in a match

Match:

Attribute	Parent Element	Type	Description
`id`	`match`	GUID	Unique ID of a match ex. `09a5bbfd-595b-4c83-b803-6f0b78679ae1`
`sequence`	`match`	Integer	Sequence number of a match within a tournament
`status`	`match`	String	Status of a match ex. `inprogress`, `closed`
`title`	`match`	String	Title of a match ex. `Round 4 Match 8`
`match_type`	`match`	String	Type 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:

Attribute	Parent Element	Type	Description
`alias`	`leaderboard` - `team`	String	Alias of a team ex. `EUR`
`id`	`leaderboard` - `team`	GUID	Unique ID of a team ex. `450b30b7-c73c-4164-8439-6656c89c0e58`
`money`	`leaderboard` - `team`	Float	Tournament money won (in US dollars) for a team
`name`	`leaderboard` - `team`	String	Name of a team ex. `Europe` or `P.Cantlay/X.Schauffele`
`points`	`leaderboard` - `team`	Decimal	FedEX points earned for a team in a tournament
`position`	`leaderboard` - `team`	Integer	Leaderboard position for a team
`score`	`leaderboard` - `team`	Double	Overall team score in a match or event ex. `-29` or `19.0`
`strokes`	`leaderboard` - `team`	Short	Overall team strokes in a match or event
`tied`	`leaderboard` - `team`	Boolean	Signifies 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 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 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`

Path Params

access_level

string

required

Defaults to trial

The access level of your API key

trial, production

golf_tour

string

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)

language_code

string

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), en (English), es (Spanish), fi (Finnish), fr (French), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), no (Norwegian), se (Swedish), zh (Chinese - simplified), zht (Chinese - traditional)

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

season_year

string

required

Defaults to 2025

Year of the tour season

tournament_id

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

format

string

required

Defaults to json

Format returned

json, xml

Response

⏱️Update Frequency

Data Points

200200

⏱️
Update Frequency