Skip to content

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_results itself. Point any MCP client at https://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_idstring
results[]array
List of objects
results[].tournament_idstring
results[].namestring
results[].seasonnumber
results[].start_datestring
results[].majorboolean
results[].field_sizenumber
results[].positionnumber
results[].position_displaystring
results[].statusstring
results[].to_parnumber
results[].total_strokesnumber
results[].earningsnull
results[].cup_pointsnull
results[].rounds[]array
List of objects
results[].rounds[].roundnumber
results[].rounds[].strokesnumber
results[].rounds[].to_parnumber
results[].rounds[].course_idstring
results[].rounds[].field_avgnumber
results[].rounds[].vs_fieldnumber
results[].rounds[].adj_vs_fieldnumber
countnumber
next_offsetnumber

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_player_results, and no card.