> ## 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.
# Consulta de CPF
> Valide CPF com data de nascimento antes de aprovar cadastros — modo rápida (formato) ou completa (base oficial do governo).
**Consulta de CPF** é o **conferente de identidade no cadastro**: antes de liberar benefício, crédito ou acesso, você confere se o CPF e a data de nascimento são válidos — e, no modo completo, se o par existe na **base de dados oficial do governo**, acessada por parceria da plataforma. Use no painel em **Add-ons → Consulta de CPF** ou integre no fluxo de onboarding.
## O que é?
É um add-on que responde: *este CPF e esta data de nascimento são válidos?* No modo **completo**, também responde: *o par existe na base oficial e quais dados cadastrais estão disponíveis?*
Você envia **CPF + data de nascimento** — os dois são obrigatórios em ambos os modos.
Diferente de [validar e-mail](/validations-api/como-funciona/introducao) ou [telefone](/validations-api/como-funciona/introducao-telefone), aqui o foco é **identidade fiscal brasileira** em cadastros, KYC leve e higienização de bases com documento.
## Por que usar?
| Sem consulta | Com consulta |
| --------------------------------------------- | ---------------------------------------------------------------- |
| Cadastro com CPF inventado ou digitado errado | Rejeita CPF inválido antes de salvar |
| Aprovação sem conferir data de nascimento | Confere formato local (rápida) ou par na base oficial (completa) |
| Fraude com documento de terceiros | Reduz cadastros inconsistentes |
## Dois modos de consulta
| Modo | O que verifica | Créditos (plano) | Pague pelo uso |
| --------------------- | ----------------------------------------------------------------------------------------- | ---------------- | -------------- |
| **Rápida** (`quick`) | Dígitos do CPF (checksum) e formato da data de nascimento | 1 por consulta | R\$ 0,01 |
| **Completa** (`full`) | Tudo da rápida + consulta na **base oficial do governo** (nome, situação cadastral, etc.) | 900 por consulta | R\$ 1,08 |
A consulta completa acessa dados cadastrais oficiais por meio de **parceria da plataforma** com fontes autorizadas — você não precisa contratar integração própria. Valores em `GET /v1/pricing` ou na [API de preços](/guides/precos/api-de-precos).
Use **rápida** para filtrar formato inválido em listas grandes ou no primeiro passo do cadastro. Use **completa** quando a aprovação depende de confirmar o CPF na base oficial (KYC, crédito, benefícios).
## Formatos de data de nascimento
Na API e no painel, aceitamos:
| Formato | Exemplo |
| ---------- | ------------ |
| ISO | `1990-01-01` |
| Brasileiro | `01/01/1990` |
| Compacto | `01011990` |
## Painel vs API
| Canal | Limite | Uso típico |
| ---------------------------------------- | --------------------------- | ---------------------------------------- |
| **Painel** (Add-ons → Consulta de CPF) | Até **10** pares CPF + data | Teste manual, lista pequena |
| **API** `POST /v1/validations/cpf` | Até **10** itens | Validação no cadastro do usuário |
| **API** `POST /v1/validations/cpf/batch` | 1 a **10.000** | Importações e bases grandes (assíncrono) |
No painel: uma linha por consulta, no formato `CPF,data` — por exemplo `12345678909,1990-01-01` ou `123.456.789-09,01/01/1990`. Escolha **Rápida** ou **Completa** antes de consultar.
Envie `"mode": "quick"` ou `"mode": "full"` no body da API (padrão: `quick`).
## O que significa cada status
### Modo rápida
| `status` | Em português claro |
| --------- | -------------------------------------- |
| `valid` | CPF e data passaram na validação local |
| `invalid` | CPF ou data inválidos |
### Modo completa
| `status` | Em português claro |
| -------------- | --------------------------------------------------------------------------- |
| `found` | CPF encontrado na base oficial |
| `notFound` | CPF não encontrado na base |
| `minorBlocked` | Menor de idade — dados protegidos pela LGPD (sem retorno de dados pessoais) |
| `invalid` | CPF ou data inválidos (validação local ou parâmetro rejeitado) |
| `error` | Falha temporária na consulta — tente de novo |
Cada item traz `resultCode` (1 a 8) para automação:
| `resultCode` | Significado |
| ------------ | ----------------------------------- |
| `1` | Encontrado (completa) |
| `2` | Não encontrado (completa) |
| `3` | Menor bloqueado — LGPD (completa) |
| `4` | Parâmetro inválido (completa) |
| `5` | CPF inválido (local) |
| `6` | Data de nascimento inválida (local) |
| `7` | Erro na consulta (completa) |
| `8` | Válido localmente (rápida) |
## Campos no modo completa (`found`)
| Campo | O que é |
| --------------------- | --------------------------------------------------------- |
| `cpf` | CPF normalizado (11 dígitos) |
| `birthDate` | Data de nascimento informada na consulta (ISO) |
| `name` | Nome cadastral |
| `socialName` | Nome social, quando existir |
| `registrationStatus` | Situação cadastral (`code` + `description`, ex.: Regular) |
| `registeredBirthDate` | Data de nascimento retornada pela fonte |
| `deceasedIndicator` | Indicador de óbito, quando aplicável |
| `creditsCharged` | Créditos cobrados nesta consulta |
No modo **rápida**, nome e situação cadastral vêm `null` — só `status`, `resultCode` e `creditsCharged` importam.
Em `minorBlocked`, apenas `status`, `resultCode` e `reason` são retornados — sem nome nem situação (LGPD).
## Escopo da API Key
Rotas de CPF exigem **`validations:cpf`** — separado de `validations:email`, `validations:phone` e dos canais de envio.
## Próximos passos
* [Quick Start](/validations-api/como-funciona/quick-start)
* [Modos e cobrança](/validations-api/como-funciona/modos-e-cobranca)
* [Escopos da API Key](/validations-api/como-funciona/escopos-da-api-key)
* [Validação de e-mail](/validations-api/como-funciona/introducao)
* [Validação de telefone](/validations-api/como-funciona/introducao-telefone)
* [API de preços](/guides/precos/api-de-precos) — SKUs `CPF_VERIFY_QUICK` e `CPF_VERIFY_FULL`