---
title: "WhatsApp Connection Status"
description: "Check if your WhatsApp phone session is actively paired and connected."
---

# WhatsApp Connection Status

Before dispatching time-sensitive messages or large campaigns, you can verify that your WhatsApp device session is paired and connected.

## Endpoint

```http
GET /api/v2/whatsapp/status
```

## Authorization

```http
Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md
```

## Request Example

<CodeGroup>

```bash curl
curl -X GET "https://api.bulkitsms.com/api/v2/whatsapp/status" \
  -H "Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md"
```

```python Python
import requests

response = requests.get(
    "https://api.bulkitsms.com/api/v2/whatsapp/status",
    headers={
        "Authorization": "Bearer bk_live_8n6JQv3K1h9Lp0Md",
    },
    timeout=10,
)
print(response.json())
```

```javascript Node.js
const res = await fetch("https://api.bulkitsms.com/api/v2/whatsapp/status", {
  headers: {
    "Authorization": "Bearer bk_live_8n6JQv3K1h9Lp0Md",
  },
});
const status = await res.json();
console.log(status);
```

</CodeGroup>

## Success Response (Connected)

When your phone is paired and the socket connection is healthy:

```json
{
  "status": "success",
  "data": {
    "connected": true,
    "phone": "254712345678",
    "push_name": "My Business",
    "status": "connected",
    "last_active_at": "2026-09-19T06:38:15Z"
  }
}
```

## Success Response (Disconnected)

When no active device is linked, or the phone was unlinked from the WhatsApp mobile app:

```json
{
  "status": "success",
  "data": {
    "connected": false,
    "status": "disconnected"
  }
}
```

## How to Reconnect

If `connected` is `false`, log in to the Bulkit dashboard at `/whatsapp` and scan the QR code using your WhatsApp mobile app under **Linked Devices**.