GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Player Profile

Provides biographical information and historical tournament statistics for a given player.

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

Update Frequency

120s Time To Live / Cache

📘

Retrieving Player Details and Statistics

Learn how to retrieve biographical detail, tournament history, and season statistics in our Retrieving Player Details and Statistics integration scenario.


Data Points

Player
AttributeParent ElementTypeDescription
abbr_nameprofileStringAbbreviated name of a player

ex. R.McIlroy
amateurprofileBooleanSignifies that a player is in amateur status when true
birthdayprofileDatePlayer date of birth

ex. 1989-05-04
birth_placeprofileStringBirthplace of a player

ex. Holywood, , IRL
collegeprofileStringCollege attended

ex. Iowa
countryprofileStringCountry of a player

ex. NORTHERN IRELAND
first_nameprofileStringFirst name of a player

ex. Rory
genderprofileStringGender of a player

ex. male, female
handednessprofileStringHandedness of a player

ex. R, L
heightprofileIntegerHeight in inches
idprofileGUIDUnique player ID

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

ex. McIlroy
nameprofileStringName of a player

ex. McIlroy, Rory
residenceprofileStringResidence of a player

ex. Holywood, , IRL
weightprofileShortWeight in lbs.
turned_proprofileShortYear a player became a professional
Leaderboard & Summary
AttributeParent ElementTypeDescription
positiontournament - leaderboard - playerShortLeaderboard position for a player
moneytournament - leaderboard - playerFloatTournament money won (in US dollars) for a player
scoretournament - leaderboard - playerIntegerOverall player score in a tournament or playoff

ex. -10
statustournament - leaderboard - playerStringStatus of a player for a particular tournament

CUT, WD, MDF, DQ, DNS

See our Golf FAQ for more info and definitions of each status
strokestournament - leaderboard - playerShortOverall player strokes in a tournament or playoff

ex. -10
pointstournament - leaderboard - playerFloatFedEx points earned for a player in a tournament
tiedtournament - leaderboard - playerBooleanSignifies a tie for a leaderboard spot
birdiestournament - leaderboard - player - roundIntegerNumber of birdies in a tournament round
bogeystournament - leaderboard - player - roundIntegerNumber of bogeys in a tournament round
double_bogeystournament - leaderboard - player - roundIntegerNumber of double bogeys in a tournament round
eaglestournament - leaderboard - player - roundIntegerNumber of eagles in a tournament round
thrutournament - leaderboard - player - roundIntegerNumber of holes completed in a tournament round
holes_in_onetournament - leaderboard - player - roundIntegerNumber of holes in one in a tournament round
other_scorestournament - leaderboard - player - roundIntegerNumber of other scores in a tournament round (non-pars, birdies, eagles, holes in one, bogeys, double bogeys)
parstournament - leaderboard - player - roundIntegerNumber of pars in a tournament round
sequencetournament - leaderboard - player - roundIntegerTournament round number
scoretournament - leaderboard - player - roundIntegerPlayer score in a round

ex. -4
strokestournament - leaderboard - player - roundShortPlayer strokes in a round

ex. 68
Player Season Statistics
AttributeParent ElementTypeDescription
drive_avgstatisticsDecimalAverage drive distance in yards

ex. 321.3
birdies_per_roundstatisticsFloatBirdies per round

ex. 4.53
cuts_madestatisticsIntegerNumber of cuts made
cuts_missedstatisticsIntegerNumber of cuts missed
drive_accstatisticsDecimalDrive accuracy percentage (percentage of time a tee shot comes to rest in the fairway, regardless of club)

ex. 58.06
earnings_rankstatisticsIntegerTotal earnings rank
events_playedstatisticsIntegerNumber of events played
points_rankstatisticsIntegerFedEx Cup points rank
pointsstatisticsIntegerTotal FedEx Cup points
first_placestatisticsIntegerNumber of first place finishes
gir_pctstatisticsDecimalGreens in regulation percentage

ex. 69.91
holes_per_eaglestatisticsDecimalAverage holes played per eagle

ex. 108.5
holes_proximity_avgstatisticsStringAverage proximity to the hole in feet

ex. 36'
putt_avgstatisticsDecimalAverage number of putts per hole

ex. 1.739
sand_saves_pctstatisticsDecimalPercentage of sand saves (percentage of times it took 2 shots or less after lying in a bunker)

ex. 61.63
scoring_avgstatisticsDecimalAverage strokes in a round

ex. 68.67
scrambling_pctstatisticsDecimalScrambling percentage (percentage of par or better scores if a GIR (Green in Regulation) is missed)

ex. 62.77
earningsstatisticsFloatTotal season earnings
second_placestatisticsIntegerNumber of second place finishes
strokes_gainedstatisticsFloatAverage strokes gained putting
strokes_gained_tee_greenstatisticsFloatAverage strokes gained tee to green
strokes_gained_totalstatisticsFloatAverage strokes gained
third_placestatisticsIntegerNumber of third place finishes
top_10statisticsIntegerNumber of top 10 finishes
top_25statisticsIntegerNumber of top 25 finishes
total_drivingstatisticsShortTotal driving (total of a player's rank in both driving distance and driving accuracy)
withdrawalsstatisticsIntegerNumber of withdrawals
world_rankstatisticsIntegerOfficial World Golf Ranking for the season
Season
AttributeParent ElementTypeDescription
idtournament / statistics - seasonGUIDUnique ID of a season

ex. ece9907c-6fe3-4944-8cb9-bb1033270259
yeartournament / statistics - seasonGUIDYear of a tour season
Tour
AttributeParent ElementTypeDescription
aliasseason - tourStringAlias of a tour

ex. pga
idseason - tourGUIDUnique ID of a tour

ex. b52068af-28e4-4e91-bdbb-037591b0ff84
nameseason - tourStringName of a tour

ex. PGA Tour
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
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 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
required
Defaults to 6db3e736-d86d-4181-aa3b-651b8c1bfdc1

Unique Id of a player, found in the Players endpoint

Example: 6db3e736-d86d-4181-aa3b-651b8c1bfdc1

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