---
title: "GET /event/{event_key}/media"
method: GET
path: "/event/{event_key}/media"
tags: ["event"]
---

# GET /event/{event_key}/media

`GET /event/{event_key}/media`

Gets a list of media objects associated with this event itself (e.g. SmugMug photo galleries and event videos), as opposed to media belonging to the event's teams.

## Path parameters

- `event_key` string, 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 info
  - endpoint added

[Change history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/event/:event_key/media/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/1652077a3edb?raw)