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

## Request

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

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

## Changes

- **2026-10-03** `a32ede23975e`: 1 warning
  - added the new `pm` enum value to the `items/status/level` response property for the response status `200`
- **2026-06-08** `c26cc01880d2`: 2 breaking
  - added `#/components/schemas/PlayoffType, subschema #2` to the `items/status/playoff_type` response property `oneOf` list for the response status `200`
  - the `items/status/playoff_type` response's property type changed from `number, null` to no type, and format from `int64` to no format for status `200`
- **2026-04-03** `e02edcb016b7`: 10 breaking
  - added `#/components/schemas/WLT_Record, subschema #2` to the `items/status/current_level_record` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/WLT_Record, subschema #2` to the `items/status/record` response property `oneOf` list for the response status `200`
  - the `items/status/current_level_record` response's property type changed from `object, null` to no type for status `200`
  - the `items/status/record` response's property type changed from `object, null` to no type for status `200`
  - …6 more
- …earlier changes not shown

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