Get creator's media by UUID | Fanvue API Documentation

curl https://api.fanvue.com/creators/creatorUserUuid/media/uuid \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "uuid": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
  "status": "ready",
  "createdAt": "2024-01-15T00:00:00.000Z",
  "caption": "Sunset at the beach",
  "description": {},
  "name": "beach-sunset.jpg",
  "mediaType": "image",
  "recommendedPrice": {},
  "variants": [
    {
      "uuid": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
      "variantType": "main",
      "displayPosition": 0,
      "url": "https://media.fanvue.com/main/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
      "width": 3840,
      "height": 2160
    },
    {
      "uuid": "d0e1f2a3-4b5c-6d7e-8f9a-0b1c2d3e4f5a",
      "variantType": "thumbnail",
      "displayPosition": 1,
      "url": "https://media.fanvue.com/thumb/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
      "width": 320,
      "height": 180
    },
    {
      "uuid": "e1f2a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "variantType": "thumbnail_gallery",
      "displayPosition": 2,
      "url": "https://media.fanvue.com/gallery/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
      "width": 400,
      "height": 300
    },
    {
      "uuid": "f2a3b4c5-6d7e-8f9a-0b1c-2d3e4f5a6b7c",
      "variantType": "blurred",
      "displayPosition": 3,
      "url": "https://media.fanvue.com/blur/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
      "width": 3840,
      "height": 2160
    }
  ]
}

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.

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.

Scopes required: read:creator, read:media

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> <Info>Scopes required: `read:creator`, `read:media`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

uuidstringRequiredformat: "uuid"

Query parameters

purchasedBystringOptionalformat: "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.

variantslist of enumsOptional

Allowed values:

Response

Media item

object

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors