Skip to main content

🔍 Check Device Status​

This endpoint is used to monitor your device's connection status in real-time. It is highly recommended to call this endpoint before sending bulk messages to ensure the device is in the connected and logged_in state.

Device States​

StateDescription
pairedThe device has been previously linked with a WhatsApp account.
activeThe Wagy worker for this device is running on the server.
connectedThe Wagy server is connected to the WhatsApp socket.
logged_inThe WhatsApp session is valid and ready to send/receive messages.

Success Response Example​

{
  "status": "success",
  "data": {
    "device_id": "dev-12345",
    "paired": true,
    "active": true,
    "connected": true,
    "logged_in": true,
    "user": "628123456789",
    "owner": {
      "email": "owner@example.com",
      "whatsapp": "628123456789",
      "last_active_at": "2026-05-10T09:00:00Z",
      "created_at": "2026-01-01T10:00:00Z"
    }
  }
}
Pro Tip

If logged_in is false but paired is true, it usually means the device is experiencing network issues or the session has expired. You may need to call the /auth/qr endpoint again.

Check device status

GET 
/:device_id/status

Get current connection and pairing status of the device, including owner info.

Request​

Responses​

OK