Get messages from a chat

curl --request GET \
  --url https://api.example.com/chats/{userUuid}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'

import requests

url = "https://api.example.com/chats/{userUuid}/messages"

headers = {
    "X-Fanvue-API-Version": "<x-fanvue-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-Fanvue-API-Version': '<x-fanvue-api-version>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://api.example.com/chats/{userUuid}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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"
      },
      "type": "SINGLE_RECIPIENT",
      "hasMedia": false,
      "mediaType": null,
      "mediaUuids": [],
      "mediaPreviewUuid": null,
      "pricing": null,
      "purchasedAt": null,
      "tipSource": 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"
      },
      "type": "SINGLE_RECIPIENT",
      "hasMedia": true,
      "mediaType": "image",
      "mediaUuids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ],
      "mediaPreviewUuid": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "pricing": {
        "USD": {
          "price": 500
        }
      },
      "purchasedAt": "2024-01-15T00:00:00.000Z",
      "tipSource": null,
      "sentByUserId": null,
      "isRead": true
    },
    {
      "uuid": "c3d4e5f6-7890-1234-5678-9abcdef01234",
      "text": "Thanks for the tip! 💖",
      "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"
      },
      "type": "TIP",
      "hasMedia": false,
      "mediaType": null,
      "mediaUuids": [],
      "mediaPreviewUuid": null,
      "pricing": {
        "USD": {
          "price": 1000
        }
      },
      "purchasedAt": null,
      "tipSource": "post",
      "sentByUserId": null,
      "isRead": true
    },
    {
      "uuid": "d4e5f6a7-8901-2345-6789-abcdef012345",
      "text": "Check out my new exclusive content 🔥",
      "sentAt": "2024-01-14T00: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": {},
      "type": "BROADCAST",
      "hasMedia": true,
      "mediaType": "image",
      "mediaUuids": [
        "b2c3d4e5-f6a7-8901-bcde-f12345678901"
      ],
      "mediaPreviewUuid": null,
      "pricing": null,
      "purchasedAt": null,
      "tipSource": null,
      "sentByUserId": null,
      "isRead": false
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "nextVersion": "<string>"
}

{
  "error": "<string>"
}

Chats

Get messages from a chat

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

Pass beforeMessageUuid to anchor pagination to a known message and fetch the messages immediately older than it (stable keyset pagination). When supplied, beforeMessageUuid takes precedence over page; an unknown or unpublished anchor is ignored and the first page is returned.

Polling for real-time updates? Use a webhook instead.

If you are calling this endpoint on a schedule to detect new activity, subscribe to the creator.message.received, creator.message.sent, creator.message.deleted, creator.message.reaction webhook events instead — you’ll get pushed updates in real time without polling. See the webhook documentation.

GET

chats

{userUuid}

messages

Get messages from a chat

curl --request GET \
  --url https://api.example.com/chats/{userUuid}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'

import requests

url = "https://api.example.com/chats/{userUuid}/messages"

headers = {
    "X-Fanvue-API-Version": "<x-fanvue-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-Fanvue-API-Version': '<x-fanvue-api-version>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://api.example.com/chats/{userUuid}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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"
      },
      "type": "SINGLE_RECIPIENT",
      "hasMedia": false,
      "mediaType": null,
      "mediaUuids": [],
      "mediaPreviewUuid": null,
      "pricing": null,
      "purchasedAt": null,
      "tipSource": 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"
      },
      "type": "SINGLE_RECIPIENT",
      "hasMedia": true,
      "mediaType": "image",
      "mediaUuids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ],
      "mediaPreviewUuid": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "pricing": {
        "USD": {
          "price": 500
        }
      },
      "purchasedAt": "2024-01-15T00:00:00.000Z",
      "tipSource": null,
      "sentByUserId": null,
      "isRead": true
    },
    {
      "uuid": "c3d4e5f6-7890-1234-5678-9abcdef01234",
      "text": "Thanks for the tip! 💖",
      "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"
      },
      "type": "TIP",
      "hasMedia": false,
      "mediaType": null,
      "mediaUuids": [],
      "mediaPreviewUuid": null,
      "pricing": {
        "USD": {
          "price": 1000
        }
      },
      "purchasedAt": null,
      "tipSource": "post",
      "sentByUserId": null,
      "isRead": true
    },
    {
      "uuid": "d4e5f6a7-8901-2345-6789-abcdef012345",
      "text": "Check out my new exclusive content 🔥",
      "sentAt": "2024-01-14T00: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": {},
      "type": "BROADCAST",
      "hasMedia": true,
      "mediaType": "image",
      "mediaUuids": [
        "b2c3d4e5-f6a7-8901-bcde-f12345678901"
      ],
      "mediaPreviewUuid": null,
      "pricing": null,
      "purchasedAt": null,
      "tipSource": null,
      "sentByUserId": null,
      "isRead": false
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "nextVersion": "<string>"
}

{
  "error": "<string>"
}

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

page

number

default:1

Page number to retrieve (starts from 1)

Required range: x >= 1

size

number

default:15

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

Required range: 1 <= x <= 50

markAsRead

enum<string>

default:true

Whether to mark the chat as read after retrieving messages

Available options:

true,

false

beforeMessageUuid

string<uuid>

Anchor cursor: return messages older than this message UUID. Takes precedence over page.

Response

List of messages

data

object[]

required

Array of messages in the conversation

Show child attributes

pagination

object

required

Pagination information

Show child attributes

Update chat properties Get a single message

⌘I

Overview

Popular endpoints

Account

Account Health

Chats

Notifications

Posts

Creator Tools

Insights & Earnings

Apps

Onboarding

Experiences

Webhooks

Agency

Get messages from a chat

Authorizations

Headers

Path Parameters

Query Parameters

Response