---
title: "GET /team/{team_key}/events/{year}/statuses"
method: GET
path: "/team/{team_key}/events/{year}/statuses"
tags: ["team", "event"]
---

# GET /team/{team_key}/events/{year}/statuses

`GET /team/{team_key}/events/{year}/statuses`

## Request

- Base URL: `https://www.thebluealliance.com/api/v3`
- URL: `https://www.thebluealliance.com/api/v3/team/{team_key}/events/{year}/statuses`
- Auth: API key in header `X-TBA-Auth-Key`
- TypeScript: <https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/docs/team/:team_key/events/:year/statuses/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets a key-value list of the event statuses for events this team has competed at in the given year.

## Path parameters

- `team_key` string, required
- `year` integer, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- object: A key-value pair of `Team_Event_Status` objects with the event key as the key.

## 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 `additionalProperties/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 `additionalProperties/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 `additionalProperties/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 `additionalProperties/` response property `oneOf` list for the response status `200`
  - the `additionalProperties/` response's property type changed from `null, object` to no type for status `200`
  - removed the optional property `additionalProperties/alliance` from the response with the `200` status
  - removed the optional property `additionalProperties/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/events/:year/statuses/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)