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

# Escopos da API Key

> Escopos validations:email, validations:phone e validations:cpf para verificação via API v1.

<Tip>
  Cada escopo é uma **porta** na chave: verificar e-mail, telefone ou CPF. São **separados** dos escopos de envio — uma chave só de higienização de lista não precisa de `email:send` ou `whatsapp:send`.
</Tip>

## Escopos

| Escopo                  | Permite                                                 |
| ----------------------- | ------------------------------------------------------- |
| **`validations:email`** | Verificar e-mails (síncrono e batch)                    |
| **`validations:phone`** | Verificar telefones (síncrono e batch)                  |
| **`validations:cpf`**   | Consultar CPF com data de nascimento (síncrono e batch) |

Rotas cobertas:

* E-mail: `POST /v1/validations/email`, `POST /v1/validations/email/batch`, `GET /v1/validations/email/batch/{jobId}`
* Telefone: `POST /v1/validations/phone`, `POST /v1/validations/phone/batch`, `GET /v1/validations/phone/batch/{jobId}`
* CPF: `POST /v1/validations/cpf`, `POST /v1/validations/cpf/batch`, `GET /v1/validations/cpf/batch/{jobId}`

<Warning>
  Os escopos de validação são **independentes** dos canais de envio:

  * `validations:email` ≠ `email:send`
  * `validations:phone` ≠ `sms:send` ou `whatsapp:send`
</Warning>

## Combinações comuns

| Fluxo                                      | Escopos                               |
| ------------------------------------------ | ------------------------------------- |
| Só higienizar lista de e-mails             | `validations:email`                   |
| Só higienizar lista de telefones           | `validations:phone`                   |
| Só consultar CPF em cadastros              | `validations:cpf`                     |
| Validar no cadastro e depois enviar e-mail | `validations:email` + `email:send`    |
| Validar WhatsApp e depois disparar         | `validations:phone` + `whatsapp:send` |

## Onde configurar

1. **Painel → Desenvolvedor → API Keys** — marque **Validações → Verificar e-mails**, **Verificar telefones** e/ou **Consultar CPF**
2. **OAuth apps** — inclua `validations:email`, `validations:phone` e/ou `validations:cpf` nos escopos autorizados

No **painel** (add-ons), a verificação usa a sessão do usuário — não consome escopos da API Key.

## Próximos passos

* [Quick Start](/validations-api/como-funciona/quick-start)
* [Validação de e-mail](/validations-api/como-funciona/introducao)
* [Validação de telefone](/validations-api/como-funciona/introducao-telefone)
* [Consulta de CPF](/validations-api/como-funciona/introducao-cpf)