# Mobile - Consultar opções de verificação

`GET /instance/mobile/verification-options`

Pasta: **Instancia**

## Autenticação

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

## Descrição

# Consultar opções de verificação (GET)

Sincroniza e devolve os métodos disponíveis para registrar/sincronizar o número no protocolo mobile (`call`, `sms`, `otp`), com waits e elegibilidade.

Use no início do fluxo de registro mobile. O telefone também pode ir no body (POST) ou query.

## Endpoint

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

## 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 telefone vinculado à instância. |

## Exemplo de Requisição

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

## Resposta de Sucesso

```json
{
  "success": true,
  "verificationOptions": {
    "phone": "5511999999999",
    "registeredInInstance": false,
    "whatsappAccountExists": true,
    "smsEligible": true,
    "otpEligible": true,
    "recommendedMethod": "sms",
    "methods": [
      {"id": "sms", "label": "SMS", "recommended": true, "available": true, "waitSeconds": 0},
      {"id": "call", "label": "Ligação", "recommended": false, "available": true, "waitSeconds": 60},
      {"id": "otp", "label": "WhatsApp", "recommended": false, "available": true, "waitSeconds": 0}
    ]
  }
}
```

## Erros comuns

- `400` — instância não está em modo mobile
- `401` — token inválido
- `409` — telefone diferente do vinculado (`phone_bound`)
- `503` — mobile bridge indisponível

## Observações

Mesmo handler do POST. Prefira GET com query para leitura; use POST quando preferir JSON no body.

## Query

- `phone` = `5511999999999`

## cURL

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

---

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