FAfanvue

Get creator's media by UUID

Changed on

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,
plus an `errorReason` when the status is `error`.
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>
get/creators/{creatorUserUuid}/media/{uuid}

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/media/{uuid}
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator, read:media

Path parameters

creatorUserUuidstring uuid required
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.

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

Changes

  • 79b9aba8a759Revision changes
    • info

      added the optional property / to the response with the status

  • 4d08f36ad6c8Revision changes
    • breaking

      the /// response's property format changed from uuid to no format for status