latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get messages from multiple chats in bulk for a creator

Returns the most recent messages for up to 50 chats in a single request for the specified creator, keyed by the input chat UUID (the counterpart user UUID).

This is the bulk counterpart to GET /creators/{creatorUserUuid}/chats/{userUuid}/messages. Per-key errors are reported inside the 200 response body so a single unreachable chat never collapses the whole request.

<Note>Maximum 50 chat UUIDs per request. Failed keys are reported as { "error": "not_found" }.</Note>

<Note>Read-only: fetching messages in bulk does not mutate read state — messages are not marked read and isRead reflects each message's state at read time.</Note>

post/creators/{creatorUserUuid}/chats/messages/batch

Path parameters

creatorUserUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required

Example:2025-06-26

API version to use for the request

Request body

chatUuidsstring[] required

Array of chat UUIDs (counterpart user UUIDs) to fetch messages for (1-50)

sinceMessageUuidstring uuid

Optional cursor for incremental walks: returns only messages strictly after this message's publish date in each chat

limitinteger

Maximum messages to return per chat (1-50, default: 20)

Response

Per-chat messages or error for each requested chat. Always 200 when the request itself is valid, even if every key fails.

byChatobject required

Map of input chat UUID to messages or a per-key error