> ## 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 — Status da conexão

> GET /v1/numbers/{id}/status — Verifique o status de conexão em tempo real de um número específico do WhatsApp no seu projeto Pilot Status a qualquer momento.

# Verificar status da conexão

`GET /v1/numbers/{id}/status` retorna o estado de conexão em tempo real de um número do WhatsApp.

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

Resposta:

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

<Note>
  Este endpoint reflete o mesmo estado de conexão exibido na página **Números** do painel (assim como `GET /v1/numbers/{id}/connect`).
</Note>

## Quando usar

* `GET /v1/numbers` não força uma atualização em massa do estado de conexão — chame este endpoint por número quando precisar de uma verificação atualizada.
* Faça polling após exibir um QR code / código de pareamento para detectar quando o cliente conclui a conexão (ou use o webhook `number.connected` em vez disso).

## Estados

| `state`      | Significado                                                        |
| ------------ | ------------------------------------------------------------------ |
| `OPEN`       | Conectado ao WhatsApp.                                             |
| `CONNECTING` | Conexão em andamento.                                              |
| `CLOSE`      | Desconectado — gere um novo QR com `GET /v1/numbers/{id}/connect`. |

Trate `state === "OPEN"` como o indicador definitivo de "pronto para enviar".