Valide CPFs com o motivo da recusa
API REST que valida tamanho, dígitos repetidos e dígito verificador do CPF, e devolve o CPF formatado. Não consulta nem expõe dados pessoais.
curl https://datahub.falcon-server.com.br/private/v1/validate/cpf/12345678909 \
-H "Authorization: Bearer <SEU_TOKEN>"
# CPF válido
{
"data": {
"document": "12345678909",
"valid": true,
"formatted": "123.456.789-09",
"reason": null
}
}
# CPF inválido (também HTTP 200)
{
"data": {
"document": "11111111111",
"valid": false,
"formatted": "111.111.111-11",
"reason": "CPF com todos os dígitos iguais."
}
}O que a API de CPF faz
Validação completa em uma chamada, com resposta pronta para mostrar ao usuário.
Dígito verificador
Algoritmo oficial de DV do CPF, aplicado depois de remover pontos e hífen.
Rejeita dígitos repetidos
CPFs como 111.111.111-11 passam no cálculo do DV, mas são inválidos. A API recusa e diz o motivo.
Motivo da recusa
O campo reason explica por que o CPF foi recusado (tamanho, dígitos repetidos ou DV), pronto para exibir no formulário.
CPF formatado
Devolve o CPF no formato 000.000.000-00 para gravar ou exibir.
Gerador para testes
GET /private/v1/validate/generate/cpf devolve um CPF válido para ambientes de teste.
Sem dados pessoais
A API valida o número; não consulta nem retorna nome, endereço ou outros dados do titular.
Falcon vs. alternativas
Quando usar a API em vez de uma biblioteca local
| Recurso | Falcon Data Hub | Libs locais (PHP/JS) | Outros providers |
|---|---|---|---|
| Validação de dígito verificador | Sim | Sim | Sim |
| Recusa dígitos repetidos | Sim | Parcial | Parcial |
| Motivo da recusa em texto | Sim | Parcial | Parcial |
| Mesma regra em todos os sistemas | Sim | Manual | Sim |
| SDK oficial PHP | Sim | N/A | Não |
| CNPJ, CEP, placa no mesmo token | Sim | N/A | Parcial |
Perguntas frequentes sobre a API de CPF
A API retorna o nome do titular do CPF?
Não. A API só valida o número (tamanho, dígitos repetidos e dígito verificador). Ela não consulta nem retorna nome, endereço ou qualquer dado pessoal.
O que a API responde para um CPF inválido?
HTTP 200 com valid: false e o motivo em reason: "CPF deve ter 11 dígitos.", "CPF com todos os dígitos iguais." ou "Dígitos verificadores inválidos.".
A API rejeita CPFs como 111.111.111-11?
Sim. Eles passam no cálculo do dígito verificador, mas a API responde valid: false com o motivo.
Posso usar para validar formulário de cadastro?
Sim. Para resposta instantânea no navegador, valide localmente também e use a API para garantir a mesma regra no servidor.
CPF inválido conta no limite?
Sim. Toda requisição conta no limite por hora do seu plano, inclusive a que não encontra resultado ou é recusada por dado inválido.
Quanto custa em produção?
Iniciante (R$ 4,90/mês): 100 requisições/hora; Premium (R$ 49,90/mês): 1.000 requisições/hora; Enterprise (R$ 199,90/mês): 10.000 requisições/hora. Os limites e preços atualizados estão na página de planos.
Outras APIs no mesmo token
Uma única conta cobre tudo. Crie agora e use todas as APIs com o mesmo plano.
Comece a validar CPFs em produção
Crie sua conta grátis e integre em minutos. SDK PHP pronto.