FAfanvue

Get a single chat

Returns the details of a single chat conversation between the authenticated user and the specified user, including read state, last message metadata, mute status, and unread message count.

This is the single-conversation counterpart to GET /chats and returns the same per-conversation shape for one chat.

get/chats/{userUuid}

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/chats/{userUuid}
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:chat

Path parameters

userUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Chat conversation details

createdAtstring date nullable required
lastMessageAtstring date nullable required

Date of the last message in this chat

isReadboolean required

Whether the chat is read. Authoritative for unread badges: it is false either when unread messages exist or when the chat was manually marked unread via PATCH /chats/{userUuid}, in which case unreadMessagesCount stays 0.

isMutedboolean required
unreadMessagesCountnumber required

Number of messages in this chat the authenticated user has not read. 0 for a chat that was manually marked unread — use isRead for badge state.

isCreatorboolean

Whether the chat counterpart is also a creator on the platform

onlineboolean

Whether the counterpart is currently online. Provided inline to avoid a separate /chats/statuses request. Matches the online filter: a counterpart you no longer have a live relationship with always reads as offline.

lastSeenAtstring date nullable

When the counterpart was last seen online, or null if unknown/hidden

Changes

No recorded changes to this operation across all 8 revisions of this API.