# Polls the current connection status of an active or recently initiated chat session

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.

## Endpoint

`GET /dcapi/tools/chat/{sessionId}/chatStatus`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/tools/chat/{sessionId}/chatStatus`

### Scope

`Tools.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/json` |

#### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| sessionId | string | Mandatory | The unique identifier of the session |

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/tools/chat/{sessionId}/chatStatus \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| sessionId | long | Unique identifier of the chat session |
| connectionStatus | string | Current connection state: connected, disconnected, or pending |
| agentStatus | string | Agent availability status: active or inactive |

### Sample Response: HTTP 200

```json
{
  "connectionStatus": "connected",
  "sessionId": 998877665544,
  "agentStatus": "active"
}
```

### Possible Response Codes

| Code | Type |
|---|---|
| 200 | HTTP code |

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.