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

# recipient

> Verifica disponibilidade de números no WhatsApp.

## `zapsterapi recipient fetch`

Verifica se um número de telefone está disponível no WhatsApp e devolve o ID interno (jid/lid).

```bash theme={null}
zapsterapi recipient fetch \
  --recipient <numero> \
  [--instance-id <id>] \
  [--profile <nome>] \
  [--json]
```

Se você só tiver uma instância ativa, a CLI auto-resolve o `--instance-id`. Com mais de uma, a flag é obrigatória.

Saída JSON:

```json theme={null}
{
  "ok": true,
  "data": {
    "exists": true,
    "id": "5511999999999@s.whatsapp.net",
    "lid": null,
    "original": "5511999999999"
  }
}
```

| `error.code`           | Causa                                                        |
| ---------------------- | ------------------------------------------------------------ |
| `missing_recipient`    | `--recipient` ausente.                                       |
| `instance_id_required` | Mais de uma instância e nenhuma `--instance-id` foi passada. |
| `invalid_token`        | Token inválido.                                              |