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.

Scope required: read:chat

Maximum 100 user UUIDs per request. Users who have disabled online visibility will always appear as offline with no last seen timestamp.

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. <Info>Scope required: `read:chat`</Info> <Note>Maximum 100 user UUIDs per request. Users who have disabled online visibility will always appear as offline with no last seen timestamp.</Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

userUuidslist of stringsRequired

Array of user UUIDs to check online status for (max 100)

Response

Online statuses retrieved successfully

isOnlineboolean

Whether the user is currently online

lastSeenAtstring or nullformat: "date"

Last time the user was seen online (UTC)

1	import requests
2
3	url = "https://api.fanvue.com/chats/statuses"
4
5	payload = { "userUuids": ["string"] }
6	headers = {
7	"X-Fanvue-API-Version": "2025-06-26",
8	"Authorization": "Bearer <token>",
9	"Content-Type": "application/json"
10	}
11
12	response = requests.post(url, json=payload, headers=headers)
13
14	print(response.json())

1	{
2	"c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8": {
3	"isOnline": true,
4	"lastSeenAt": "2024-01-15T00:00:00.000Z"
5	},
6	"b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7": {
7	"isOnline": false,
8	"lastSeenAt": "2024-01-14T00:00:00.000Z"
9	},
10	"c3d4e5f6-7890-1234-5678-9abcdef01234": {
11	"isOnline": false
12	}
13	}

Authentication

Headers

Request

Response

Errors