Resolve media UUIDs for a chat message | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/chats/userUuid/messages/messageUuid/media"
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": {
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "messageUuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "mediaType": "image",
      "created_at": "2024-01-15T00:00:00.000Z",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "ownerUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
      "name": "Beach Sunset",
      "variants": [
        {
          "variantType": "main",
          "displayPosition": 0,
          "width": 1920,
          "height": 1440,
          "url": "https://media.fanvue.com/main/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        }
      ]
    }
  },
  "errors": [
    {
      "mediaUuid": "00000000-0000-0000-0000-000000000000",
      "code": "NOT_IN_MESSAGE",
      "message": "Media UUID is not attached to this message"
    }
  ]
}

Resolves means: for each requested mediaUuid, lookup that media only within the specified messageUuid, then return its chat media payload (metadata + signed variant URLs) or a per-item error.

Scope required: read:chat

The mediaUuids query parameter is required and accepts up to 20 UUIDs.

Resolves means: for each requested `mediaUuid`, lookup that media only within the specified `messageUuid`, then return its chat media payload (metadata + signed variant URLs) or a per-item error. <Info>Scope required: `read:chat`</Info> <Note>The `mediaUuids` query parameter is required and accepts up to 20 UUIDs.</Note>

Authentication

AuthorizationBearer

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

Path parameters

userUuidstringRequiredformat: "uuid"

messageUuidstringRequiredformat: "uuid"

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Query parameters

mediaUuidsstringRequired

Comma-separated list of media UUIDs to resolve (required, max 20)

variantsstringOptional

Optional comma-separated list of variant types to include

Response

Resolved media payload map

resultsmap from strings to objects

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

errorslist of objects