---
title: "GET /team/{team_key}/awards"
method: GET
path: "/team/{team_key}/awards"
tags: ["team"]
---

# GET /team/{team_key}/awards

`GET /team/{team_key}/awards`

## Request

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

Gets a list of awards the given team has won.

## Path parameters

- `team_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- Award[]
  - `name` string, required: The name of the award as provided by FIRST. May vary for the same award type.
  - `award_type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83, required: Type of award given. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/award_type.py for full definitions.
  - `event_key` string, required: The event_key of the event the award was won at.
  - `recipient_list` AwardRecipient[], required: A list of recipients of the award at the event. May have either a team_key or an awardee, both, or neither (in the case the award wasn't awarded at the event).
    - `team_key` string, nullable, required: The TBA team key for the team that was given the award. May be null.
    - `awardee` string, nullable, required: The name of the individual given the award. May be null.
  - `year` integer, required: The year this award was won.

## Other responses

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

## Changes

- **2026-06-08** `c26cc01880d2`: 84 warning
  - added the new `0.00` enum value to the `items/award_type` response property for the response status `200`
  - added the new `1.00` enum value to the `items/award_type` response property for the response status `200`
  - added the new `10.00` enum value to the `items/award_type` response property for the response status `200`
  - added the new `11.00` enum value to the `items/award_type` response property for the response status `200`
  - …80 more
- **2024-09-21** `30390dd088e5`: 2 breaking, 3 info
  - the response property `items/recipient_list/items/awardee` became nullable for the status `200`
  - the response property `items/recipient_list/items/team_key` became nullable for the status `200`
  - added the non-success response with the status `404`
  - the response property `items/recipient_list/items/awardee` became required for the status `200`
  - …1 more
- **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 history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/team/:team_key/awards/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)