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).
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": "401850916",
"name": "Baycurrent Classic",
"season": 2026,
"start_date": "2026-10-07",
"end_date": "2026-10-11",
"status": "live",
"major": false,
"scoring_system": "Medal",
"rounds_scheduled": 4,
"purse": 8000000,
"field_size": 72,
"playoff": null,
"cut_round": null,
"cut_score": null,
"cut_count": null,
"winner_id": null,
"winner_name": null,
"winning_to_par": null,
"winning_strokes": null,
"courses": [
{
"course_id": "11328",
"name": "Yokohama Country Club",
"city": "Yokohama",
"state": null,
"country": "Japan",
"par": 71,
"yards": 7322,
"host": true
}
],
"defending_champion": {
"player_id": "10140",
"name": "Xander Schauffele",
"season": 2025
}
},
{
"tournament_id": "401850917",
"name": "Butterfield Bermuda Championship",
"season": 2026,
"start_date": "2026-10-22",
"end_date": "2026-10-25",
"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": "10935",
"name": "Port Royal Golf Course",
"city": "Southampton Parish",
"state": null,
"country": "Bermuda",
"par": 71,
"yards": 6828,
"host": true
}
],
"defending_champion": {
"player_id": "10372",
"name": "Adam Schenk",
"season": 2025
}
}
],
"count": 2
}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[].playoffnulltournaments[].cut_roundnulltournaments[].cut_scorenulltournaments[].cut_countnulltournaments[].winner_idnulltournaments[].winner_namenulltournaments[].winning_to_parnulltournaments[].winning_strokesnulltournaments[].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
Related endpoints
get_scorecard2 cr
Takes the player_id this one returns.
A player's hole-by-hole scorecard for a tournament, with par and yardage
get_player5 cr
Takes the player_id this one returns.
Profile, rating, season lines and recent finishes
list_tournaments1 cr
Also static reference.
A season's tournaments with dates, winner, purse and courses
search_players1 cr
Also static reference.
Find players by name
Try it
500 credits free on signup: 500 calls to get_schedule, and no card.