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

# GET /event/{event_key}/playoff_advancement

`GET /event/{event_key}/playoff_advancement`

Gets a list of playoff advancement levels for the given Event. For round robin (6-alliance) playoffs the first entry is the Round Robin Semifinals standings; the last entry is the finals bracket. Returns an empty list for events without computed playoff advancement.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- PlayoffAdvancement[]
  - `level` string, required — Machine-readable level identifier (eg `sf`, `f1`).
  - `level_name` string, required — Human-readable level name (eg `Round Robin Semifinals`, `Finals`).
  - `type` string, required — Advancement level type (eg `round_robin`, `best_of_3`, `double_elim`, `average_score`).
  - `rankings` PlayoffAdvancementAllianceRank[], nullable — Ranked alliances for this level.
    - `team_keys` string[], required — Team keys (eg `frc254`) making up the alliance.
    - `alliance_name` string, required — Name of the alliance (eg `Turing`, `Alliance 1`).
    - `alliance_color` string, nullable — For bracket levels, `red` or `blue`. Absent for round robin standings.
    - `rank` integer, nullable — 1-indexed rank within the advancement level. Absent for bracket levels.
    - `record` WLTRecord — 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.
    - `matches_played` integer, required — Number of matches the alliance played at this level.
    - `sort_orders` number[], required — Values used to rank alliances, described by the level's `sort_order_info`. For round robin: Champ Points followed by per-year tiebreakers.
    - `extra_stats` number[], required — Additional per-alliance values, described by the level's `extra_stats_info`. For round robin: `1` if the alliance advances to the finals, else `0`.
  - `sort_order_info` PlayoffAdvancementSortOrderInfo[], required — Describes each element of every ranking's `sort_orders` array, in order.
    - `name` string, required — Human-readable name of the sort order or extra stat.
    - `type` 'int' | 'bool', required — Data type of the corresponding value.
    - `precision` integer, required — Number of decimal places to display for the value.
  - `extra_stats_info` PlayoffAdvancementSortOrderInfo[], required — Describes each element of every ranking's `extra_stats` array, in order.
    - `name` string, required — Human-readable name of the sort order or extra stat.
    - `type` 'int' | 'bool', required — Data type of the corresponding value.
    - `precision` integer, required — Number of decimal places to display for the value.

## Other responses

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

## Changes

- **2026-09-07** `1652077a3edb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/event/:event_key/playoff_advancement/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/1652077a3edb?raw)