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

# GET /event/{event_key}/alliances

`GET /event/{event_key}/alliances`

Gets a list of Elimination Alliances for the given Event.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- EliminationAlliance[], nullable
  - `name` string — Alliance name.
  - `backup` object, nullable — Backup team called in, may be null.
    - `in` string, required — Team key that was called in as the backup.
    - `out` string, required — Team key that was replaced by the backup team.
  - `declines` string[], required — List of teams that declined the alliance.
  - `picks` string[], required — List of team keys picked for the alliance. First pick is captain.
  - `status` object
    - `playoff_average` number, double, nullable — Average match score during playoffs. Year specific. May be null.
    - `playoff_type` 1 | 0 | 2 | 9 | 3 | 4 | 5 | 10 | 11 | 6 | 7 | 8, required — Playoff bracket format. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/playoff_type.py for definitions.
    - `level` 'qm' | 'ef' | 'qf' | 'sf' | 'f', required — The competition level the match was played at.
    - `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.
    - `current_level_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.
    - `status` 'eliminated' | 'playing' | 'won', required — Status of the alliance.
    - `advanced_to_round_robin_finals` boolean — Whether the alliance advanced to round robin finals.
    - `double_elim_round` 'Finals' | 'Round 1' | 'Round 2' | 'Round 3' | 'Round 4' | 'Round 5' — Double elimination round, if applicable.
    - `round_robin_rank` integer — Rank in round robin play.

## 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)