Skip to main content

Check connection status

GET /v1/numbers/{id}/status returns the live connection state of one WhatsApp number.
curl "https://pilotstatus.com.br/v1/numbers/wa_abc/status" \
  -H "x-api-key: ps_your_token_here"
Response:
{
  "state": "OPEN",
  "isFullyConnected": true
}
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/numbers does 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.connected webhook instead).

States

stateMeaning
OPENConnected to WhatsApp.
CONNECTINGConnection in progress.
CLOSEDisconnected — generate a new QR with GET /v1/numbers/{id}/connect.
Use isFullyConnected as the definitive “ready to send” flag.