latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get messages from multiple chats in bulk

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

This is the bulk counterpart to GET /chats/{userUuid}/messages. It collapses N per-chat round trips into one POST and is intended for initial-sync flows and incremental refreshes.

Per-key errors are reported inside the 200 response body so a single unreachable chat never collapses the whole request — consumers keep the rest and only retry the failing keys.

Modes:

  • Default: returns the latest limit messages per chat, newest first. hasMore indicates older messages exist.
  • Incremental (sinceMessageUuid): returns messages strictly published after the cursor message's publish date, newest first.

Out of scope: Backwards history pagination (a before cursor). Use oldestMessageUuid from the response as the anchor when that ships.

<Note>Maximum 50 chat UUIDs per request. Failed keys are reported as { "error": "not_found" } — this covers both chats that don't exist and chats the caller isn't part of.</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/chats/messages/batch

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