Skip to main content
GET
/
chats
/
{userUuid}
/
messages
/
{messageUuid}
/
media
Resolve media UUIDs for a chat message
curl --request GET \
  --url https://api.fanvue.com/chats/{userUuid}/messages/{messageUuid}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "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,
          "url": "https://media.fanvue.com/main/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
          "width": 1920,
          "height": 1440,
          "lengthMs": null
        }
      ]
    },
    "00000000-0000-0000-0000-000000000000": null
  },
  "errors": [
    {
      "mediaUuid": "00000000-0000-0000-0000-000000000000",
      "code": "NOT_IN_MESSAGE",
      "message": "Media UUID is not attached to this message"
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

userUuid
string<uuid>
required
messageUuid
string<uuid>
required

Query Parameters

mediaUuids
string
required

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

variants
string

Optional comma-separated list of variant types to include

Response

Resolved media payload map

results
object
required

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

errors
object[]
required