Por que validar CPF não é o mesmo que consultar cadastro
Validação de CPF verifica estrutura e dígitos verificadores. Consulta cadastral de CPF busca dados associados ao número. Misturar os conceitos gera requisitos incorretos e pode levar sua aplicação a realizar consultas de dados pessoais quando bastava checar uma entrada digitada.
Na API CPF, /v1/validate?cpf= verifica formato e dígitos sem consumir crédito de consulta. A rota /consulta?cpf= retorna informações cadastrais via JSON e consome um crédito, conforme a documentação.
O que a validação matemática comprova
Um resultado valid: true indica que a sequência segue a regra dos dígitos verificadores. Ele não comprova existência do cadastro, situação regular na Receita Federal, identidade da pessoa nem autorização para consultar dados pessoais. Para reduzir erros de preenchimento em formulário, essa validação pode ser suficiente.
GET https://api.apicpf.dev/v1/validate?cpf=52998224725
{ "code": 200, "valid": true, "cpf": "52998224725", "formatted": "529.982.247-25" }
Esse é o exemplo público da documentação e não um resultado de identificação. Saiba mais no guia de validação.
O que uma consulta cadastral traz
O endpoint GET /consulta?cpf= autenticado com X-API-KEY possui resposta documentada com cpf, nome, mae, genero e data_nascimento dentro de data. Esses campos são dados pessoais e devem ser solicitados apenas com finalidade adequada. A resposta não substitui verificação de identidade quando exigida.
Comparativo entre as operações
| Dúvida | Validar CPF | Consultar CPF |
|---|---|---|
| Verifica dígitos e formato? | Sim | Não é o objetivo central |
| Retorna nome e nascimento? | Não | Campos documentados |
| Usa crédito de consulta? | Não | Sim, um crédito |
| Comprova titularidade? | Não | Não, isoladamente |
| Precisa de finalidade de tratamento? | Avalie o tratamento | Sim, especialmente para o cadastro |
Como encaixar as duas etapas no cadastro
Um desenho simples é: entrada do CPF → remoção da máscara → validação dos dígitos → avaliação da necessidade → consulta cadastral quando indispensável → retenção mínima. Esse fluxo tende a evitar consultas desnecessárias, mas não autoriza automaticamente o uso dos dados retornados.
Perguntas frequentes
CPF válido significa que está regular na Receita?
Não. Verificar dígitos não equivale a consultar a situação cadastral oficial.
O JSON prova que a pessoa é dona do CPF?
Não. A consulta cadastral retorna atributos e não substitui autenticação nem prova de identidade.
