---
title: "Changes to GET /team/{team_key}/matches/{year}"
method: GET
path: "/team/{team_key}/matches/{year}"
---

# Changes to GET /team/{team_key}/matches/{year}

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 28 revisions.

- **2026-10-03** `a32ede23975e`: 1 warning
- **2026-07-26** `9a7cbeb48787`: 16 breaking
- **2026-06-08** `c26cc01880d2`: 1 breaking, 4 info
- **2026-04-03** `e02edcb016b7`: 2 breaking
- **2026-02-08** `cc960731dc5b`: 8 breaking, 510 warning, 384 info
- **2025-07-02** `ccbc6f4199bd`: 1 breaking
- **2025-04-01** `f3e7de9ca46b`: 3 breaking, 6 warning
- **2024-09-21** `30390dd088e5`: 7 breaking, 17 info
- **2024-03-29** `7bf03129c828`: 1 info
- **2022-11-18** `5b245377faaf`: 2 warning, 1 info
- **2020-03-06** `a78c0ff8885f`: 1 info

## Changes

- **2026-10-03** `a32ede23975e`: 1 warning
  - added the new `pm` enum value to the `items/comp_level` response property for the response status `200`
- **2026-07-26** `9a7cbeb48787`: 16 breaking
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2019]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2019]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2020]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2020]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2022]/blue/rp` response's property type changed from `integer, null` to `number, null` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2022]/red/rp` response's property type changed from `integer, null` to `number, null` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2024]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2024]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2025]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2025]/red/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2026]/blue/rp` response's property type changed from `integer` to `number` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2026]/red/rp` response's property type changed from `integer` to `number` for status `200`
- **2026-06-08** `c26cc01880d2`: 1 breaking, 4 info
  - the `items/winning_alliance` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/AllianceColor` to the `items/winning_alliance` response property `allOf` list for the response status `200`
  - removed the `` enum value from the `items/winning_alliance` response property for the response status `200`
  - removed the `blue` enum value from the `items/winning_alliance` response property for the response status `200`
  - removed the `red` enum value from the `items/winning_alliance` response property for the response status `200`
- **2026-04-03** `e02edcb016b7`: 2 breaking
  - added `#/components/schemas/Match_Score_Breakdown_2026, subschema #12` to the `items/score_breakdown` response property `oneOf` list for the response status `200`
  - the `items/score_breakdown` response's property type changed from `object, null` to no type for status `200`
- **2026-02-08** `cc960731dc5b`: 8 breaking, 510 warning, 384 info
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2015]/blue/auto_points` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2015]/blue/foul_points` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2015]/red/auto_points` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2015]/red/foul_points` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2022]/blue/rp` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2022]/red/rp` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/blue/links` became nullable for the status `200`
  - the response property `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/red/links` became nullable for the status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position2` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position3` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position4` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position5` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position2` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position3` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position4` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position5` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/blue/tba_gameData` response property for the response status `200`
  - added the new `` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/red/tba_gameData` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position2` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position3` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position4` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position5` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position2` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position3` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position4` response property for the response status `200`
  - added the new `A_ChevalDeFrise` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position5` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position2` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position3` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position4` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/position5` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position2` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position3` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position4` response property for the response status `200`
  - added the new `A_Portcullis` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/position5` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/blue/autoRobot1` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/blue/autoRobot2` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/blue/autoRobot3` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/red/autoRobot1` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/red/autoRobot2` response property for the response status `200`
  - added the new `AutoRun` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2018]/red/autoRobot3` response property for the response status `200`
  - …862 more
- **2025-07-02** `ccbc6f4199bd`: 1 breaking
  - the `items/score_breakdown` response's property type changed from no type to `object, null` for status `200`
- **2025-04-01** `f3e7de9ca46b`: 3 breaking, 6 warning
  - added `#/components/schemas/Match_Score_Breakdown_2025` to the `items/score_breakdown` response property `oneOf` list for the response status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/blue/teleopTowerCaptured` response's property type changed from `integer` to `boolean` for status `200`
  - the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2016]/red/teleopTowerCaptured` response's property type changed from `integer` to `boolean` for status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/blue/endGameChargeStationRobot1` response property for the response status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/blue/endGameChargeStationRobot2` response property for the response status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/blue/endGameChargeStationRobot3` response property for the response status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/red/endGameChargeStationRobot1` response property for the response status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/red/endGameChargeStationRobot2` response property for the response status `200`
  - added the new `Park` enum value to the `items/score_breakdown/oneOf[#/components/schemas/Match_Score_Breakdown_2023]/red/endGameChargeStationRobot3` response property for the response status `200`
- **2024-09-21** `30390dd088e5`: 7 breaking, 17 info
  - the response property `items/actual_time` became nullable for the status `200`
  - the response property `items/post_result_time` became nullable for the status `200`
  - the response property `items/predicted_time` became nullable for the status `200`
  - the response property `items/score_breakdown` became nullable for the status `200`
  - the response property `items/time` became nullable for the status `200`
  - added `#/components/schemas/Match_Score_Breakdown_2015, #/components/schemas/Match_Score_Breakdown_2016, #/components/schemas/Match_Score_Breakdown_2017, #/components/schemas/Match_Score_Breakdown_2018, #/components/schemas/Match_Score_Breakdown_2019, #/components/schemas/Match_Score_Breakdown_2020, #/components/schemas/Match_Score_Breakdown_2022, #/components/schemas/Match_Score_Breakdown_2023, #/components/schemas/Match_Score_Breakdown_2024` to the `items/score_breakdown` response property `oneOf` list for the response status `200`
  - the `items/score_breakdown` response's property type changed from `object` to no type for status `200`
  - added the non-success response with the status `404`
  - the response property `items/actual_time` became required for the status `200`
  - the response property `items/alliances` became required for the status `200`
  - the response property `items/alliances/blue` became required for the status `200`
  - the response property `items/alliances/blue/dq_team_keys` became required for the status `200`
  - the response property `items/alliances/blue/surrogate_team_keys` became required for the status `200`
  - the response property `items/alliances/red` became required for the status `200`
  - the response property `items/alliances/red/dq_team_keys` became required for the status `200`
  - the response property `items/alliances/red/surrogate_team_keys` became required for the status `200`
  - the response property `items/post_result_time` became required for the status `200`
  - the response property `items/predicted_time` became required for the status `200`
  - the response property `items/score_breakdown` became required for the status `200`
  - the response property `items/time` became required for the status `200`
  - the response property `items/videos` became required for the status `200`
  - the response property `items/videos/items/key` became required for the status `200`
  - the response property `items/videos/items/type` became required for the status `200`
  - the response property `items/winning_alliance` became required for the status `200`
- **2024-03-29** `7bf03129c828`: 1 info
  - added the media type `application/json` for the response with the status `401`
- **2022-11-18** `5b245377faaf`: 2 warning, 1 info
  - the optional response header `Last-Modified` removed for the status `200`
  - deleted the `header` request parameter `If-Modified-Since`
  - added the new optional `header` request parameter `If-None-Match`
- **2020-03-06** `a78c0ff8885f`: 1 info
  - added the media type `application/json` for the response with the status `200`

---

[Operation](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/docs/team/:team_key/matches/:year/get.md) - [API](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3.md) - [Page](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/team/:team_key/matches/:year/get)
