Tournament Summary

get

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

Provides information for a given tournament by year, including location, course layout and tournament field.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
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

Attribute	Parent Element	Type	Description
`id`	`course`	GUID	Unique ID of a course ex. `7e9462a5-66ea-4205-b37a-81884e3653cf`
`name`	`course`	String	Name of a course ex. `Augusta National`
`par`	`course`	Integer	Par for a course ex. `72`
`yardage`	`course`	Integer	Total yardage of a course ex. `7510`
`number`	`course` - `holes` - `hole`	Integer	Hole number (1-18)
`par`	`course` - `holes` - `hole`	Integer	Par for a hole ex. `5`
`yardage`	`course` - `holes` - `hole`	Integer	Total yardage of a hole ex. `570`
`city`	`venue`	String	City of a course ex. `Augusta`
`country`	`venue`	String	Country of a course ex. `USA`
`id`	`venue`	GUID	Unique ID of a course ex. `d555598a-aed0-44fe-b659-4250264c7820`
`latitude`	`venue`	String	Latitude of a course ex. `33.50227066932358`
`longitude`	`venue`	String	Longitude of a course ex. `-82.02260614770309`
`name`	`venue`	String	Name of a course ex. `Augusta National Golf Club`
`state`	`venue`	String	State or province of a course ex. `GA`
`zipcode`	`venue`	Integer	ZIP code of a course ex. `30904`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`field` / `team` - `player`	String	Abbreviated name of a player ex. `R.McIlroy`
`amateur`	`player`	Boolean	Signifies that a player is in amateur status when `true`
`captains_pick`	`team` - `player`	Boolean	Signifies a player is a Captain's Pick (Ryder Cup)
`country`	`field` / `team` - `player`	String	Country of a player ex. `NORTHERN IRELAND`
`first_name`	`field` / `team` - `player`	String	First name of a player ex. `Rory`
`id`	`field` / `team` - `player`	GUID	Unique player ID ex. `da226913-b804-48de-adbf-96e956eb75ac`
`last_name`	`field` / `team` - `player`	String	Last name of a player ex. `McIlroy`
`role`	`team` - `player`	Integer	Role of a player `player`, `captain`, `vice-captain`, `assistant`
`seed`	`field` / `team` - `player`	Integer	Seed number of a player

Team

Attribute	Parent Element	Type	Description
`alias`	`teams` - `team`	String	Alias of a team ex. `EUR`
`id`	`teams` - `team`	GUID	Unique ID of a team ex. `450b30b7-c73c-4164-8439-6656c89c0e58`
`name`	`teams` - `team`	String	Name of a team ex. `Europe` or `P.Cantlay/X.Schauffele`

Round

Attribute	Parent Element	Type	Description
`format`	`round`	GUID	Format of a round `fourball`, `foursomes`, `singles`
`id`	`round`	GUID	Unique ID of a round ex. `56983b8a-92e6-40b1-8c53-1b38857d712b`
`number`	`round`	GUID	Number of a round
`status`	`round`	GUID	Status of a round `scheduled`, `inprogress`, `delayed`, `suspended`, `cancelled`, `complete`, `closed`, `reopened`

Broadcast

Attribute	Parent Element	Type	Description
`cable`	`round` - `broadcast`	String	Name of an round's broadcast cable station
`end_at`	`round` - `broadcast`	dateTime	End time of a broadcast ex. `2022-04-07T23:30:00+00:00`
`internet`	`round` - `broadcast`	String	Name of a round's internet stream ex. `Masters.com`
`network`	`round` - `broadcast`	String	Name of a round's broadcast network ex. `ESPN`
`radio`	`round` - `broadcast`	String	Name of the round's broadcast radio station
`satellite`	`round` - `broadcast`	String	Name of the round's broadcast satellite station ex. `206`
`start_at`	`round` - `broadcast`	dateTime	Start time of a broadcast ex. `2022-04-07T19:00:00+00:00`

Weather

Attribute	Parent Element	Type	Description
`temp`	`round` - `weather`	String	Temperature of a round in Fahrenheit
`condition`	`round` - `weather`	String	Forecasted weather condition of a round ex. `Partly cloudy`, `Clear`, `Light Rain, Mist` Click here for more info on weather condition values
`direction`	`round` - `weather` - `wind`	String	Direction of wind in the round ex. `W`
`speed`	`round` - `weather` - `wind`	String	Wind speed in the round in miles per hour ex. `12`

Season

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique ID of a season ex. `ece9907c-6fe3-4944-8cb9-bb1033270259`
`year`	`season`	GUID	Year of a tour season

Tour

Attribute	Parent Element	Type	Description
`alias`	`season` - `tour`	String	Alias of a tour ex. `pga`
`id`	`season` - `tour`	GUID	Unique ID of a tour ex. `b52068af-28e4-4e91-bdbb-037591b0ff84`
`name`	`season` - `tour`	String	Name of a tour ex. `PGA Tour`

Tournament

Attribute	Parent Element	Type	Description
`id`	`brackets` - `bracket`	GUID	Unique ID of a bracket grouping ex. `64208c73-d620-426c-b0b6-88d4b6d0d499`
`name`	`brackets` - `bracket`	String	Name of a bracket grouping ex. `Group 11`
`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`
`points`	`tournament`	Integer	Total number of FedEx Cup points for a tournament
`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`
`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`

Summary

Attribute	Parent Element	Type	Description
`part`	`summary`	Integer	Sequential number of a tournament section/part. Used only in mix format events. ex. `1` or `2`
`status`	`summary`	String	Status of a tournament section/part. Used only in mix format events. ex. `inprogress` or `closed`
`type`	`summary`	String	Type of a tournament section/part. Used only in mix format events. ex. `stroke` or `match`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

golf_tour

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)

language_code

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:

season_year

string

enum

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

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json