get https://api.sportradar.com/golf///v3///tournaments////scores.
Detailed round scoring including player information, course information, player scoring per hole, and overall tournament scoring per player.
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 |
strokes | course - scores - hole | Integer | Number of strokes on a hole for a player |
Match:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
back_nine | match | Boolean | Signifies the starting point of a match (back nine or front nine) |
match_format | match | String | Format of a matchsingles, fourball, foursomes |
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 matchregular, semifinal, championship, consolation |
tee_time | match | dateTime | Tee time of a match ex. 2022-03-23T14:31:00+00:00 |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr_name | scores - player | String | Abbreviated name of a player ex. R.McIlroy |
amateur | player | Boolean | Signifies a player is in amateur status when true |
country | scores - player | String | Country of a player ex. NORTHERN IRELAND |
first_name | scores - player | String | First name of a player ex. Rory |
id | scores - player | GUID | Unique player ID ex. da226913-b804-48de-adbf-96e956eb75ac |
last_name | scores - player | String | Last name of a player ex. McIlroy |
name | scores - player | String | Name of a player ex. McIlroy, Rory |
seed | scores - player | Integer | Seed number of a player |
Team:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | scores - team | GUID | Unique team ID ex. 450b30b7-c73c-4164-8439-6656c89c0e58 |
name | scores - team | String | Name of a team ex. Europe |
Round:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
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 |
Scoring:
Please note that data structure may differ depending on the match format (
match.match_format) of a round
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
birdies | round - player | Integer | Number of birdies in a tournament round |
bogeys | round - player | Integer | Number of bogeys in a tournament round |
double_bogeys | round - player | Integer | Number of double bogeys in a tournament round |
eagles | round - player | Integer | Number of eagles in a tournament round |
thru | round - player | Integer | Number of holes completed in a tournament round |
holes_in_one | round - player | Integer | Number of holes in one in a tournament round |
other_scores | round - player | Integer | Number of other scores in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys) |
pars | round - player | Integer | Number of pars in a tournament round |
score | round - player | Integer | Player score in a round ex. -4 |
starting_hole | round - player | Integer | Starting hole of a player within a round ex. 1 or 10 |
strokes | round - player | Integer | Player strokes in a round ex. 68 |
match_score | round - match - scores - team/player - hole | Integer | Score of a matchup after a finished hole ex. 3 or -3 |
outcome | round - match - scores - team/player - hole | String | Outcome of a hole matchuphalved, loss, win |
sequence | round - match - scores - team/player - hole | Integer | Sequence number of a hole matchup |
sequence | round - match - scores - team/player | Integer | Sequence number for a team/player within a matchup |
unplayed | round - match - scores - team/player - hole | Integer | Number of holes unplayed in a matchup |
number | round - player - scores - hole | Integer | Hole number (1-18) |
par | round - player - scores - hole | Integer | Par for a hole ex. 5 |
strokes | round - team/player - scores - hole | Integer | Number of strokes on a hole for a team/player |
yardage | round - player - scores - hole | Integer | Total yardage of a hole ex. 570 |
Team Scoring:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
birdies | round - team | Integer | Number of birdies in a tournament round |
bogeys | round - team | Integer | Number of bogeys in a tournament round |
double_bogeys | round - team | Integer | Number of double bogeys in a tournament round |
eagles | round - team | Integer | Number of eagles in a tournament round |
holes_in_one | round - team | Integer | Number of holes in one in a tournament round |
other_scores | round - team | Integer | Number of other scores in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys) |
pars | round - team | Integer | Number of pars in a tournament round |
score | round - team | Integer | Team score in a round ex. -4 |
status | round - team | String | Team status in a round ex. CUT, WD |
strokes | round - team | Integer | Team strokes in a round ex. 68 |
thru | round - team | Integer | Number of holes completed in a tournament round |
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 |
end_date | tournament | dateTime | End date of a tournament 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 |
purse | tournament | Float | Total prize money for a tournament ex. 15000000.0 |
currency | tournament | String | Prize money currency type of a tournament ex. USD |
scoring_system | tournament | String | Scoring system for a tournamentstroke, stableford |
start_date | tournament | dateTime | Start date of a tournament 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 |