Bulkit
Register

WhatsApp Connection Status

Check if your WhatsApp phone session is actively paired and connected.

Last updated · Markdown version

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

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

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.

PreviousWhatsApp Inbox & Messages APINextWebhooks Overview