Check connection status
GET /v1/numbers/{id}/status returns the live connection state of one WhatsApp number.
This endpoint reflects the same connection state shown on the Numbers page in the dashboard (as does
GET /v1/numbers/{id}/connect).When to use it
GET /v1/numbersdoes not force a mass refresh of connection state — call this endpoint per number when you need an up-to-date check.- Poll it after showing a QR code / pairing code to detect when the customer completes the connection (or rely on the
number.connectedwebhook instead).
States
state | Meaning |
|---|---|
OPEN | Connected to WhatsApp. |
CONNECTING | Connection in progress. |
CLOSE | Disconnected — generate a new QR with GET /v1/numbers/{id}/connect. |
isFullyConnected as the definitive “ready to send” flag.