get
https://api.sportradar.com/golf///v3///tournaments//summary.
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 FrequencyThis endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Tracking Live TournamentsLearn how to retrieve tournament context, fields, and round statuses during live play in our Tracking Live Tournaments integration scenario.
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 playerplayer, 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 roundfourball, 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 roundscheduled, 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, MistClick 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 tournamentstroke, 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 tournamentstroke, stableford |
start_date | tournament | dateTime | Start date of a tournament in local course time ex. 2022-11-20 |
status | tournament | GUID | Status of a tournamentscheduled, 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 |