get_leaderboard

2 creditsBasic lookupPOST /v1/get_leaderboard

A tournament's full leaderboard: position, rounds, total, earnings and points

Use it when you want a tournament's full result: every player's finish, rounds, strokes versus the field and money.

Parameters

tournament_idstringrequired: Tournament id from list_tournaments or get_schedule.
limitintegeroptional: Max players (default the whole field).

Notes

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

Response

json

{
  "tournament": {
    "tournament_id": "401580344",
    "name": "Masters Tournament",
    "season": 2024,
    "start_date": "2024-04-11",
    "end_date": "2024-04-14",
    "status": "final",
    "major": true,
    "scoring_system": "Medal",
    "rounds_scheduled": 4,
    "purse": 20000000,
    "field_size": 89,
    "playoff": false,
    "cut_round": 2,
    "cut_score": 6,
    "cut_count": 50,
    "winner_id": "9478",
    "winner_name": "Scottie Scheffler",
    "winning_to_par": -11,
    "winning_strokes": 277,
    "courses": [
      {
        "course_id": "21",
        "name": "Augusta National Golf Club",
        "city": "Augusta",
        "state": "GA",
        "country": "USA",
        "par": 72,
        "yards": 7555,
        "host": true
      }
    ]
  },
  "players": [
    {
      "position": 1,
      "position_display": "1",
      "tied": false,
      "status": "finished",
      "player_id": "9478",
      "name": "Scottie Scheffler",
      "country": "USA",
      "amateur": false,
      "to_par": -11,
      "total_strokes": 277,
      "rounds_played": 4,
      "earnings": 3600000,
      "cup_points": 750,
      "rounds": [
        {
          "round": 1,
          "strokes": 66,
          "to_par": -6,
          "course_id": "21",
          "vs_field": 7.43
        },
        {
          "round": 2,
          "strokes": 72,
          "to_par": 0,
          "course_id": "21",
          "vs_field": 3.08
        },
        {
          "round": 3,
          "strokes": 71,
          "to_par": -1,
          "course_id": "21",
          "vs_field": 3.3
        }
      ]
    },
    {
      "position": 2,
      "position_display": "2",
      "tied": false,
      "status": "finished",
      "player_id": "4375972",
      "name": "Ludvig Åberg",
      "country": "Sweden",
      "amateur": false,
      "to_par": -7,
      "total_strokes": 281,
      "rounds_played": 4,
      "earnings": 2160000,
      "cup_points": 400,
      "rounds": [
        {
          "round": 1,
          "strokes": 73,
          "to_par": 1,
          "course_id": "21",
          "vs_field": 0.43
        },
        {
          "round": 2,
          "strokes": 69,
          "to_par": -3,
          "course_id": "21",
          "vs_field": 6.08
        },
        {
          "round": 3,
          "strokes": 70,
          "to_par": -2,
          "course_id": "21",
          "vs_field": 4.3
        }
      ]
    },
    {
      "position": 3,
      "position_display": "T3",
      "tied": true,
      "status": "finished",
      "player_id": "5539",
      "name": "Tommy Fleetwood",
      "country": "England",
      "amateur": false,
      "to_par": -4,
      "total_strokes": 284,
      "rounds_played": 4,
      "earnings": 1040000,
      "cup_points": 325,
      "rounds": [
        {
          "round": 1,
          "strokes": 72,
          "to_par": 0,
          "course_id": "21",
          "vs_field": 1.43
        },
        {
          "round": 2,
          "strokes": 71,
          "to_par": -1,
          "course_id": "21",
          "vs_field": 4.08
        },
        {
          "round": 3,
          "strokes": 72,
          "to_par": 0,
          "course_id": "21",
          "vs_field": 2.3
        }
      ]
    }
  ],
  "count": 3
}