Get online statuses for multiple users
curl --request POST \
--url https://api.fanvue.com/v1/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/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/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>"
}Chats
Get online statuses for multiple users
Returns the online status and last seen timestamp for multiple users in a single request.
This endpoint is optimized for batch lookups when you need to check the online status of multiple chat counterparts at once.
Maximum 100 user UUIDs per request. Users who have disabled online visibility will always appear as offline with no last seen timestamp.
POST
/
v1
/
chats
/
statuses
Get online statuses for multiple users
curl --request POST \
--url https://api.fanvue.com/v1/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/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/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 scope
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"
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?