get_schedule
1 creditStatic referencePOST /v1/get_schedule
Tournaments this week and coming up, with the host course
Use it when you want what is being played this week and next, with the course and the defending champion.
Parameters
daysintegeroptional- Days ahead (default 30, max 365).
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
get_scheduleitself. 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/get_schedule \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"days": 21
}'Response
json
{
"days": 21,
"tournaments": [
{
"tournament_id": "401850978",
"name": "VidantaWorld Mexico Open",
"season": 2026,
"start_date": "2026-10-29",
"end_date": "2026-11-01",
"status": "final",
"major": false,
"scoring_system": "Medal",
"rounds_scheduled": 4,
"purse": 6000000,
"field_size": 120,
"playoff": false,
"cut_round": 2,
"cut_score": -4,
"cut_count": 68,
"winner_id": "11332",
"winner_name": "Andrew Novak",
"winning_to_par": -25,
"winning_strokes": 259,
"courses": [
{
"course_id": "11163",
"name": "Vidanta Vallarta",
"city": "Nuevo Vallarta",
"state": null,
"country": "Mexico",
"par": 71,
"yards": 7337,
"host": true
}
],
"defending_champion": {
"player_id": "9525",
"name": "Brian Campbell",
"season": 2025
}
},
{
"tournament_id": "401850979",
"name": "World Wide Technology Championship",
"season": 2026,
"start_date": "2026-11-05",
"end_date": "2026-11-08",
"status": "scheduled",
"major": false,
"scoring_system": "Medal",
"rounds_scheduled": 4,
"purse": 6000000,
"field_size": null,
"playoff": null,
"cut_round": 2,
"cut_score": 0,
"cut_count": 0,
"winner_id": null,
"winner_name": null,
"winning_to_par": null,
"winning_strokes": null,
"courses": [
{
"course_id": "11284",
"name": "El Cardonal at Diamante",
"city": "Cabo San Lucas",
"state": null,
"country": "Mexico",
"par": 72,
"yards": 7452,
"host": true
}
],
"defending_champion": {
"player_id": "4404992",
"name": "Ben Griffin",
"season": 2025
}
},
{
"tournament_id": "401850980",
"name": "Austin Championship",
"season": 2026,
"start_date": "2026-11-12",
"end_date": "2026-11-15",
"status": "scheduled",
"major": false,
"scoring_system": "Medal",
"rounds_scheduled": 4,
"purse": 6000000,
"field_size": null,
"playoff": null,
"cut_round": 2,
"cut_score": 0,
"cut_count": 0,
"winner_id": null,
"winner_name": null,
"winning_to_par": null,
"winning_strokes": null,
"courses": [
{
"course_id": "11357",
"name": "Omni Barton Creek Resort & Spa (Fazio Canyons Course)",
"city": "Austin",
"state": "TX",
"country": "USA",
"par": null,
"yards": null,
"host": true
}
],
"defending_champion": null
}
],
"count": 4
}Response fields
daysnumbertournaments[]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[].statenulltournaments[].courses[].countrystringtournaments[].courses[].parnumbertournaments[].courses[].yardsnumbertournaments[].courses[].hostbooleantournaments[].defending_championobjecttournaments[].defending_champion.player_idstringtournaments[].defending_champion.namestringtournaments[].defending_champion.seasonnumbercountnumber
Used in
Related endpoints
get_winner_odds5 cr
Takes the player_id this one returns.
The four majors' winner prices by sportsbook before the first round: opening and latest, with implied probability
get_course_history5 cr
Takes the player_id this one returns.
A player's record at one tournament or course, every year
list_tournaments1 cr
Filters by the same league.
A season's tournaments with dates, winner, purse and courses
search_players1 cr
Filters by the same league.
Find players by name
Try it
500 free credits every month: 500 calls to get_schedule, and no card.