---
title: "List media in folder"
method: GET
path: "/vault/folders/{folderName}/media"
---

# List media in folder

`GET /vault/folders/{folderName}/media`

Returns a paginated list of media items in the specified folder.

## Path parameters

- `folderName` string, required — Folder name (URL-encoded in path)

## Query parameters

- `page` integer — Page number to retrieve (starts from 1)
- `size` integer — Number of items to return per page (1-50, default: 15)
- `mediaType` 'image' | 'video' | 'audio' | 'document'
- `name` string — Case-insensitive substring match on the media name.
- `startDate` string, date-time — Filter to media created on or after this ISO 8601 datetime (with optional timezone offset, e.g. 2024-10-20T00:00:00Z).
- `endDate` string, date-time — Filter to media created before this ISO 8601 datetime (non-inclusive, with optional timezone offset).
- `variants` MediaVariantType[] — Comma-separated list of media variant types
- `sort` 'createdAt' | 'addedAt' — Field to sort media by. Defaults to createdAt (media creation time).
- `order` 'asc' | 'desc' — Sort direction. Defaults to desc.

## Headers

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

## Response `200`

List of media in folder

- object
  - `data` union[], required — Array of media items
    - union
      - object
        - `uuid` string, uuid, required
        - `status` 'created' | 'processing' | 'ready' | 'error', required
      - object
        - `uuid` string, uuid, required
        - `status` 'created' | 'processing' | 'ready' | 'error', required
        - `createdAt` string, date, nullable, required
        - `url` string
        - `caption` string, nullable, required
        - `description` string, nullable, required
        - `name` string, nullable, required
        - `mediaType` 'image' | 'video' | 'audio' | 'document', required
        - `recommendedPrice` number, nullable, required
        - `variants` object[]
          - `uuid` string, uuid, required
          - `variantType` 'blurred' | 'main' | 'thumbnail' | 'thumbnail_gallery', required
          - `displayPosition` number, required
          - `url` string
          - `width` number, nullable, required
          - `height` number, nullable, required
          - `lengthMs` number, nullable, required
        - `purchasedByFan` boolean
        - `tags` object, nullable — Structured AI content tags. Only populated when the owning creator has AI content tagging enabled and the media has been processed; null otherwise.
          - `description` string, nullable, required — AI-generated natural language description
          - `tags` string[], required — General content tags
          - `nsfwCategory` string[], required — NSFW classification labels
          - `sexActs` string[], required
          - `bodyParts` string[], required
          - `people` string[], required
          - `sexObjects` string[], required
          - `setting` string[], required — Scene / environment tags
          - `position` string[], required
          - `skinColor` string[], required
          - `bodyType` string[], required
          - `hairColor` string[], required
          - `otherTags` string[], required
          - `importantTags` string[], required — Tags the model marked as salient
          - `isNsfw` boolean, required
          - `mediaType` 'image' | 'video', required
  - `pagination` object, required — Pagination information
    - `page` number, required — Current page number
    - `size` number, required — Number of records returned in this response
    - `hasMore` boolean, required — Whether there are more items available on subsequent pages

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Not Found Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)