get_course

2 creditsBasic lookupPOST /v1/get_course

A course as set up for a tournament: par and yards per hole and how each hole played

Use it when you want a course's setup and how each hole played: scoring average, birdie and bogey rates, difficulty rank.

Parameters

tournament_idstringrequired: Tournament id from list_tournaments.
course_idstringoptional: Course id, for tournaments played on more than one course (list_tournaments lists them).

Notes

Over MCP, ask for it in plain English and the client calls get_course itself. Point any MCP client at https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 credits, 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_course \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "tournament_id": "401580344"
}'

Response

json

{
  "tournament": {
    "tournament_id": "401580344",
    "name": "Masters Tournament",
    "season": 2024,
    "start_date": "2024-04-11",
    "status": "final"
  },
  "course": {
    "course_id": "21",
    "name": "Augusta National Golf Club",
    "city": "Augusta",
    "state": "GA",
    "country": "USA",
    "host": true,
    "par": 72,
    "yards": 7555,
    "par_out": 36,
    "par_in": 36
  },
  "other_courses": [],
  "rounds": 298,
  "scoring_average": 73.91,
  "holes": [
    {
      "hole": 1,
      "par": 4,
      "yards": 445,
      "rounds": 298,
      "scoring_average": 4.208,
      "to_par": 0.201,
      "eagle_or_better": 0,
      "birdie": 0.0973,
      "par_rate": 0.6309,
      "bogey": 0.245,
      "double_or_worse": 0.0268,
      "difficulty_rank": 7
    },
    {
      "hole": 2,
      "par": 5,
      "yards": 585,
      "rounds": 298,
      "scoring_average": 4.658,
      "to_par": -0.342,
      "eagle_or_better": 0.0235,
      "birdie": 0.3859,
      "par_rate": 0.5168,
      "bogey": 0.0604,
      "double_or_worse": 0.0134,
      "difficulty_rank": 17
    },
    {
      "hole": 3,
      "par": 4,
      "yards": 350,
      "rounds": 298,
      "scoring_average": 3.933,
      "to_par": -0.067,
      "eagle_or_better": 0.0101,
      "birdie": 0.2181,
      "par_rate": 0.6242,
      "bogey": 0.1342,
      "double_or_worse": 0.0134,
      "difficulty_rank": 15
    }
  ]
}