API de CPF: diferença entre dados cadastrais e dados financeiros

APIs de CPF retornam dois tipos de informação completamente diferentes: dados cadastrais, que identificam o titular do documento (nome, data de nascimento, gênero), e dados financeiros, que descrevem o histórico de crédito e inadimplência. Escolher o tipo correto economiza custo e evita solicitações de dados além do necessário. Para a maioria dos processos de validação de identidade e KYC, os dados cadastrais já são suficientes.

Introdução

Quando se fala em "consultar um CPF via API", é comum haver confusão entre dois tipos de dados completamente distintos: os dados cadastrais e os dados financeiros. Cada um tem finalidades diferentes, é fornecido por fontes diferentes e está sujeito a regulamentações diferentes. Entender essa distinção é fundamental para escolher a API certa para a sua necessidade.

O que são dados cadastrais de CPF

Os dados cadastrais são as informações de identificação pessoal vinculadas ao número do CPF. Eles identificam quem é o titular do documento.

Campos típicos de dados cadastrais

Exemplo de resposta da API da CPFHub.io

A CPFHub.io retorna dados cadastrais em formato JSON com latência de aproximadamente 900ms, conforme o exemplo abaixo:

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "João da Silva",
    "nameUpper": "JOÃO DA SILVA",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
    }
}

Para que servem dados cadastrais

• Verificação de identidade (KYC) -- Confirmar que o CPF pertence a uma pessoa real e que os dados informados pelo usuário estão corretos.

• Onboarding de clientes -- Preencher automaticamente campos do cadastro e validar as informações antes de criar a conta.

• Prevenção de fraudes -- Cruzar nome e data de nascimento informados com os dados oficiais para detectar inconsistências.

• Emissão de notas fiscais -- Garantir que o CPF informado é válido antes de gerar documentos fiscais.

O que são dados financeiros de CPF

Os dados financeiros são informações relacionadas ao comportamento creditício e financeiro do titular do CPF. Eles indicam o histórico de pagamentos, dívidas em aberto, protestos e scores de crédito.

Campos típicos de dados financeiros

Para que servem dados financeiros

• Análise de crédito -- Decidir se um empréstimo ou financiamento deve ser aprovado.

• Gestão de risco -- Avaliar o risco de inadimplência de um cliente.

• Cobrança -- Identificar dívidas em aberto para negociação.

Diferenças fundamentais entre os dois tipos

Quando usar dados cadastrais

Dados cadastrais são suficientes para a maioria dos processos de validação de identidade. Use-os quando precisar:

• Confirmar que um CPF é válido e pertence a uma pessoa real.
• Verificar se o nome informado corresponde ao titular do CPF.
• Validar a data de nascimento para verificação de idade.
• Cumprir requisitos básicos de KYC no onboarding.

Exemplo prático: validação no cadastro

import requests

def validar_cadastro(cpf, nome_informado):
    url = f"https://api.cpfhub.io/cpf/{cpf}"
    headers = {
    "x-api-key": "SUA_CHAVE_DE_API",
    "Accept": "application/json"
    }

    response = requests.get(url, headers=headers, timeout=10)
    dados = response.json()

    if not dados.get("success"):
    return {"aprovado": False, "motivo": "CPF não encontrado"}

    nome_oficial = dados["data"]["name"].strip().lower()
    nome_input = nome_informado.strip().lower()

    if nome_oficial != nome_input:
    return {"aprovado": False, "motivo": "Nome não confere com o CPF"}

    return {
    "aprovado": True,
    "nome_oficial": dados["data"]["name"],
    "data_nascimento": dados["data"]["birthDate"]
    }

resultado = validar_cadastro("12345678900", "João da Silva")
print(resultado)

Quando usar dados financeiros

Dados financeiros são necessários quando a decisão envolve risco financeiro direto. Use-os quando precisar:

• Aprovar ou negar um empréstimo ou financiamento.
• Definir limites de crédito para um cliente.
• Avaliar o risco de inadimplência antes de uma venda a prazo.
• Negociar dívidas em aberto.

Combinando os dois tipos de dados

A abordagem mais eficiente para processos completos de análise é combinar dados cadastrais e financeiros em etapas:

1. Etapa 1: Validação cadastral -- Consultar a API de dados cadastrais para confirmar que o CPF é válido e que os dados informados estão corretos. Essa etapa é rápida e de baixo custo.

2. Etapa 2: Análise financeira (se necessário) -- Somente para CPFs que passaram na validação cadastral, consultar o bureau de crédito para obter o score e o histórico financeiro. Essa etapa é mais cara e mais lenta.

Essa estratégia em camadas evita consultas desnecessárias aos bureaus de crédito, que custam significativamente mais por consulta.

Implicações da LGPD

A Lei Geral de Proteção de Dados (LGPD) se aplica tanto a dados cadastrais quanto a dados financeiros, mas com nuances diferentes:

• Dados cadastrais -- O tratamento pode ser justificado por bases legais como execução de contrato ou cumprimento de obrigação legal, além do consentimento do titular.

• Dados financeiros -- Por se tratarem de dados mais sensíveis em termos de impacto, exigem cuidado redobrado na definição da base legal e na demonstração da necessidade.

Em ambos os casos, é fundamental garantir que apenas os dados estritamente necessários sejam coletados e armazenados, seguindo o princípio da minimização. A Autoridade Nacional de Proteção de Dados (ANPD) publica orientações atualizadas sobre bases legais e boas práticas de tratamento de dados pessoais.

Perguntas frequentes

Dados cadastrais de CPF incluem informações de renda ou dívidas?

Não. Dados cadastrais retornam apenas informações de identificação: nome completo, data de nascimento e gênero. Informações de renda, dívidas em aberto, score de crédito e protestos pertencem à categoria de dados financeiros e são fornecidos por bureaus de crédito como Serasa e SPC, mediante autorização específica.

Qual a diferença de custo entre consultar dados cadastrais e dados financeiros?

Dados cadastrais custam centavos por consulta — a CPFHub.io, por exemplo, cobra R$0,15 por consulta excedente ao plano. Dados financeiros de bureaus de crédito custam vários reais por consulta e exigem contratos específicos. Para processos de onboarding e verificação de identidade, dados cadastrais são a opção mais econômica e suficiente.

Preciso de consentimento do usuário para consultar dados cadastrais de CPF via API?

Depende da finalidade e da base legal utilizada. A LGPD permite o tratamento de dados cadastrais para execução de contrato, cumprimento de obrigação legal e legítimo interesse, sem necessidade de consentimento explícito em muitos contextos — como onboarding de clientes ou emissão de notas fiscais. O consentimento é apenas uma das bases legais disponíveis.

A API da CPFHub.io retorna dados financeiros?

Não. A API da CPFHub.io retorna exclusivamente dados cadastrais: CPF, nome completo, nome em maiúsculas, gênero, data de nascimento (e os campos separados de dia, mês e ano). Para análise de crédito e dados financeiros, é necessário contratar um bureau de crédito separadamente.

Conclusão

Dados cadastrais e dados financeiros de CPF atendem a necessidades distintas. Dados cadastrais, como os fornecidos pela CPFHub.io, são ideais para verificação de identidade, onboarding e prevenção de fraudes — com baixo custo e integração simples. Dados financeiros, por sua vez, são necessários apenas quando a decisão envolve risco de crédito direto.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e valide identidades de clientes com dados cadastrais precisos diretamente na sua aplicação.