Skip to main content
GET
Get a single message
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
messageUuid
string<uuid>
required

Response

Message details

uuid
string<uuid>
required
text
string | null
required
sentAt
string<date> | null
required
sender
object
required
recipient
object
required
hasMedia
boolean | null
required
mediaType
enum<string> | null
required
Available options:
image,
video,
audio,
document
mediaUuids
string<uuid>[]
required

Ordered list of media UUIDs attached to this message (display order)

mediaPreviewUuid
string<uuid> | null
required

UUID of the media item shown for free as a preview of this pay-to-view message, or null when no free preview was configured. Mirrors the mediaPreviewUuid set when sending the message.

type
enum<string>
required
Available options:
AUTOMATED_CANCELED,
AUTOMATED_NEW_FOLLOWER,
AUTOMATED_NEW_PURCHASE,
AUTOMATED_NEW_SUBSCRIBER,
AUTOMATED_RE_SUBSCRIBED,
AUTOMATED_RENEWED,
AUTOMATED_CHAT_MESSAGE_REPLY,
AUTOMATED_FIRST_MESSAGE_REPLY,
CHAT_TEXT_GENERATION,
CHAT_TEXT_REPLY,
CHAT_TEXT_REWRITE,
SINGLE_RECIPIENT,
TIP,
VOICE_CALL,
BROADCAST,
GHOST_PROMOTION
pricing
object | null
required

Pricing information for pay-to-view messages

purchasedAt
string<date> | null
required

Timestamp when this message was purchased, or null if not purchased

tipSource
enum<string> | null
required

For TIP messages, where the tip originated: 'chat' (direct in-chat tip), 'post' (tipped a feed post) or 'media_link' (tipped via a shared media link). Null for non-tip messages.

Available options:
chat,
post,
media_link
sentByUserId
string<uuid> | null
required

UUID of the team member who sent the message on behalf of the creator, or null if sent directly by the creator

isRead
boolean
required

Whether the message has been read by the recipient