Returns the current connection state of the specified chat session. Accepts an optional 'userID' query parameter to scope the response. This is a polling endpoint with a higher throttle threshold.
get /dcapi/tools/chat/{sessionId}/chatStatus
https://{serverurl}/dcapi/tools/chat/{sessionId}/chatStatus
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique identifier of the session
User resource ID to scope the chat status response to a specific user in a multi-user session
curl --request GET \
--url https://appdomains/dcapi/tools/chat/{sessionId}/chatStatus \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Unique identifier of the chat session
Current connection state: connected, disconnected, or pending
Agent availability status: active or inactive
{
"connectionStatus": "connected",
"sessionId": 998877665544,
"agentStatus": "active"
}
![]()
Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.