---
title: "GET /team/{team_key}/event/{event_key}/status"
method: GET
path: "/team/{team_key}/event/{event_key}/status"
tags: ["team", "event"]
---

# GET /team/{team_key}/event/{event_key}/status

`GET /team/{team_key}/event/{event_key}/status`

Gets the competition rank and status of the team at the given event.

## Path parameters

- `team_key` string, required
- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- TeamEventStatus
  - `qual` TeamEventStatusRank
    - `num_teams` integer — Number of teams ranked.
    - `ranking` object, nullable
      - `matches_played` integer — Number of matches played.
      - `qual_average` number, double, nullable — For some years, average qualification score. Can be null.
      - `sort_orders` number[], nullable — Ordered list of values used to determine the rank. See the `sort_order_info` property for the name of each value.
      - `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.
      - `rank` integer, nullable — Relative rank of this team.
      - `dq` integer, nullable — Number of matches the team was disqualified for.
      - `team_key` string — TBA team key for this rank.
    - `sort_order_info` object[], nullable — Ordered list of names corresponding to the elements of the `sort_orders` array.
      - `precision` integer — The number of digits of precision used for this value, eg `2` would correspond to a value of `101.11` while `0` would correspond to `101`.
      - `name` string — The descriptive name of the value used to sort the ranking.
    - `status` string
  - `alliance` TeamEventStatusAlliance
    - `name` string, nullable — Alliance name, may be null.
    - `number` integer, required — Alliance number.
    - `backup` TeamEventStatusAllianceBackup, nullable — Backup status, may be null.
      - `out` string — TBA key for the team replaced by the backup.
      - `in` string — TBA key for the backup team called in.
    - `pick` integer, required — Order the team was picked in the alliance from 0-2, with 0 being alliance captain.
  - `playoff` TeamEventStatusPlayoff, nullable — Playoff status for this team, may be null if the team did not make playoffs, or playoffs have not begun.
    - `level` 'qm' | 'ef' | 'qf' | 'sf' | 'f' — The competition level the match was played at.
    - `current_level_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.
    - `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.
    - `status` 'won' | 'eliminated' | 'playing' — Current competition status for the playoffs.
    - `playoff_average` number, double, nullable — The average match score during playoffs. Year specific. May be null if not relevant for a given year.
  - `alliance_status_str` string — An HTML formatted string suitable for display to the user containing the team's alliance pick status.
  - `playoff_status_str` string — An HTML formatter string suitable for display to the user containing the team's playoff status.
  - `overall_status_str` string — An HTML formatted string suitable for display to the user containing the team's overall status summary of the event.
  - `next_match_key` string, nullable — TBA match key for the next match the team is scheduled to play in at this event, or null.
  - `last_match_key` string, nullable — TBA match key for the last match the team played in at this event, or null.
  - `pit_location` string, nullable — The pit location for the team at this event, or null if not available.

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