---
title: "GET /event/{event_key}/rankings"
method: GET
path: "/event/{event_key}/rankings"
tags: ["event"]
---

# GET /event/{event_key}/rankings

`GET /event/{event_key}/rankings`

## Request

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

Gets a list of team rankings for the Event.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- EventRanking
  - `rankings` object[], required: List of rankings at the event.
    - `matches_played` integer, required: Number of matches played by this team.
    - `qual_average` number, nullable, required: The average match score during qualifications. Year specific. May be null if not relevant for a given year.
    - `extra_stats` number[], required: Additional special data on the team's performance calculated by TBA.
    - `sort_orders` number[], required: Additional year-specific information. See parent `sort_order_info` for details.
    - `record` WLTRecord, required: A Win-Loss-Tie record for a team, or an alliance.
      - `losses` integer, required: Number of losses.
      - `wins` integer, required: Number of wins.
      - `ties` integer, required: Number of ties.
    - `rank` integer, required: The team's rank at the event as provided by FIRST.
    - `dq` integer, required: Number of times disqualified.
    - `team_key` string, required: The team with this rank.
  - `extra_stats_info` object[], required: List of special TBA-generated values provided in the `extra_stats` array for each item.
    - `precision` number, required: Integer expressing the number of digits of precision in the number provided in `sort_orders`.
    - `name` string, required: Name of the field used in the `extra_stats` array.
  - `sort_order_info` object[], nullable, required: List of year-specific values provided in the `sort_orders` array for each team.
    - `precision` integer, required: Integer expressing the number of digits of precision in the number provided in `sort_orders`.
    - `name` string, required: Name of the field used in the `sort_order` array.

## Other responses

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

## Changes

- **2026-07-13** `f1e1f6cfda94`: 1 breaking
  - the `oneOf[#/components/schemas/Event_Ranking]/rankings/items/qual_average` response's property type changed from `integer, null` to `number, null` for status `200`
- **2026-04-03** `e02edcb016b7`: 5 breaking
  - added `#/components/schemas/Event_Ranking, subschema #2` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `null, object` to no type for status `200`
  - removed the required property `extra_stats_info` from the response with the `200` status
  - removed the required property `rankings` from the response with the `200` status
  - …1 more
- **2026-02-08** `cc960731dc5b`: 1 breaking
  - the response property `sort_order_info` became nullable for the status `200`
- **2025-07-02** `ccbc6f4199bd`: 2 breaking, 4 info
  - the response's body became nullable
  - the response's body type changed from no type to `null, object` for status `200`
  - removed `#/components/schemas/Event_Ranking` from the response body `allOf` list for the response status `200`
  - added the required property `extra_stats_info` to the response with the `200` status
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/event/:event_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)