---
title: "Show Media"
method: GET
path: "/medias/{mediaHashedId}"
tags: ["Media"]
---

# Show Media

`GET /medias/{mediaHashedId}`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/medias/{mediaHashedId}`
- Auth: HTTP bearer

Fetches a single media by its hashed id.

## Requires api token with one of the following permissions
```
Read all folder and media data
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization for this media can also be used; any permission granted on a
media allows showing it.

## Path parameters

- `mediaHashedId` string, required: Hashed ID of the media (e.g., "4d23503f70")

## Query parameters

- `description_format` 'markdown'
- `include` 'speakers'

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Successful response

- object: A media generally represents a video or an audio which can be embedded into your website. CDN-backed medias are accessible using this url structure: https://fast.wistia.com/embed/medias/{hashed_id}.m3u8. For more information, see https://docs.wistia.com/docs/asset-urls#getting-hls-assets.
  - `id` integer: A unique numeric identifier for the media within the system.
  - `name` string: The display name of the media.
  - `type` 'Video' | 'Audio' | 'Image' | 'PdfDocument' | 'MicrosoftOfficeDocument' | 'Swf' | 'UnknownType': A string representing what type of media this is.
  - `archived` boolean: Whether or not the media is archived, either true or false.
  - `created` string, date-time: The date when the media was originally uploaded.
  - `updated` string, date-time: The date when the media was last changed.
  - `duration` number, nullable: Specifies the length (in seconds) for audio and video files. Specifies number of pages in the document. Omitted for other types of media.
  - `embedCode` string: DEPRECATED: If you want to programmatically embed videos, follow the construct an embed code guide.
  - `hashed_id` string: A unique alphanumeric identifier for this media.
  - `description` string: A description for the media which usually appears near the top of the sidebar on the media's page.
  - `progress` number: A floating point value between 0 and 1 that indicates the progress of the processing for this file.
  - `status` 'queued' | 'processing' | 'ready' | 'failed': Post upload processing status. - `queued`: the file is waiting in the queue to be processed. - `processing`: the file is actively being processed. - `ready`: the file has been fully processed and is ready for embedding and viewing. - `failed`: the file was unable to be processed (usually a format or size error).
  - `section` string, nullable: The title of the section in which the media appears. This attribute is omitted if the media is not in a section (default).
  - `thumbnail` object
    - `url` string
    - `width` integer
    - `height` integer
  - `protected` boolean, nullable: Whether the media is protected (e.g. requires a password or other authentication to view). Null if the media is not protected.
  - `folder` object, nullable, required
    - `id` integer: A unique numeric identifier for the folder within the system.
    - `name` string: The folder’s display name.
    - `hashed_id` string: A private hashed id, uniquely identifying the folder within the system.
  - `assets` object[]: An array of the assets available for this media.
    - `url` string: A direct-access URL to the content of the asset.
    - `width` integer, nullable: The width of this specific asset, if applicable.
    - `height` integer, nullable: The height of this specific asset, if applicable.
    - `file_size` integer, nullable: The size of the asset file that’s referenced by url, measured in bytes.
    - `content_type` string, nullable: The asset’s content type.
    - `type` string: The internal type of the asset, describing how the asset should be used. Values can include OriginalFile, FlashVideoFile, MdFlashVideoFile, HdFlashVideoFile, Mp4VideoFile, MdMp4VideoFile, HdMp4VideoFile, IPhoneVideoFile, StillImageFile, SwfFile, Mp3AudioFile, and LargeImageFile.
  - `subfolder` object: A subfolder within a folder that contains media.
    - `hashed_id` string, nullable, required: A unique alphanumeric identifier for this subfolder.
    - `name` string, nullable: The display name of the subfolder.
    - `description` string, nullable: A description for the subfolder.
    - `position` integer, nullable, required: The position of this subfolder within its folder, used for ordering.
    - `created` string, date-time, nullable, required: The date when the subfolder was created.
    - `updated` string, date-time, nullable, required: The date when the subfolder was last modified.
    - `cursor` string, nullable: A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.
  - `tags` object[]: Tags associated with this media.
    - `name` string: The display name of the tag.
  - `speakers` object[]: Active transcript speaker assignments used for diarization. Webinar hosts and panelists are not included. Present when `include=speakers` is requested.
    - `media_speaker_id` string, required: The unique identifier for this transcript speaker assignment on the media.
    - `speaker_profile_id` string, required: The reusable account speaker profile assigned to the transcript speaker.
    - `name` string, required: The assigned speaker profile's display name.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/medias/:mediaHashedId/get.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)