list_tournaments

1 creditStatic referencePOST /v1/list_tournaments

A season's tournaments with dates, winner, purse and courses

Use it when you need tournament ids for a season, or the winners and courses at a glance.

Parameters

seasonstring | numberoptional: Season year, e.g. 2025.
statusenum: scheduled | live | finaloptional: Only upcoming, in-progress or completed tournaments.
majorbooleanoptional: Only the majors.
limitintegeroptional: Max tournaments (default 60).
offsetintegeroptional: Page offset; use next_offset.

Notes

Over MCP, ask for it in plain English and the client calls list_tournaments itself. Point any MCP client at https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY.
Each call costs 1 credit, 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/list_tournaments \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2024,
  "major": true,
  "limit": 3
}'

Response

json

{
  "tournaments": [
    {
      "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
        }
      ]
    },
    {
      "tournament_id": "401580351",
      "name": "PGA Championship",
      "season": 2024,
      "start_date": "2024-05-16",
      "end_date": "2024-05-19",
      "status": "final",
      "major": true,
      "scoring_system": "Medal",
      "rounds_scheduled": 4,
      "purse": 18500000,
      "field_size": 156,
      "playoff": false,
      "cut_round": 2,
      "cut_score": -1,
      "cut_count": 78,
      "winner_id": "10140",
      "winner_name": "Xander Schauffele",
      "winning_to_par": -21,
      "winning_strokes": 263,
      "courses": [
        {
          "course_id": "41",
          "name": "Valhalla Golf Club",
          "city": "Louisville",
          "state": "KY",
          "country": "USA",
          "par": 71,
          "yards": 7609,
          "host": true
        }
      ]
    },
    {
      "tournament_id": "401580355",
      "name": "U.S. Open",
      "season": 2024,
      "start_date": "2024-06-13",
      "end_date": "2024-06-16",
      "status": "final",
      "major": true,
      "scoring_system": "Medal",
      "rounds_scheduled": 4,
      "purse": 21500000,
      "field_size": 156,
      "playoff": false,
      "cut_round": 2,
      "cut_score": 5,
      "cut_count": 60,
      "winner_id": "10046",
      "winner_name": "Bryson DeChambeau",
      "winning_to_par": -6,
      "winning_strokes": 274,
      "courses": [
        {
          "course_id": "776",
          "name": "Pinehurst No. 2",
          "city": "Pinehurst",
          "state": "NC",
          "country": "USA",
          "par": 70,
          "yards": 7569,
          "host": true
        }
      ]
    }
  ],
  "count": 3,
  "next_offset": 3
}