# API de CPF: diferença entre dados cadastrais e dados financeiros > Entenda a diferença entre dados cadastrais e dados financeiros associados ao CPF. Saiba o que cada API retorna e quando usar cada tipo. **Publicado:** 04/11/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/api-de-cpf-diferenca-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 | Campo | Descrição | Exemplo | | --- | --- | --- | | CPF | Número do documento | 12345678900 | | Nome completo | Nome do titular | João da Silva | | Gênero | Sexo (M/F) | M | | Data de nascimento | Data de nascimento do titular | 15/06/1990 | ### Exemplo de resposta da API da CPFHub.io A [**CPFHub.io**](https://www.cpfhub.io/) retorna dados cadastrais em formato JSON com latência de aproximadamente 900ms, conforme o exemplo abaixo: ```json { "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 | Campo | Descrição | Fonte | | --- | --- | --- | | Score de crédito | Pontuação de risco | Bureaus (Serasa, SPC) | | Dívidas em aberto | Valores pendentes | Bureaus de crédito | | Protestos | Títulos protestados | Cartórios | | Cheques devolvidos | Histórico de cheques | Bancos | | Consultas recentes | Quem consultou o CPF | Bureaus de crédito | ### 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 | Aspecto | Dados cadastrais | Dados financeiros | | --- | --- | --- | | O que informam | Quem é a pessoa | Como a pessoa se comporta financeiramente | | Frequência de mudança | Raramente mudam | Mudam constantemente | | Regulamentação | LGPD | LGPD + Código de Defesa do Consumidor | | Fontes principais | Bases oficiais de identificação | Bureaus de crédito (Serasa, SPC, Boa Vista) | | Custo típico | Baixo (centavos por consulta) | Alto (reais por consulta) | | Necessidade de consentimento | Conforme base legal (LGPD) | Consentimento do titular ou interesse legítimo | | APIs típicas | CPFHub.io, BigDataCorp | Serasa Experian, SPC Brasil, Quod | --- ## 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 ```python 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)](https://www.gov.br/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. ### Leia também - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) - [Onboarding digital em fintechs: como validar CPF em menos de 30 segundos](https://cpfhub.io/blog/onboarding-digital-em-fintechs-como-validar-cpf-em-menos-de-30-segundos) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) --- ## Conclusão Dados cadastrais e dados financeiros de CPF atendem a necessidades distintas. Dados cadastrais, como os fornecidos pela [**CPFHub.io**](https://www.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](https://www.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.