---
title: "Show Subfolder"
method: GET
path: "/folders/{folderId}/subfolders/{subfolderId}"
tags: ["Subfolders"]
---

# Show Subfolder

`GET /folders/{folderId}/subfolders/{subfolderId}`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/folders/{folderId}/subfolders/{subfolderId}`
- Auth: HTTP bearer

Retrieves detailed information about a specific subfolder, including all media contained within it.

## 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 naming this folder (any permission) can also be used. The
embedded media are limited to those the token's authorizations name.

## Path parameters

- `folderId` string, required
- `subfolderId` string, required

## Query parameters

- `description_format` 'markdown'

## Headers

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

## Response `200`

Subfolder details with contained media

- 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]`.
  - `medias` object[]: Array of media files contained in this subfolder.
    - `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.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `404`: Folder or subfolder 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/folders/:folderId/subfolders/:subfolderId/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)