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

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

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

## Request

- Base URL: `https://www.thebluealliance.com/api/v3`
- URL: `https://www.thebluealliance.com/api/v3/team/{team_key}/events/{year}/simple`
- 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/simple/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets a short-form list of 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

- EventSimple[]
  - `key` string, required: TBA event key with the format yyyy[EVENT_CODE], where yyyy is the year, and EVENT_CODE is the event code of the event.
  - `name` string, required: Official name of event on record either provided by FIRST or organizers of offseason event.
  - `event_code` string, required: Event short code, as provided by FIRST.
  - `event_type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 99 | 100 | -1, required: Event Type. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/event_type.py for definitions.
  - `district` District, required
    - `abbreviation` string, required: The short identifier for the district.
    - `display_name` string, required: The long name for the district.
    - `key` string, required: Key for this district, e.g. `2016ne`.
    - `year` integer, required: Year this district participated.
    - `official_advancement_counts` object, required: The number of teams advancing to DCMP and CMP from this district, as specified in the FIRST manual.
      - `dcmp` integer, required: Number of teams advancing to the District Championship.
      - `cmp` integer, required: Number of teams advancing to the Championship.
  - `city` string, nullable, required: City, town, village, etc. the event is located in.
  - `state_prov` string, nullable, required: State or Province the event is located in.
  - `country` string, nullable, required: Country the event is located in.
  - `start_date` string, date, required: Event start date in `yyyy-mm-dd` format.
  - `end_date` string, date, required: Event end date in `yyyy-mm-dd` format.
  - `year` integer, required: Year the event data is for.

## Other responses

- `304`: Not Modified - Use Local Cached Value
- `401`: Authorization information is missing or invalid.
- `404`: Not Found

## Changes

- **2026-06-08** `c26cc01880d2`: 11 warning
  - added the new `-1.00` enum value to the `items/event_type` response property for the response status `200`
  - added the new `0.00` enum value to the `items/event_type` response property for the response status `200`
  - added the new `1.00` enum value to the `items/event_type` response property for the response status `200`
  - added the new `100.00` enum value to the `items/event_type` response property for the response status `200`
  - …7 more
- **2026-04-03** `e02edcb016b7`: 6 breaking
  - added `#/components/schemas/District, subschema #2` to the `items/district` response property `oneOf` list for the response status `200`
  - the `items/district` response's property type changed from `null, object` to no type for status `200`
  - removed the required property `items/district/abbreviation` from the response with the `200` status
  - removed the required property `items/district/display_name` from the response with the `200` status
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/team/:team_key/events/:year/simple/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)