Skip to content

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_schedule 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/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

daysnumber
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[].playoffnull
tournaments[].cut_roundnull
tournaments[].cut_scorenull
tournaments[].cut_countnull
tournaments[].winner_idnull
tournaments[].winner_namenull
tournaments[].winning_to_parnull
tournaments[].winning_strokesnull
tournaments[].courses[]array
List of objects
tournaments[].courses[].course_idstring
tournaments[].courses[].namestring
tournaments[].courses[].citystring
tournaments[].courses[].statenull
tournaments[].courses[].countrystring
tournaments[].courses[].parnumber
tournaments[].courses[].yardsnumber
tournaments[].courses[].hostboolean
tournaments[].defending_championobject
tournaments[].defending_champion.player_idstring
tournaments[].defending_champion.namestring
tournaments[].defending_champion.seasonnumber
countnumber

Related endpoints

Try it

500 credits free on signup: 500 calls to get_schedule, and no card.