---
title: "Leaders"
method: POST
path: "/v1/get_leaders"
tags: ["Stats + aggregation"]
---

# Leaders

`POST /v1/get_leaders`

## Request

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

Use for a season's leaders in one stat, with each player's sample. Stats from rounds and holes: scoring_average, vs_field, adj_vs_field, birdies_per_round, bogey_avoidance, par3_average, par4_average, par5_average, and sg_par3, sg_par4, sg_par5 (strokes versus the field on par 3, 4 or 5 holes, field-strength adjusted; PGA Tour and Korn Ferry Tour only, score-based, not shot data). From results: earnings (empty for the DP World Tour and LIV), cup_points (FedEx Cup points, PGA Tour only: no Race to Dubai or CME Globe points), wins, top_tens. From tournament stat lines (PGA Tour from 2011): driving_distance, driving_accuracy, greens_in_regulation, putts_per_gir. Costs 5 credits.

## Request body

- object
  - `stat` 'scoring_average' | 'adj_vs_field' | 'vs_field' | 'birdies_per_round' | 'bogey_avoidance' | 'par3_average' | 'par4_average' | 'par5_average' | 'sg_par3' | 'sg_par4' | 'sg_par5' | 'earnings' | 'cup_points' | 'wins' | 'top_tens' | 'driving_distance' | 'driving_accuracy' | 'greens_in_regulation' | 'putts_per_gir', required: The stat to rank.
  - `season` union, required: Season year, e.g. 2025.
    - string
    - number
  - `min` integer: Minimum sample: rounds (default 40), starts (1) or tournaments with a stat line (8).
  - `limit` integer: Max players (default 25).
  - `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
    - `stat` string, required
    - `label` string, required
    - `season` number, required
    - `minimum` number, required
    - `minimum_of` string, required
    - `leaders` 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)