Skip to content

list_tournaments

1 creditStatic referencePOST /v1/list_tournaments

Data refreshed · changelog

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.
leagueenum: golf | lpga | liv | dpwt | kornferryoptional
League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.

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": 2025,
  "major": true,
  "limit": 3
}'

Response

json
{
  "tournaments": [
    {
      "tournament_id": "401703504",
      "name": "Masters Tournament",
      "season": 2025,
      "start_date": "2025-04-10",
      "end_date": "2025-04-13",
      "status": "final",
      "major": true,
      "scoring_system": "Medal",
      "rounds_scheduled": 4,
      "purse": 21000000,
      "field_size": 95,
      "playoff": true,
      "cut_round": 2,
      "cut_score": 2,
      "cut_count": 50,
      "winner_id": "3470",
      "winner_name": "Rory McIlroy",
      "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": "401703511",
      "name": "PGA Championship",
      "season": 2025,
      "start_date": "2025-05-15",
      "end_date": "2025-05-18",
      "status": "final",
      "major": true,
      "scoring_system": "Medal",
      "rounds_scheduled": 4,
      "purse": 19000000,
      "field_size": 156,
      "playoff": false,
      "cut_round": 2,
      "cut_score": 1,
      "cut_count": 74,
      "winner_id": "9478",
      "winner_name": "Scottie Scheffler",
      "winning_to_par": -11,
      "winning_strokes": 273,
      "courses": [
        {
          "course_id": "83",
          "name": "Quail Hollow Club",
          "city": "Charlotte",
          "state": "NC",
          "country": "USA",
          "par": 71,
          "yards": 7626,
          "host": true
        }
      ]
    },
    {
      "tournament_id": "401703515",
      "name": "U.S. Open",
      "season": 2025,
      "start_date": "2025-06-12",
      "end_date": "2025-06-15",
      "status": "final",
      "major": true,
      "scoring_system": "Medal",
      "rounds_scheduled": 4,
      "purse": 21500000,
      "field_size": 156,
      "playoff": false,
      "cut_round": 2,
      "cut_score": 7,
      "cut_count": 60,
      "winner_id": "10166",
      "winner_name": "J.J. Spaun",
      "winning_to_par": -1,
      "winning_strokes": 279,
      "courses": [
        {
          "course_id": "294",
          "name": "Oakmont Country Club",
          "city": "Oakmont",
          "state": "PA",
          "country": "USA",
          "par": 70,
          "yards": 7372,
          "host": true
        }
      ]
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

tournaments[]array
List of objects
tournaments[].tournament_idstring
tournaments[].namestring
tournaments[].seasonnumber
tournaments[].start_datestring
tournaments[].end_datestring
tournaments[].statusstring
tournaments[].majorboolean
tournaments[].scoring_systemstring
tournaments[].rounds_schedulednumber
tournaments[].pursenumber
tournaments[].field_sizenumber
tournaments[].playoffboolean
tournaments[].cut_roundnumber
tournaments[].cut_scorenumber
tournaments[].cut_countnumber
tournaments[].winner_idstring
tournaments[].winner_namestring
tournaments[].winning_to_parnumber
tournaments[].winning_strokesnumber
tournaments[].courses[]array
List of objects
tournaments[].courses[].course_idstring
tournaments[].courses[].namestring
tournaments[].courses[].citystring
tournaments[].courses[].statestring
tournaments[].courses[].countrystring
tournaments[].courses[].parnumber
tournaments[].courses[].yardsnumber
tournaments[].courses[].hostboolean
countnumber
next_offsetnumber

Used in

  • Golf leaderboard and results data: Full PGA Tour leaderboards since 2001, every player in every field, with rounds, status and money; the LPGA, LIV and DP World Tour through the same tools.
  • Golf major winner odds by sportsbook: Pre-tournament winner prices for the Masters, PGA Championship, U.S. Open and Open Championship by sportsbook, from 2021, with how they moved. REST or MCP.

Related endpoints

Try it

500 free credits every month: 500 calls to list_tournaments, and no card.