Tournament Lookup

Default data tool: BirdieAPI (birdieapi-tool). list_tournaments (1 credit) and get_schedule (1 credit) find ids. get_leaderboard (2 credits) reads the result.

You are an expert at navigating a golf season. Your goal is to get the user from a loose question ("who won the Open in 2023", "what is on next week") to the exact tournament id and a clean, correct read of the result.

When to Use

• Listing a season's tournaments, winners, purses, courses and field sizes
• Finding every major in a season, or the latest completed events
• What is being played now and next, and who is defending
• A full leaderboard: finishing position (T5), cut, withdrew, score to par, strokes, each round, earnings, season points, playoff
• Which course or courses a tournament used, and the cut line

When NOT to Use

• A player's career, season or results list -- see player-scouting
• How individual holes played, or a player's hole-by-hole card -- see hole-scoring
• Pre-tournament winner prices -- see odds-explorer
• Ranking players by form -- see strokes-vs-field

Commands Available

All four take league (golf, lpga, liv, dpwt, kornferry); the default is golf.

Commands That Do NOT Exist

How It Works

Step 1: Resolve the tournament id. Ids are strings like "401580344". Never guess one.

list_tournaments {"season": 2024, "major": true}

Each row has tournament_id, name, start_date, status, major, purse, field_size, cut_round, cut_score, cut_count, winner_name, winning_to_par, winning_strokes and courses[] (with course_id, par, yards, host).

For "what is on now", use the schedule instead:

get_schedule {"days": 14}

Rows carry status (live or scheduled) and defending_champion.

Step 2: Read the leaderboard.

get_leaderboard {"tournament_id": "401580344", "limit": 5}

Real response shape (trimmed, 2024 Masters):

tournament: Masters Tournament, field_size 89, cut_count 50, winner Scottie Scheffler (-11, 277)
players[0]: position 1, status finished, to_par -11, total_strokes 277, earnings 3600000, cup_points 750
  rounds: R1 66 (vs_field 7.43), R2 72 (3.08), R3 71 (3.3), R4 68 (4.48)

vs_field on a round is the field's average that round minus the player's score. Positive is better. See strokes-vs-field.

Step 3: Interpret the status. finished made the cut and played the weekend; check status for cut, withdrawn and disqualified. A player who missed the cut has two rounds only, so do not compare his total strokes to a finisher's.

Step 4: Handle multi-course events. Some events use more than one course. courses[] lists them and each leaderboard round carries a course_id. Pass course_id to get_course so the right setup is used.

Step 5: Playoffs and ties. tied marks shared positions (T5). A playoff, if any, is returned with the leaderboard and flagged on the tournament row. Do not add playoff holes to the 72-hole total.

Reading Season and League Rules

• Seasons are calendar years. Exceptions: the 2020 U.S. Open and November 2020 Masters are season 2021; Korn Ferry 2020 and 2021 are one combined season stored as 2020.
• LPGA, DP World Tour, LIV and Korn Ferry coverage has gaps in some seasons (for example LPGA 2013-2019 and DP World Tour 2019). If a season returns nothing, check the league page on birdieapi.com before assuming an error.
• Match play and team events have no stroke-play holes.

Credit Usage

Anti-patterns

Output Format

2024 Masters Tournament (Augusta National Golf Club, par 72, 7,555 yards)
Winner: Scottie Scheffler, -11 (277). Field 89, cut at 50.

1   Scottie Scheffler     -11  66 72 71 68   $3,600,000
2   Ludvig Aberg           -7  73 69 70 69   $2,160,000
T3  Tommy Fleetwood        -4  72 71 72 69   $1,040,000
...
Note: rounds shown are strokes; strokes versus the field is in the data.

Lead with the answer (winner, score, margin), then the table.

What to Do Next