API CPF
Entrar Criar conta

Validação

Como validar CPF via API sem gastar crédito

· 4 min de leitura

Antes de consultar dados cadastrais, vale filtrar CPF inválido. Com a API CPF você valida formato e dígitos verificadores sem consumir crédito da consulta completa.

Checklist e documentos para validação de CPF via API
Valide formato e dígitos antes de gastar crédito na consulta.

Por que validar antes de consultar

Usuários digitam CPF errado o tempo todo. Se você chama a consulta completa a cada tentativa, gasta crédito e gera ruído no painel. A validação corta esse desperdício no formulário.

Endpoint de validação

Use /v1/validate com autenticação por X-API-KEY (ou Bearer / token na URL):

GET /v1/validate?cpf=00000000000
X-API-KEY: sua_chave_aqui

O que a validação verifica

  • Quantidade de dígitos
  • Dígitos verificadores (algoritmo oficial do CPF)
  • Sequências inválidas óbvias (ex.: 111.111.111-11)

Ela não substitui a consulta cadastral — só confirma se o número é estruturalmente válido.

Fluxo recomendado no produto

  1. Usuário digita o CPF
  2. Front ou backend chama /v1/validate
  3. Se inválido, mostre erro imediato
  4. Se válido, chame /consulta?cpf= para obter nome, mãe, gênero e nascimento

Exemplo com cURL

curl -X GET "https://apicpf.dev/v1/validate?cpf=00000000000" \
  -H "X-API-KEY: sua_chave_aqui"

Quando validar no front e no back

Validação no front melhora UX. Validação no servidor é obrigatória — nunca confie só no cliente. Combine as duas camadas e use a API CPF como fonte única de verdade para a regra dos dígitos.