get_player

5 creditsStats + aggregationPOST /v1/get_player

Profile, rating, season lines and recent finishes

Use it when you are profiling a player: career totals, current rating, a line per season and the latest results.

Parameters

player_idstringrequired: Player id from search_players or get_leaderboard.

Notes

Over MCP, ask for it in plain English and the client calls get_player 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 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "9478"
}'

Response

json

{
  "player": {
    "player_id": "9478",
    "name": "Scottie Scheffler",
    "first_name": null,
    "last_name": "Scheffler",
    "country": "USA",
    "birth_date": null,
    "amateur": false,
    "headshot": "https://a.espncdn.com/i/headshots/golf/players/full/9478.png"
  },
  "career": {
    "starts": 167,
    "wins": 23,
    "top_tens": 90,
    "top_25s": 126,
    "made_cut": 149,
    "missed_cut": 18,
    "withdrew_or_dq": 0,
    "average_finish": 12.9,
    "earnings": 136496992,
    "cup_points": 29391,
    "rounds": 631,
    "scoring_average": 68.69,
    "average_to_par": -2.4,
    "vs_field": 1.93,
    "adj_vs_field": 2.92
  },
  "rating": {
    "rating": 3.31,
    "weighted_rounds": 133.1,
    "as_of": "2026-08-30"
  },
  "seasons": [
    {
      "season": 2026,
      "starts": 20,
      "wins": 3,
      "top_tens": 13,
      "made_cut": 19,
      "earnings": 30937526,
      "cup_points": 4986,
      "scoring_average": 67.86,
      "adj_vs_field": 3.46
    },
    {
      "season": 2025,
      "starts": 21,
      "wins": 6,
      "top_tens": 18,
      "made_cut": 21,
      "earnings": 27659548,
      "cup_points": 7457,
      "scoring_average": 67.94,
      "adj_vs_field": 3.86
    },
    {
      "season": 2024,
      "starts": 20,
      "wins": 8,
      "top_tens": 17,
      "made_cut": 20,
      "earnings": 29228358,
      "cup_points": 6615,
      "scoring_average": 67.9,
      "adj_vs_field": 3.75
    }
  ],
  "recent_results": [
    {
      "tournament_id": "401811964",
      "name": "TOUR Championship",
      "season": 2026,
      "start_date": "2026-08-27",
      "major": false,
      "position_display": "1",
      "status": "finished",
      "to_par": -16,
      "earnings": 10000000
    },
    {
      "tournament_id": "401811963",
      "name": "BMW Championship",
      "season": 2026,
      "start_date": "2026-08-20",
      "major": false,
      "position_display": "T12",
      "status": "finished",
      "to_par": -7,
      "earnings": 426250
    },
    {
      "tournament_id": "401811962",
      "name": "FedEx St. Jude Championship",
      "season": 2026,
      "start_date": "2026-08-13",
      "major": false,
      "position_display": "1",
      "status": "finished",
      "to_par": -17,
      "earnings": 3600000
    }
  ]
}