Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "text": "Hey there! How are you doing?",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "sender": {
        "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "handle": "sarah-jones",
        "nickname": "SarahK",
        "displayName": "Sarah Jones",
        "isTopSpender": true,
        "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
        "registeredAt": "2024-01-10T12:00:00.000Z"
      },
      "recipient": {
        "uuid": "3bbe6394-2830-4646-a8ba-4a0a05426947",
        "handle": "johnny-doey",
        "nickname": "JohnnyD",
        "displayName": "Johnny Doey",
        "isTopSpender": true,
        "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
        "registeredAt": "2024-01-10T12:00:00.000Z"
      },
      "hasMedia": false,
      "mediaType": null,
      "mediaUuids": [],
      "type": "SINGLE_RECIPIENT",
      "pricing": null,
      "purchasedAt": null,
      "sentByUserId": null,
      "isRead": true
    },
    {
      "uuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "text": "I'm doing great! Thanks for asking.",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "sender": {
        "uuid": "3bbe6394-2830-4646-a8ba-4a0a05426947",
        "handle": "johnny-doey",
        "nickname": "JohnnyD",
        "displayName": "Johnny Doey",
        "isTopSpender": true,
        "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
        "registeredAt": "2024-01-10T12:00:00.000Z"
      },
      "recipient": {
        "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "handle": "sarah-jones",
        "nickname": "SarahK",
        "displayName": "Sarah Jones",
        "isTopSpender": true,
        "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
        "registeredAt": "2024-01-10T12:00:00.000Z"
      },
      "hasMedia": true,
      "mediaType": "image",
      "mediaUuids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ],
      "type": "SINGLE_RECIPIENT",
      "pricing": {
        "USD": {
          "price": 500
        }
      },
      "purchasedAt": "2024-01-15T00:00:00.000Z",
      "sentByUserId": null,
      "isRead": true
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

Returns a paginated list of text messages between the authenticated user and the specified user. Messages are ordered by creation date (newest first).

Scope required: read:chat

Returns a paginated list of text messages between the authenticated user and the specified user. Messages are ordered by creation date (newest first). <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"

Headers

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

API version to use for the request

Query parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

Number of items to return per page (1-50, default: 15)

markAsReadenumOptionalDefaults to true

Whether to mark the chat as read after retrieving messages

Allowed values:

Response

List of messages

datalist of objects

Array of messages in the conversation

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

429

Too Many Requests Error