---
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`

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

---

[API](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3.md) · [All operations](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thebluealliance/the-blue-alliance-api-v3/revisions/b9b0f447dbcb/schema)