> ## Documentation Index > Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt > Use this file to discover all available pages before exploring further. # List Chat Messages (/api-reference/fanvue/chat-messages/list-chat-messages) Page a chat's message history. Proxies Fanvue's `GET /v1/chats/{userUuid}/messages`, which pages with dates rather than an opaque cursor: pass the `dateFilter` returned with the previous page back as `sentBefore` and `receivedBefore` to fetch older messages. A `null` `dateFilter` means there are no more. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/chats/{userUuid}/messages openapi: 3.0.3 info: title: Fanvue API Documentation description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: Account description: Endpoints for your connected Fanvue accounts - name: Chat Messages description: Endpoints for the messages inside a Fanvue chat. - name: Chats description: Endpoints for a Fanvue creator's inbox. A chat is identified by the fan's user UUID. - name: Fans description: "Endpoints for the fans of a Fanvue creator: subscribers, followers, smart lists and per-fan insights." - name: Fanvue Account description: Endpoints for the connected Fanvue creator itself. - name: Insights description: "Revenue and growth reporting for a Fanvue creator: per-transaction earnings, the aggregated earnings summary, the subscriber trend and top spenders." - name: Profiles description: Public Fanvue creator profiles, readable without connecting the creator. paths: /api/fanvue/{fanvueAccount}/chats/{userUuid}/messages: parameters: - in: path name: fanvueAccount description: The Fanvue Account ID example: fanvue_acct_XXXXXXXXXXXXXXX required: true schema: type: string - in: path name: userUuid description: The fan's Fanvue user UUID. Chats are keyed by the counterpart, so this is also the chat id. example: f47ac10b-58cc-4372-a567-0e02b2c3d479 required: true schema: type: string get: summary: List Chat Messages operationId: listChatMessages description: "Page a chat's message history. Proxies Fanvue's `GET /v1/chats/{userUuid}/messages`, which pages with dates rather than an opaque cursor: pass the `dateFilter` returned with the previous page back as `sentBefore` and `receivedBefore` to fetch older messages. A `null` `dateFilter` means there are no more." parameters: - in: query name: limit description: Number of messages to return (1 - 50). Default = 20 example: 20 required: false schema: type: integer description: Number of messages to return (1 - 50). Default = 20 example: 20 - in: query name: sentBefore description: Fetch messages sent before this date, from the previous page's `dateFilter`. example: 2026-09-18 required: false schema: type: string description: Fetch messages sent before this date, from the previous page's `dateFilter`. example: 2026-09-18 - in: query name: receivedBefore description: Fetch messages received before this date, from the previous page's `dateFilter`. example: 2026-09-18 required: false schema: type: string description: Fetch messages received before this date, from the previous page's `dateFilter`. example: 2026-09-18 - in: query name: markAsRead description: "Mark the chat as read after retrieving the messages: `true` or `false`. Default = false" example: "false" required: false schema: type: string description: "Mark the chat as read after retrieving the messages: `true` or `false`. Default = false" example: "false" responses: "200": description: Success content: application/json: schema: type: object example: data: data: - uuid: 9c2d4f81-77a3-4e60-b1c5-2a8e6d0f4b12 text: Ignore that last one gif: null sentAt: 2026-09-22T10:54:05.205Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: UNSENT isRead: false isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: c4a1f28d-3b56-4e97-8f01-6d2b9e5a7c43 - uuid: 3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33 text: See you tonight! gif: null sentAt: 2026-09-22T10:46:04.712Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: c4a1f28d-3b56-4e97-8f01-6d2b9e5a7c43 - uuid: 5a8b3c21-4d7e-49f0-8b16-0c3e5f7a9d24 text: Hey, how's your week going? gif: null sentAt: 2026-09-22T10:30:04.609Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: null - uuid: 7e1c9a35-6b28-4f53-9a07-1d4b8e2c6f90 text: Just subscribed! How's your day going? gif: null sentAt: 2026-09-22T10:29:14.306Z sender: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones recipient: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: false isFollowing: false followForFreeEnabled: false repliedMessage: null sentByUserId: null appUuid: null dateFilter: null _meta: _credits: used: 1 balance: 10055811 note: Always _cache: is_cached: false note: Cache disabled for this endpoint _rate_limits: limit_minute: 5000 limit_day: null remaining_minute: 4999 remaining_day: null notice: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. properties: data: type: object properties: data: type: array example: - uuid: 9c2d4f81-77a3-4e60-b1c5-2a8e6d0f4b12 text: Ignore that last one gif: null sentAt: 2026-09-22T10:54:05.205Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: UNSENT isRead: false isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: c4a1f28d-3b56-4e97-8f01-6d2b9e5a7c43 - uuid: 3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33 text: See you tonight! gif: null sentAt: 2026-09-22T10:46:04.712Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: c4a1f28d-3b56-4e97-8f01-6d2b9e5a7c43 - uuid: 5a8b3c21-4d7e-49f0-8b16-0c3e5f7a9d24 text: Hey, how's your week going? gif: null sentAt: 2026-09-22T10:30:04.609Z sender: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane recipient: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: true isFollowing: false followForFreeEnabled: true repliedMessage: null sentByUserId: null appUuid: null - uuid: 7e1c9a35-6b28-4f53-9a07-1d4b8e2c6f90 text: Just subscribed! How's your day going? gif: null sentAt: 2026-09-22T10:29:14.306Z sender: uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: sarah-jones recipient: uuid: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: jane type: SINGLE_RECIPIENT status: SENT isRead: true isSubscribed: false isFollowing: false followForFreeEnabled: false repliedMessage: null sentByUserId: null appUuid: null items: type: object properties: uuid: type: string example: 9c2d4f81-77a3-4e60-b1c5-2a8e6d0f4b12 text: type: string example: Ignore that last one gif: type: string example: null nullable: true sentAt: type: string example: 2026-09-22T10:54:05.205Z sender: type: object properties: uuid: type: string example: 3bbe6394-2830-4646-a8ba-4a0a05426947 handle: type: string example: jane recipient: type: object properties: uuid: type: string example: f47ac10b-58cc-4372-a567-0e02b2c3d479 handle: type: string example: sarah-jones type: type: string example: SINGLE_RECIPIENT status: type: string example: UNSENT isRead: type: boolean example: false isSubscribed: type: boolean example: true isFollowing: type: boolean example: false followForFreeEnabled: type: boolean example: true repliedMessage: type: string example: null nullable: true sentByUserId: type: string example: null nullable: true appUuid: type: string example: c4a1f28d-3b56-4e97-8f01-6d2b9e5a7c43 dateFilter: type: string example: null nullable: true _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 10055811 note: type: string example: Always _cache: type: object properties: is_cached: type: boolean example: false note: type: string example: Cache disabled for this endpoint _rate_limits: type: object properties: limit_minute: type: integer example: 5000 limit_day: type: string example: null nullable: true remaining_minute: type: integer example: 4999 remaining_day: type: string example: null nullable: true notice: type: string example: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. tags: - Chat Messages components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````