> ## 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.

# Modos e cobrança

> Modos rápida e completa, consulta de CPF, quando cobra e cache de 24 horas nos validadores.

<Tip>
  Os validadores funcionam como **pré-pago por verificação**: você escolhe o modo (rápida ou completa) e paga créditos ou saldo **Pague pelo uso** — igual aos envios. O workspace precisa ter saldo **antes** de rodar a checagem.
</Tip>

## Em poucas palavras

| Modo                  | E-mail                    | Telefone                | CPF                                   |
| --------------------- | ------------------------- | ----------------------- | ------------------------------------- |
| **Rápida** (`quick`)  | Formato, descartável e MX | Formato e tipo de linha | Dígitos do CPF e formato da data      |
| **Completa** (`full`) | + caixa de entrada existe | + tem WhatsApp          | + consulta na base oficial do governo |

## Preços (plano e PAYG)

| SKU                  | Créditos (plano) | Pague pelo uso      |
| -------------------- | ---------------- | ------------------- |
| `EMAIL_VERIFY_QUICK` | 1 / e-mail       | R\$ 0,01 / e-mail   |
| `EMAIL_VERIFY_FULL`  | 5 / e-mail       | R\$ 0,01 / e-mail   |
| `PHONE_VERIFY_QUICK` | 1 / número       | R\$ 0,01 / número   |
| `PHONE_VERIFY_FULL`  | 27 / número      | R\$ 0,04 / número   |
| `CPF_VERIFY_QUICK`   | 1 / consulta     | R\$ 0,01 / consulta |
| `CPF_VERIFY_FULL`    | 900 / consulta   | R\$ 1,08 / consulta |

Valores atualizados: `GET /v1/pricing` ou [API de preços](/guides/precos/api-de-precos).

## Quando **cobra**

| Situação                                                        | Cobra?                    |
| --------------------------------------------------------------- | ------------------------- |
| Formato inválido (rejeitado localmente)                         | **Não**                   |
| Mesmo item verificado no **mesmo modo** nas últimas 24h (cache) | **Não**                   |
| Verificação concluída no modo escolhido                         | **Sim** — créditos do SKU |
| Modo `full` retorna `unknown` (falha antes do resultado)        | **Não**                   |

<Warning>
  O modo **completa** custa mais porque faz checagem profunda (caixa de entrada ou WhatsApp). Use **rápida** para limpar listas grandes; use **completa** quando a entrega depende do destino ser real.
</Warning>

## Cache (24 horas)

Resultados ficam em cache por **modo** por **24 horas**:

* Verificar o mesmo e-mail em `quick` e depois em `full` **cobra os dois** (modos diferentes).
* Repetir `full` no mesmo número dentro de 24h **não cobra** de novo.

Vale para API e painel.

## Pool compartilhado (voluntário)

Em **Configurações do workspace**, é possível ativar *Contribuir com minhas linhas* para ajudar a validação de telefone de outros clientes (somente checagem WhatsApp, sem envio de mensagens). **Desligado por padrão.** Quem verifica sempre consome primeiro as próprias linhas; o pool só entra como fallback interno da plataforma.

## Consulta de CPF

Mesma lógica de modos: **`quick`** (local) e **`full`** (base oficial do governo via parceria). Cada item exige **CPF + data de nascimento**.

| Situação                                           | Modo rápida                  | Modo completa               |
| -------------------------------------------------- | ---------------------------- | --------------------------- |
| CPF ou data inválidos (local)                      | **Não** cobra                | **Não** cobra               |
| Mesmo par + mesmo modo nas últimas **24h** (cache) | **Não** cobra                | **Não** cobra               |
| `valid` (passou na validação local)                | **Sim** — `CPF_VERIFY_QUICK` | —                           |
| `found`, `notFound`, `minorBlocked`                | —                            | **Sim** — `CPF_VERIFY_FULL` |
| `error` (`resultCode` 7)                           | —                            | **Não** cobra               |

Guia completo: [Consulta de CPF](/validations-api/como-funciona/introducao-cpf).

## Limites por superfície

| Onde            | E-mail         | Telefone             | CPF            |
| --------------- | -------------- | -------------------- | -------------- |
| Painel (add-on) | Até **10**     | Até **10**           | Até **10**     |
| API síncrona    | Até **10**     | Até **10**           | Até **10**     |
| API batch       | 1 a **10.000** | **500** a **10.000** | 1 a **10.000** |

## Próximos passos

* [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)
* [Quick Start](/validations-api/como-funciona/quick-start)