latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get media by UUID

Returns a specific media item by its UUID for the authenticated user.

For media with status other than FINALISED, only uuid and status are returned.
For FINALISED media, all details including variants are included, plus a
`tags` field containing structured AI content tags when the owning
creator has AI content tagging enabled and the media has been processed
(`null` otherwise).

<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>
get/media/{uuid}

Path parameters

uuidstring uuid required

Query parameters

purchasedBystring 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.

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.

variantsMediaVariantType[]

Comma-separated list of media variant types

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Media item

OR