get_player_results
5 creditsStats + aggregationPOST /v1/get_player_results
Data refreshed · changelog
A player's tournaments and rounds by season, with strokes versus the field
Use it when you need a player's tournament-by-tournament record with every round against the field, for form or modelling.
Parameters
player_idstringrequired- Player id from search_players.
seasonstring | numberoptional- Season year, e.g. 2025.
limitintegeroptional- Max tournaments (default 50).
offsetintegeroptional- Page offset; use next_offset.
leagueenum: golf | lpga | liv | dpwt | kornferryoptional- League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.
Notes
- Over MCP, ask for it in plain English and the client calls
get_player_resultsitself. Point any MCP client athttps://mcp.birdieapi.com/mcp?key=YOUR_API_KEY. - Each call costs 5 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.birdieapi.com/v1/get_player_results \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"player_id": "9478",
"season": 2025,
"limit": 3
}'Response
json
{
"player_id": "9478",
"results": [
{
"tournament_id": "401738560",
"name": "Hero World Challenge",
"season": 2025,
"start_date": "2025-12-04",
"major": false,
"field_size": 20,
"position": 4,
"position_display": "T4",
"status": "finished",
"to_par": -20,
"total_strokes": 268,
"earnings": null,
"cup_points": null,
"rounds": [
{
"round": 1,
"strokes": 66,
"to_par": -6,
"course_id": "10697",
"field_avg": 69.05,
"vs_field": 3.05,
"adj_vs_field": 4.46
},
{
"round": 2,
"strokes": 69,
"to_par": -3,
"course_id": "10697",
"field_avg": 68.95,
"vs_field": -0.05,
"adj_vs_field": 1.36
},
{
"round": 3,
"strokes": 65,
"to_par": -7,
"course_id": "10697",
"field_avg": 69.15,
"vs_field": 4.15,
"adj_vs_field": 5.56
}
]
},
{
"tournament_id": "401738553",
"name": "Procore Championship",
"season": 2025,
"start_date": "2025-09-11",
"major": false,
"field_size": 144,
"position": 1,
"position_display": "1",
"status": "finished",
"to_par": -19,
"total_strokes": 269,
"earnings": 1080000,
"cup_points": null,
"rounds": [
{
"round": 1,
"strokes": 70,
"to_par": -2,
"course_id": "784",
"field_avg": 71.78,
"vs_field": 1.78,
"adj_vs_field": 2.33
},
{
"round": 2,
"strokes": 68,
"to_par": -4,
"course_id": "784",
"field_avg": 72.04,
"vs_field": 4.04,
"adj_vs_field": 4.59
},
{
"round": 3,
"strokes": 64,
"to_par": -8,
"course_id": "784",
"field_avg": 71.06,
"vs_field": 7.06,
"adj_vs_field": 7.86
}
]
},
{
"tournament_id": "401703531",
"name": "TOUR Championship",
"season": 2025,
"start_date": "2025-08-21",
"major": false,
"field_size": 30,
"position": 4,
"position_display": "T4",
"status": "finished",
"to_par": -14,
"total_strokes": 266,
"earnings": 2616667,
"cup_points": null,
"rounds": [
{
"round": 1,
"strokes": 63,
"to_par": -7,
"course_id": "57",
"field_avg": 67.27,
"vs_field": 4.27,
"adj_vs_field": 5.82
},
{
"round": 2,
"strokes": 69,
"to_par": -1,
"course_id": "57",
"field_avg": 66.8,
"vs_field": -2.2,
"adj_vs_field": -0.65
},
{
"round": 3,
"strokes": 66,
"to_par": -4,
"course_id": "57",
"field_avg": 69.57,
"vs_field": 3.57,
"adj_vs_field": 5.12
}
]
}
],
"count": 3,
"next_offset": 3
}Response fields
player_idstringresults[]array- List of objects
results[].tournament_idstringresults[].namestringresults[].seasonnumberresults[].start_datestringresults[].majorbooleanresults[].field_sizenumberresults[].positionnumberresults[].position_displaystringresults[].statusstringresults[].to_parnumberresults[].total_strokesnumberresults[].earningsnullresults[].cup_pointsnullresults[].rounds[]array- List of objects
results[].rounds[].roundnumberresults[].rounds[].strokesnumberresults[].rounds[].to_parnumberresults[].rounds[].course_idstringresults[].rounds[].field_avgnumberresults[].rounds[].vs_fieldnumberresults[].rounds[].adj_vs_fieldnumbercountnumbernext_offsetnumber
Used in
- Golf leaderboard and results data: Full PGA Tour leaderboards since 2001, every player in every field, with rounds, status and money; the LPGA, LIV and DP World Tour through the same tools.
- Guide: How do I get a golfer's strokes versus the field for each round?
Related endpoints
get_schedule1 cr
Returns the player_id this one takes.
Tournaments this week and coming up, with the host course
search_players1 cr
Returns the player_id this one takes.
Find players by name
get_scorecard2 cr
Takes the player_id this one returns.
A player's hole-by-hole scorecard for a tournament, with par and yardage
get_player5 cr
Takes the player_id this one returns.
Profile, rating, season lines and recent finishes
Try it
500 free credits every month: 100 calls to get_player_results, and no card.