Get bulk media by UUIDs

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

{
  "results": {
    "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a": {
      "uuid": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
      "status": "ready",
      "createdAt": "2024-01-15T00:00:00.000Z",
      "caption": "Sunset at the beach",
      "name": "beach-sunset.jpg",
      "mediaType": "image",
      "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
        }
      ]
    }
  },
  "errors": [
    {
      "mediaUuid": "00000000-0000-0000-0000-000000000000",
      "code": "NOT_FOUND",
      "message": "Media not found"
    }
  ]
}

Returns multiple media items in a single request.

Scope required: read:media

Maximum 20 media UUIDs per request.

Returns multiple media items in a single request. <Info>Scope required: `read:media`</Info> <Note>Maximum 20 media UUIDs per request.</Note>

Authentication

AuthorizationBearer

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

Query parameters

mediaUuidsstringRequired

variantsstringOptional

Response

Bulk media response

resultsmap from strings to objects or any

Map media UUID -> media payload (null when unavailable)

errorslist of objects

Per-media errors for unresolved entries

Authentication

Headers

Query parameters

Response

Errors