get_player_results

5 creditsStats + aggregationPOST /v1/get_player_results

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.

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": 2024,
  "limit": 3
}'

Response

json

{
  "player_id": "9478",
  "results": [
    {
      "tournament_id": "401693956",
      "name": "Hero World Challenge",
      "season": 2024,
      "start_date": "2024-12-05",
      "major": false,
      "field_size": 20,
      "position": 1,
      "position_display": "1",
      "status": "finished",
      "to_par": -25,
      "total_strokes": 263,
      "earnings": null,
      "cup_points": null,
      "rounds": [
        {
          "round": 1,
          "strokes": 67,
          "to_par": -5,
          "course_id": "10697",
          "field_avg": 69.05,
          "vs_field": 2.05,
          "adj_vs_field": 3.47
        },
        {
          "round": 2,
          "strokes": 64,
          "to_par": -8,
          "course_id": "10697",
          "field_avg": 69.75,
          "vs_field": 5.75,
          "adj_vs_field": 7.17
        },
        {
          "round": 3,
          "strokes": 69,
          "to_par": -3,
          "course_id": "10697",
          "field_avg": 70.45,
          "vs_field": 1.45,
          "adj_vs_field": 2.87
        }
      ]
    },
    {
      "tournament_id": "401580366",
      "name": "TOUR Championship",
      "season": 2024,
      "start_date": "2024-08-29",
      "major": false,
      "field_size": 30,
      "position": 1,
      "position_display": "1",
      "status": "finished",
      "to_par": -30,
      "total_strokes": 264,
      "earnings": null,
      "cup_points": null,
      "rounds": [
        {
          "round": 1,
          "strokes": 65,
          "to_par": -6,
          "course_id": "57",
          "field_avg": 68.47,
          "vs_field": 3.47,
          "adj_vs_field": 5.01
        },
        {
          "round": 2,
          "strokes": 66,
          "to_par": -5,
          "course_id": "57",
          "field_avg": 68.73,
          "vs_field": 2.73,
          "adj_vs_field": 4.28
        },
        {
          "round": 3,
          "strokes": 66,
          "to_par": -5,
          "course_id": "57",
          "field_avg": 69.4,
          "vs_field": 3.4,
          "adj_vs_field": 4.94
        }
      ]
    },
    {
      "tournament_id": "401580365",
      "name": "BMW Championship",
      "season": 2024,
      "start_date": "2024-08-22",
      "major": false,
      "field_size": 50,
      "position": 33,
      "position_display": "T33",
      "status": "finished",
      "to_par": 1,
      "total_strokes": 289,
      "earnings": 119667,
      "cup_points": 82,
      "rounds": [
        {
          "round": 1,
          "strokes": 71,
          "to_par": -1,
          "course_id": "11274",
          "field_avg": 71.96,
          "vs_field": 0.96,
          "adj_vs_field": 2.34
        },
        {
          "round": 2,
          "strokes": 72,
          "to_par": 0,
          "course_id": "11274",
          "field_avg": 70.04,
          "vs_field": -1.96,
          "adj_vs_field": -0.59
        },
        {
          "round": 3,
          "strokes": 74,
          "to_par": 2,
          "course_id": "11274",
          "field_avg": 71.71,
          "vs_field": -2.29,
          "adj_vs_field": -0.93
        }
      ]
    }
  ],
  "count": 3,
  "next_offset": 3
}