---
title: "Get creator's media by UUID"
method: GET
path: "/creators/{creatorUserUuid}/media/{uuid}"
---

# Get creator's media by UUID

`GET /creators/{creatorUserUuid}/media/{uuid}`

Returns a specific media item by its UUID for the specified creator.

    For media with status other than FINALISED, only uuid and status are returned.
    For FINALISED media, all details including variants are included.

    <Warning>Media URLs are only available through variants.
    Specify the `variants` query parameter (e.g., `?variants=main,thumbnail,blurred`)
    to include them in the response. Without this parameter, the `variants` field
    will be an empty array and no media URLs will be returned.</Warning>

## Path parameters

- `creatorUserUuid` string, uuid, required
- `uuid` string, uuid, required

## Query parameters

- `purchasedBy` string, uuid — UUID of the user to check media purchase against. When provided, the media item will include a purchasedByFan boolean indicating if that user has purchased it.
- `variants` MediaVariantType[] — Comma-separated list of media variant types

## Headers

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

## Response `200`

Media item

- 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

## 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)