# Mobile - Consultar espera de verificação

`GET /instance/mobile/verification-waits`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Consultar espera de verificação

Retorna os segundos restantes de cooldown por método (`call`, `sms`, `otp`) antes de poder solicitar novo código.

Use para evitar `409` por rate limit ao chamar `request-code`.

## Endpoint

```http
GET {{baseUrl}}/instance/mobile/verification-waits
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Parâmetros

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `phone` | string | Não* | Query. Alias: `number`, `owner`. Se omitido, usa o `owner` da instância. |

## Exemplo de Requisição

```bash
curl -X GET "{{baseUrl}}/instance/mobile/verification-waits?phone=5511999999999" \
  -H "token: {{token}}"
```

## Resposta de Sucesso

```json
{
  "success": true,
  "phone": "5511999999999",
  "waits": {
    "call": 45,
    "sms": 0,
    "otp": 0
  }
}
```

## Erros comuns

- `400` — modo não-mobile ou telefone não vinculado
- `401` — token inválido
- `409` — telefone divergente
- `503` — mobile bridge indisponível

## Observações

Valores em segundos. `0` significa que o método pode ser solicitado agora.

## Query

- `phone` = `5511999999999`

## cURL

```bash
curl -X GET "{{baseUrl}}/instance/mobile/verification-waits" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-consultar-espera-de-verificacao)