---
title: "GET /district/{district_key}/rankings"
method: GET
path: "/district/{district_key}/rankings"
tags: ["district", "team"]
---

# GET /district/{district_key}/rankings

`GET /district/{district_key}/rankings`

## Request

- Base URL: `https://www.thebluealliance.com/api/v3`
- URL: `https://www.thebluealliance.com/api/v3/district/{district_key}/rankings`
- Auth: API key in header `X-TBA-Auth-Key`

Gets a list of team district rankings for the given district.

## Path parameters

- `district_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- DistrictRanking[], nullable
  - `team_key` string, required: TBA team key for the team.
  - `rank` integer, required: Numerical rank of the team, 1 being top rank.
  - `rookie_bonus` integer, required: Any points added to a team as a result of the rookie bonus.
  - `point_total` integer, required: Total district points for the team.
  - `event_points` object[], required: List of events that contributed to the point total for the team.
    - `district_cmp` boolean, required: `true` if this event is a District Championship event.
    - `total` integer, required: Total points awarded at this event.
    - `alliance_points` integer, required: Points awarded for alliance selection.
    - `elim_points` integer, required: Points awarded for elimination match performance.
    - `award_points` integer, required: Points awarded for event awards.
    - `event_key` string, required: TBA Event key for this event.
    - `qual_points` integer, required: Points awarded for qualification match performance.
  - `adjustments` integer: Any points adjustments applied to the team.
  - `other_bonus` integer: Any other bonus points awarded to the team.

## Other responses

- `304`: Not Modified - Use Local Cached Value
- `401`: Authorization information is missing or invalid.
- `404`: Not Found

## Changes

- **2026-02-08** `cc960731dc5b`: 5 info
  - api tag `list` removed
  - added the optional property `items/adjustments` to the response with the `200` status
  - added the optional property `items/other_bonus` to the response with the `200` status
  - the response property `items/event_points` became required for the status `200`
  - …1 more
- **2025-07-02** `ccbc6f4199bd`: 1 breaking
  - the response's body became nullable
- **2024-09-21** `30390dd088e5`: 1 info
  - added the non-success response with the status `404`
- **2024-03-29** `7bf03129c828`: 1 info
  - added the media type `application/json` for the response with the status `401`
- **2022-11-18** `5b245377faaf`: 2 warning, 1 info
  - the optional response header `Last-Modified` removed for the status `200`
  - deleted the `header` request parameter `If-Modified-Since`
  - added the new optional `header` request parameter `If-None-Match`

[Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/district/:district_key/rankings/get.md)

---

[API](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3.md) - [All operations](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/revisions/9316d02dee32?raw)