Get online statuses for multiple users as a creator
curl --request POST \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \
--data '
{
"userUuids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses"
payload = { "userUuids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"] }
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({userUuids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']})
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8": {
"isOnline": true,
"lastSeenAt": "2024-01-15T00:00:00.000Z"
},
"b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7": {
"isOnline": false,
"lastSeenAt": "2024-01-14T00:00:00.000Z"
},
"c3d4e5f6-7890-1234-5678-9abcdef01234": {
"isOnline": false,
"lastSeenAt": null
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Creator Chats
Get online statuses for multiple users as a creator
Returns the online status and last seen timestamp for multiple users in a single request, from the perspective of the specified creator.
Maximum 100 user UUIDs per request. Users who have disabled online visibility will always appear as offline with no last seen timestamp.
POST
/
v1
/
creators
/
{creatorUserUuid}
/
chats
/
statuses
Get online statuses for multiple users as a creator
curl --request POST \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \
--data '
{
"userUuids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses"
payload = { "userUuids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"] }
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({userUuids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']})
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/statuses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8": {
"isOnline": true,
"lastSeenAt": "2024-01-15T00:00:00.000Z"
},
"b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7": {
"isOnline": false,
"lastSeenAt": "2024-01-14T00:00:00.000Z"
},
"c3d4e5f6-7890-1234-5678-9abcdef01234": {
"isOnline": false,
"lastSeenAt": null
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Required scopes
read:creator— Access creator profiles, content, and creator-specific information.read:chat— Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.
Authorizations
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
API version to use for the request
Example:
"2025-06-26"
Path Parameters
Body
application/json
Array of user UUIDs to check online status for (max 100)
Required array length:
1 - 100 elementsResponse
Online statuses retrieved successfully
Map of user UUIDs to their online status
Show child attributes
Show child attributes
Was this page helpful?