Get media from a chat

curl https://api.fanvue.com/chats/userUuid/media \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "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,
          "width": 1920,
          "height": 1440,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/main/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        },
        {
          "variantType": "thumbnail_gallery",
          "displayPosition": 0,
          "width": 400,
          "height": 300,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/gallery/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        }
      ]
    },
    {
      "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,
          "width": 1920,
          "height": 1080,
          "lengthMs": 45000,
          "url": "https://media.fanvue.com/main/b2c3d4e5-f6a7-8901-bcde-f12345678901.mp4"
        },
        {
          "variantType": "thumbnail",
          "displayPosition": 0,
          "width": 1920,
          "height": 1080,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/thumb/b2c3d4e5-f6a7-8901-bcde-f12345678901.jpg"
        }
      ]
    }
  ],
  "nextCursor": "eyJzZW50QmVmb3JlIjoiMjAyNC0wMS0wOVQxMjowMDowMC4wMDBaIiwicmVjZWl2ZWRCZWZvcmUiOiIyMDI0LTAxLTA5VDExOjU4OjAwLjAwMFoifQ=="
}

Returns a cursor-paginated list of media items shared between the authenticated user and the specified user. Media is extracted from chat messages and ordered by date (newest first).

Pagination Flow:

First request: Omit the cursor parameter, returns first 20 media items (or specified limit)
Subsequent requests: Use the nextCursor from the previous response
End of results: nextCursor will be null

1 {
2   "data": [...media items...],
3   "nextCursor": "..." // Pass this to the next request to get the following page
4 }

Scope required: read:chat

Returns a cursor-paginated list of media items shared between the authenticated user and the specified user. Media is extracted from chat messages and ordered by date (newest first). **Pagination Flow:** - First request: Omit the `cursor` parameter, returns first 20 media items (or specified limit) - Subsequent requests: Use the `nextCursor` from the previous response - End of results: `nextCursor` will be `null` ```json { "data": [...media items...], "nextCursor": "..." // Pass this to the next request to get the following page } ``` <Info>Scope required: `read:chat`</Info>

Authentication

AuthorizationBearer

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

Path parameters

userUuidstringRequiredformat: "uuid"

Query parameters

cursorstringOptional

Cursor for fetching the next page of media

mediaTypeenumOptional

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

Allowed values:

limitdoubleOptional1-50Defaults to 20

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

Response

Cursor-paginated list of media items

datalist of objects

nextCursorstring or null

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

Authentication

Path parameters

Headers

Query parameters

Response

Errors

1	{
2	"data": [...media items...],
3	"nextCursor": "..." // Pass this to the next request to get the following page
4	}