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

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

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

Gets a short-form list of matches for the given team and year.

## Path parameters

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

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- MatchSimple[]
  - `key` string, required — TBA match key with the format `yyyy[EVENT_CODE]_[COMP_LEVEL]m[MATCH_NUMBER]`, where `yyyy` is the year, and `EVENT_CODE` is the event code of the event, `COMP_LEVEL` is (qm, ef, qf, sf, f), and `MATCH_NUMBER` is the match number in the competition level. A set number may append the competition level if more than one match in required per set.
  - `comp_level` 'qm' | 'ef' | 'qf' | 'sf' | 'f', required — The competition level the match was played at.
  - `set_number` integer, required — The set number in a series of matches where more than one match is required in the match series.
  - `match_number` integer, required — The match number of the match in the competition level.
  - `alliances` object, required — A list of alliances, the teams on the alliances, and their score.
    - `red` MatchAlliance, required
      - `score` integer, required — Score for this alliance. Will be -1 for an unplayed match.
      - `team_keys` string[], required
      - `surrogate_team_keys` string[], required — TBA team keys (eg `frc254`) of any teams playing as a surrogate.
      - `dq_team_keys` string[], required — TBA team keys (eg `frc254`) of any disqualified teams.
    - `blue` MatchAlliance, required
      - `score` integer, required — Score for this alliance. Will be -1 for an unplayed match.
      - `team_keys` string[], required
      - `surrogate_team_keys` string[], required — TBA team keys (eg `frc254`) of any teams playing as a surrogate.
      - `dq_team_keys` string[], required — TBA team keys (eg `frc254`) of any disqualified teams.
  - `winning_alliance` 'red' | 'blue' | '', required — The color of an alliance, or an empty string when there is no winning alliance (e.g. tie or no result). See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/alliance_color.py for red/blue definitions.
  - `event_key` string, required — Event key of the event the match was played at.
  - `time` integer, nullable, required — UNIX timestamp (seconds since 1-Jan-1970 00:00:00) of the scheduled match time, as taken from the published schedule.
  - `predicted_time` integer, nullable, required — UNIX timestamp (seconds since 1-Jan-1970 00:00:00) of the TBA predicted match start time.
  - `actual_time` integer, nullable, required — UNIX timestamp (seconds since 1-Jan-1970 00:00:00) of actual match start time.

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