---
title: "Official UFC weight-class + pound-for-pound rankings (Growth+)"
method: GET
path: "/v1/ufc/rankings"
tags: ["UFC"]
---

# Official UFC weight-class + pound-for-pound rankings (Growth+)

`GET /v1/ufc/rankings`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/ufc/rankings`
- Auth: API key in header `X-PlayCaller-Key`

ESPN's own consensus rankings across all 12 weight classes plus men's/women's pound-for-pound, refreshed every 12h. Omit `division` to list available divisions; pass a partial name match (e.g. `Lightweight`) to get ranked fighters.

**Tier access:** Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `division` string

## Response `200`

UFC rankings or division list

- object
  - `success` boolean
  - `endpoint` string
  - `available_divisions` string[]: Present only when division param is omitted
  - `division` string: Present only when division param is given
  - `count` integer
  - `data` object[]
    - `rank` integer
    - `previous_rank` integer, nullable
    - `trend` string, nullable
    - `fighter_name` string
    - `record` string, nullable
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `402`: Growth tier or higher required
- `404`: No division matched
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)