--- 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` ## Request - Base URL: `https://www.thebluealliance.com/api/v3` - URL: `https://www.thebluealliance.com/api/v3/team/{team_key}/event/{event_key}/status` - Auth: API key in header `X-TBA-Auth-Key` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. - `playoff_type` 1 | 0 | 2 | 9 | 3 | 4 | 5 | 10 | 11 | 6 | 7 | 8: Playoff bracket format. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/playoff_type.py for definitions. - `double_elim_round` 'Finals' | 'Round 1' | 'Round 2' | 'Round 3' | 'Round 4' | 'Round 5': Double elimination round, if applicable. - `level` 'pm' | '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 ## Changes - **2026-10-11** `e33ade05393e`: 2 info - added the optional property `oneOf[#/components/schemas/Team_Event_Status]/playoff/oneOf[#/components/schemas/Team_Event_Status_playoff]/double_elim_round` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/Team_Event_Status]/playoff/oneOf[#/components/schemas/Team_Event_Status_playoff]/playoff_type` to the response with the `200` status - **2026-10-03** `a32ede23975e`: 1 warning - added the new `pm` enum value to the `oneOf[#/components/schemas/Team_Event_Status]/playoff/oneOf[#/components/schemas/Team_Event_Status_playoff]/level` response property for the response status `200` - **2026-04-03** `e02edcb016b7`: 2 breaking, 8 warning - added `#/components/schemas/Team_Event_Status, subschema #2` to the response body `oneOf` list for the response status `200` - the response's body type changed from `null, object` to no type for status `200` - removed the optional property `alliance` from the response with the `200` status - removed the optional property `alliance_status_str` from the response with the `200` status - …6 more - …earlier changes not shown [Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/team/:team_key/event/:event_key/status/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)