GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Scorecards Per Round

Detailed round scoring including player information, course information, player scoring per hole, and overall tournament scoring per player.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

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
AttributeParent ElementTypeDescription
idcourseGUIDUnique ID of a course

ex. 7e9462a5-66ea-4205-b37a-81884e3653cf
namecourseStringName of a course

ex. Augusta National
parcourseIntegerPar for a course

ex. 72
yardagecourseIntegerTotal yardage of a course

ex. 7510
numbercourse - holes - holeIntegerHole number (1-18)
parcourse - holes - holeIntegerPar for a hole

ex. 5
yardagecourse - holes - holeIntegerTotal yardage of a hole

ex. 570
strokescourse - scores - holeIntegerNumber of strokes on a hole for a player
Match
AttributeParent ElementTypeDescription
back_ninematchBooleanSignifies the starting point of a match (back nine or front nine)
match_formatmatchStringFormat of a match

singles, fourball, foursomes
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
tee_timematchdateTimeTee time of a match

ex. 2022-03-23T14:31:00+00:00
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. R.McIlroy
amateurplayerBooleanSignifies that a player is in amateur status when true
countryplayerStringCountry of a player

ex. NORTHERN IRELAND
first_nameplayerStringFirst name of a player

ex. Rory
idplayerGUIDUnique player ID

ex. da226913-b804-48de-adbf-96e956eb75ac
last_nameplayerStringLast name of a player

ex. McIlroy
nameplayerStringName of a player

ex. McIlroy, Rory
seedplayerIntegerSeed number of a player
Team
AttributeParent ElementTypeDescription
idscores - teamGUIDUnique team ID

ex. 450b30b7-c73c-4164-8439-6656c89c0e58
namescores - teamStringName of a team

ex. Europe
Round
AttributeParent ElementTypeDescription
idroundGUIDUnique ID of a round

ex. 56983b8a-92e6-40b1-8c53-1b38857d712b
numberroundGUIDNumber of a round
statusroundGUIDStatus of a round

scheduled, 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

AttributeParent ElementTypeDescription
birdiesround - playerIntegerNumber of birdies in a tournament round
bogeysround - playerIntegerNumber of bogeys in a tournament round
created_atround - playerStringTimestamp of a player's tee time addition to the Scorecard endpoint.

ex. 2025-02-25T17:41:22+00:00
double_bogeysround - playerIntegerNumber of double bogeys in a tournament round
eaglesround - playerIntegerNumber of eagles in a tournament round
thruround - playerIntegerNumber of holes completed in a tournament round
holes_in_oneround - playerIntegerNumber of holes in one in a tournament round
other_scoresround - playerIntegerNumber of other scores in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
parsround - playerIntegerNumber of pars in a tournament round
scoreround - playerIntegerPlayer score in a round

ex. -4
starting_holeround - playerIntegerStarting hole of a player within a round

ex. 1 or 10
strokesround - playerIntegerPlayer strokes in a round

ex. 68
match_scoreround - match - scores - team/player - holeIntegerScore of a matchup after a finished hole

ex. 3 or -3
outcomeround - match - scores - team/player - holeStringOutcome of a hole matchup

halved, loss, win
sequenceround - match - scores - team/player - holeIntegerSequence number of a hole matchup
sequenceround - match - scores - team/playerIntegerSequence number for a team/player within a matchup
unplayedround - match - scores - team/player - holeIntegerNumber of holes unplayed in a matchup
numberround - player - scores - holeIntegerHole number (1-18)
parround - player - scores - holeIntegerPar for a hole

ex. 5
strokesround - team/player - scores - holeIntegerNumber of strokes on a hole for a team/player
updated_atround - playerStringTimestamp of the most recent update to a player's round score

ex. 2025-02-28T15:06:32+00:00
yardageround - player - scores - holeIntegerTotal yardage of a hole

ex. 570
Team Scoring
AttributeParent ElementTypeDescription
birdiesround - teamIntegerNumber of birdies in a tournament round
bogeysround - teamIntegerNumber of bogeys in a tournament round
double_bogeysround - teamIntegerNumber of double bogeys in a tournament round
eaglesround - teamIntegerNumber of eagles in a tournament round
holes_in_oneround - teamIntegerNumber of holes in one in a tournament round
other_scoresround - teamIntegerNumber of other scores in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
parsround - teamIntegerNumber of pars in a tournament round
scoreround - teamIntegerTeam score in a round

ex. -4
statusround - teamStringTeam status in a round

ex. CUT, WD
strokesround - teamIntegerTeam strokes in a round

ex. 68
thruround - teamIntegerNumber of holes completed in a tournament round
Tournament
AttributeParent ElementTypeDescription
course_timezonetournamentStringTimezone of a course

ex. America/New_York
coveragetournamentStringCoverage of a tournament. Click here for a complete breakdown of our tour coverage.

ex. full
end_datetournamentdateTimeEnd date of a tournament in local course time

ex. 2022-11-20
event_typetournamentdateTimeScoring type of a tournament

stroke, match, cup, team, mix
pointstournamentIntegerTotal number of FedEx Cup points for a tournament
idtournamentGUIDUnique ID of a tournament

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

ex. Wells Fargo Championship
pursetournamentFloatTotal prize money for a tournament

ex. 15000000.0
currencytournamentStringPrize money currency type of a tournament

ex. USD
scoring_systemtournamentStringScoring system for a tournament

stroke, stableford
start_datetournamentdateTimeStart date of a tournament in local course time

ex. 2022-11-20
statustournamentGUIDStatus of a tournament

scheduled, inprogress, delayed, cancelled, created, complete, closed, playoff, reopened
parent_idtournamentGUIDUnique 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_sharetournamentFloatPrize money for first place in a tournament

ex. 1080000.0
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
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)

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:
string
enum
required
Defaults to 2025

Year of the tour season

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

string
enum
required
Defaults to rounds

Type of a round

rounds, playoff

Allowed:
string
enum
required
Defaults to 01

Number of a round

Note: The first playoff round is 01 with round_type of playoff

Allowed:
string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json