get_scorecard

2 creditsBasic lookupPOST /v1/get_scorecard

A player's hole-by-hole scorecard for a tournament, with par and yardage

Use it when you want one player's tournament hole by hole: strokes, par, yards and the result on each hole.

Parameters

tournament_idstringrequired: Tournament id from list_tournaments.
player_idstringrequired: Player id from get_leaderboard or search_players.

Notes

Over MCP, ask for it in plain English and the client calls get_scorecard itself. Point any MCP client at https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 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_scorecard \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "tournament_id": "401580344",
  "player_id": "9478"
}'

Response

json

{
  "result": {
    "tournament_id": "401580344",
    "tournament": "Masters Tournament",
    "season": 2024,
    "start_date": "2024-04-11",
    "player_id": "9478",
    "name": "Scottie Scheffler",
    "position_display": "1",
    "status": "finished",
    "to_par": -11,
    "total_strokes": 277
  },
  "rounds": [
    {
      "round": 1,
      "playoff": false,
      "strokes": 66,
      "to_par": -6,
      "out": 34,
      "in": 32,
      "course_id": "21",
      "course": "Augusta National Golf Club",
      "field_avg": 73.43,
      "vs_field": 7.43,
      "holes_played": 18,
      "holes": [
        {
          "hole": 1,
          "par": 4,
          "yards": 445,
          "strokes": 4,
          "result": "par"
        },
        {
          "hole": 2,
          "par": 5,
          "yards": 585,
          "strokes": 4,
          "result": "birdie"
        },
        {
          "hole": 3,
          "par": 4,
          "yards": 350,
          "strokes": 4,
          "result": "par"
        }
      ]
    },
    {
      "round": 2,
      "playoff": false,
      "strokes": 72,
      "to_par": 0,
      "out": 36,
      "in": 36,
      "course_id": "21",
      "course": "Augusta National Golf Club",
      "field_avg": 75.08,
      "vs_field": 3.08,
      "holes_played": 18,
      "holes": [
        {
          "hole": 1,
          "par": 4,
          "yards": 445,
          "strokes": 4,
          "result": "par"
        },
        {
          "hole": 2,
          "par": 5,
          "yards": 585,
          "strokes": 4,
          "result": "birdie"
        },
        {
          "hole": 3,
          "par": 4,
          "yards": 350,
          "strokes": 4,
          "result": "par"
        }
      ]
    },
    {
      "round": 3,
      "playoff": false,
      "strokes": 71,
      "to_par": -1,
      "out": 35,
      "in": 36,
      "course_id": "21",
      "course": "Augusta National Golf Club",
      "field_avg": 74.3,
      "vs_field": 3.3,
      "holes_played": 18,
      "holes": [
        {
          "hole": 1,
          "par": 4,
          "yards": 445,
          "strokes": 3,
          "result": "birdie"
        },
        {
          "hole": 2,
          "par": 5,
          "yards": 585,
          "strokes": 5,
          "result": "par"
        },
        {
          "hole": 3,
          "par": 4,
          "yards": 350,
          "strokes": 3,
          "result": "birdie"
        }
      ]
    }
  ]
}