---
title: "Team Elo rating, league rank, and league context (all rated leagues)"
method: GET
path: "/v1/teams/{id}/elo"
tags: ["teams"]
---

# Team Elo rating, league rank, and league context (all rated leagues)

`GET /v1/teams/{id}/elo`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/teams/{id}/elo`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Standalone Elo lookup for one team: current rating, the team rank within
its own league (ROW_NUMBER by Elo descending), and league context (name,
abbreviation, logo, league, sport). Works for any rated league: NCAAF,
NCAAF FCS, NFL, NBA, NHL, MLB, the five European domestic football
leagues, and WC2026 national teams. Always 200 when
the team exists; an unrated team (below the min-games guard or a
non-rated league) returns null rating fields with a pending note.
5-minute Redis cache.

## Path parameters

- `id` string, uuid, required

## Response `200`

ok

- object
  - `data` object
    - `team_id` string, uuid
    - `name` string
    - `abbreviation` string, nullable
    - `logo_url` string, nullable
    - `sport` string, nullable
    - `league` string, nullable
    - `elo_rating` number, nullable: Rounded to 1 decimal; null when unrated
    - `elo_rank` integer, nullable: Rank by Elo descending within the team's league
    - `games_counted` integer, nullable
    - `last_computed` string, date-time, nullable
    - `note` string, nullable: Pending message when the team is unrated; null otherwise
  - `meta` object
    - `cached` boolean
    - `cache_age_ms` integer

## Other responses

- `400`: invalid team id (must be a UUID)
- `404`: team not found

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)