> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pilotstatus.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/numbers/{id}/status — Connection Status

> GET /v1/numbers/{id}/status — Check the live connection status of a specific WhatsApp number in your Pilot Status project at any moment.

# Check connection status

`GET /v1/numbers/{id}/status` returns the live connection state of one WhatsApp number.

```bash theme={null}
curl "https://pilotstatus.com.br/v1/numbers/wa_abc/status" \
  -H "x-api-key: ps_your_token_here"
```

Response:

```json theme={null}
{
  "id": "wa_abc",
  "state": "OPEN"
}
```

<Note>
  This endpoint reflects the same connection state shown on the **Numbers** page in the dashboard (as does `GET /v1/numbers/{id}/connect`).
</Note>

## 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

| `state`      | Meaning                                                               |
| ------------ | --------------------------------------------------------------------- |
| `OPEN`       | Connected to WhatsApp.                                                |
| `CONNECTING` | Connection in progress.                                               |
| `CLOSE`      | Disconnected — generate a new QR with `GET /v1/numbers/{id}/connect`. |

Treat `state === "OPEN"` as the definitive "ready to send" flag.