Skip to main content
GET
/
chats
/
{userUuid}
/
media
Get media from a chat
curl --request GET \
  --url https://api.example.com/chats/{userUuid}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "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
        },
        {
          "variantType": "thumbnail_gallery",
          "displayPosition": 0,
          "url": "https://media.fanvue.com/gallery/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
          "width": 400,
          "height": 300,
          "lengthMs": null
        }
      ]
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "messageUuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "mediaType": "video",
      "created_at": "2024-01-14T00:00:00.000Z",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "ownerUuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "name": "Cooking Tutorial",
      "variants": [
        {
          "variantType": "main",
          "displayPosition": 0,
          "url": "https://media.fanvue.com/main/b2c3d4e5-f6a7-8901-bcde-f12345678901.mp4",
          "width": 1920,
          "height": 1080,
          "lengthMs": 45000
        },
        {
          "variantType": "thumbnail",
          "displayPosition": 0,
          "url": "https://media.fanvue.com/thumb/b2c3d4e5-f6a7-8901-bcde-f12345678901.jpg",
          "width": 1920,
          "height": 1080,
          "lengthMs": null
        }
      ]
    }
  ],
  "nextCursor": "eyJzZW50QmVmb3JlIjoiMjAyNC0wMS0wOVQxMjowMDowMC4wMDBaIiwicmVjZWl2ZWRCZWZvcmUiOiIyMDI0LTAxLTA5VDExOjU4OjAwLjAwMFoifQ=="
}
Required scope
  • read:chat — Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

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

Query Parameters

​
cursor
string

Cursor for fetching the next page of media

​
mediaType
enum<string>

Filter by media type (image, video, audio, document)

Available options:
image,
video,
audio,
document
​
limit
number
default:20

Number of media items to return (1-50, default: 20)

Required range: 1 <= x <= 50

Response

Cursor-paginated list of media items

​
data
object[]
required
​
nextCursor
string | null
required

Cursor for fetching the next page, null if no more results