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_tournamentsitself. Point any MCP client athttps://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_idstringtournaments[].namestringtournaments[].seasonnumbertournaments[].start_datestringtournaments[].end_datestringtournaments[].statusstringtournaments[].majorbooleantournaments[].scoring_systemstringtournaments[].rounds_schedulednumbertournaments[].pursenumbertournaments[].field_sizenumbertournaments[].playoffbooleantournaments[].cut_roundnumbertournaments[].cut_scorenumbertournaments[].cut_countnumbertournaments[].winner_idstringtournaments[].winner_namestringtournaments[].winning_to_parnumbertournaments[].winning_strokesnumbertournaments[].courses[]array- List of objects
tournaments[].courses[].course_idstringtournaments[].courses[].namestringtournaments[].courses[].citystringtournaments[].courses[].statestringtournaments[].courses[].countrystringtournaments[].courses[].parnumbertournaments[].courses[].yardsnumbertournaments[].courses[].hostbooleancountnumbernext_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
get_ratings2 cr
Filters by the same limit and league.
Our strokes-versus-field rating: every active player, field-strength adjusted
get_head_to_head5 cr
Filters by the same season and league.
Two players' finishes and rounds in every tournament they both played
get_player_stats5 cr
Filters by the same season and league.
A player's season stats: scoring, birdies, par-3/4/5 scoring, driving, greens, putting
get_course2 cr
Filters by the same league.
A course as set up for a tournament: par and yards per hole and how each hole played
Try it
500 free credits every month: 500 calls to list_tournaments, and no card.