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

# GET /team/{team_key}/media/{year}

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

## Request

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

Gets a list of Media (videos / pictures) for the given team and year.

## Path parameters

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

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- Media[]
  - union: The `Media` object contains a reference for most any media associated with a team or event on TBA.
    - MediaAvatar
      - `type` 'avatar', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `base64Image` string, required
    - MediaCdPhotoThread
      - `type` 'cdphotothread', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `image_partial` string, required
    - MediaCdThread
      - `type` 'cd-thread', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `thread_title` string, required
        - `image_url` string, nullable, required
    - MediaGrabCad
      - `type` 'grabcad', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `model_created` string, date-time, nullable, required
        - `model_description` string, nullable, required
        - `model_image` string, uri, required
        - `model_name` string, required
    - MediaNoDetails
      - `type` 'youtube' | 'imgur' | 'facebook-profile' | 'youtube-channel' | 'twitter-profile' | 'github-profile' | 'instagram-profile' | 'periscope-profile' | 'gitlab-profile' | 'instagram-image' | 'external-link', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
    - MediaOnshape
      - `type` 'onshape', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `model_created` string, date-time, nullable, required
        - `model_description` string, nullable, required
        - `model_image` string, uri, required
        - `model_name` string, required
    - MediaSmugmugAlbum
      - `type` 'smugmug-album', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `cover_url` string, uri, required
        - `cover_url_med` string, uri, required
        - `cover_url_sm` string, uri, required
        - `image_count` integer, required
        - `title` string, required
        - `web_uri` string, uri, required
    - MediaSmugmugPhoto
      - `type` 'smugmug-photo', required: String type of the media element.
      - `foreign_key` string, required: The key used to identify this media on the media site.
      - `preferred` boolean: True if the media is of high quality.
      - `team_keys` string[], required: List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string: Direct URL to the media.
      - `view_url` string: The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `caption` string, required
        - `image_url` string, uri, required
        - `image_url_med` string, uri, required
        - `image_url_sm` string, uri, required
        - `title` string, required
        - `web_uri` string, uri, required

## Other responses

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

## Changes

- **2026-09-07** `1652077a3edb`: 2 breaking
  - the response property `items/oneOf[#/components/schemas/Media_GrabCad]/allOf[subschema #2]/details/model_created` became nullable for the status `200`
  - the response property `items/oneOf[#/components/schemas/Media_Onshape]/allOf[subschema #2]/details/model_created` became nullable for the status `200`
- **2026-09-06** `9702839beafd`: 1 breaking, 12 warning, 1 info
  - added `#/components/schemas/Media_SmugmugAlbum, #/components/schemas/Media_SmugmugPhoto` to the `items/` response property `oneOf` list for the response status `200`
  - added the new `smugmug-album` enum value to the `items/oneOf[#/components/schemas/Media_Avatar]/allOf[#/components/schemas/Media_Base]/type` response property for the response status `200`
  - added the new `smugmug-album` enum value to the `items/oneOf[#/components/schemas/Media_CdPhotoThread]/allOf[#/components/schemas/Media_Base]/type` response property for the response status `200`
  - added the new `smugmug-album` enum value to the `items/oneOf[#/components/schemas/Media_CdThread]/allOf[#/components/schemas/Media_Base]/type` response property for the response status `200`
  - …10 more
- …earlier changes not shown

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