Skip to main content
GET
Get a single chat
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

Response

Chat conversation details

createdAt
string<date> | null
required
lastMessageAt
string<date> | null
required

Date of the last message in this chat

isRead
boolean
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.

isMuted
boolean
required
unreadMessagesCount
number
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.

user
object
required
lastMessage
object | null
required
isCreator
boolean

Whether the chat counterpart is also a creator on the platform

online
boolean

Whether the counterpart is currently online. Provided inline to avoid a separate /chats/statuses request.

lastSeenAt
string<date> | null

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

customLists
object[]

Custom lists owned by the authenticated user that the counterpart belongs to