Get media by UUID

import requests
url = "https://api.fanvue.com/media/uuid"
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "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 authenticated user.

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.

Scope required: read:media

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. <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>Scope required: `read:media`</Info>

Authentication

AuthorizationBearer

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

Path parameters

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

Authentication

Path parameters

Headers

Query parameters

Response

Errors