---
title: "List Media"
method: GET
path: "/medias"
tags: ["Media"]
---

# List Media

`GET /medias`

## Request

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

Lists the media belonging to the account. This endpoint can also be used to
do a batch fetch based off of the 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.

## Query parameters

- `page` integer
- `per_page` integer
- `cursor` object
  - `enabled` 0 | 1: If `cursor[enabled]` is set to 1, the first result set will be fetched with cursor pagination enabled. This values is ignored if `cursor[before]` or `cursor[after]` are set.
  - `before` string: If `cursor[before]` is set then cursor pagination is enabled and all records before the cursor up to the `per_page` are returned. This feature is useful for fetching "new records", for example, in a "pull to refersh" feature when showing records in a descending order.
  - `after` string: If `cursor[after]` is set then cursor pagination is enabled and all records after the cursor up to the `per_page` are returned.
- `sort_by` 'name' | 'created' | 'updated' | 'position'
- `sort_direction` 0 | 1
- `folder_id` string: Hashed ID of the folder (e.g., "4d23503f70")
- `name` string
- `description_format` 'markdown'
- `include` 'speakers'
- `type` 'Video' | 'Audio' | 'Image' | 'PdfDocument' | 'MicrosoftOfficeDocument' | 'Swf' | 'UnknownType'
- `hashed_ids[]` string[]
- `tags[]` string[]
- `archived` boolean

## Headers

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

## Response `200`

Successful response

- object[]
  - `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.
  - `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]`.

## Other responses

- `400`: Bad request
- `401`: Unauthorized, invalid or missing token
- `500`: Internal server error

## Changes

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

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/medias/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)