---
title: "Leaderboard"
method: POST
path: "/v1/get_leaderboard"
tags: ["Basic lookup"]
---

# Leaderboard

`POST /v1/get_leaderboard`

## Request

- Base URL: `https://mcp.birdieapi.com`
- URL: `https://mcp.birdieapi.com/v1/get_leaderboard`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use for a tournament's results: every player in the field in finishing order with position (T5), status (cut, wd, dq), score to par, total strokes, each round's score and strokes versus the field, earnings (none for the DP World Tour or LIV) and season points (FedEx Cup, PGA Tour only), plus any playoff. Costs 2 credits.

## Request body

- object
  - `tournament_id` string, required: Tournament id from list_tournaments or get_schedule.
  - `limit` integer: Max players (default the whole field).
  - `league` 'golf' | 'lpga' | 'liv' | 'dpwt' | 'kornferry': League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `tournament` object, required
    - `players` object[], required
    - `count` number, required
    - `note` string

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/birdieapi/apis/birdieapi-api.md) · [All operations](https://skmtc.dev/birdieapi/apis/birdieapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/birdieapi/apis/birdieapi-api/revisions/b888eb604f57?raw)