A API de consulta de CPF na Receita Federal é a integração que devolve, em segundos e direto no sistema da empresa, a situação cadastral e os dados básicos de uma pessoa física. Para bancos, fintechs, financeiras, seguradoras e operações de cobrança, ela substitui a consulta manual no site da Receita e dá escala à validação de cadastros. Neste guia, você vê o que mudou na consulta em 2026, quais dados a API retorna, como comparar as opções do mercado e como integrar ao seu sistema.
API Receita Federal: o que é e como funciona a consulta de CPF
Uma API Receita Federal para CPF é um serviço que recebe o número do documento e devolve as informações cadastrais do titular. Em vez de um analista digitar CPF por CPF no portal, o sistema da empresa faz a consulta sozinho e recebe a resposta em formato padronizado, geralmente em JSON.
Na prática, existem dois caminhos. O primeiro é a solução oficial do governo, a Consulta CPF do Serpro, contratada por empresas com certificado digital e-CNPJ. O segundo são as APIs de terceiros que fazem a consulta à Receita Federal de forma automatizada e entregam os dados da Receita em tempo real, sem vínculo oficial com o órgão.
Quem usa a API de consulta de CPF
A API cpf aparece em quase todo processo que depende de um cadastro confiável. Por exemplo:
- Análise de crédito: confirmar que o CPF existe e está regular antes de aprovar uma proposta.
- Onboarding e prevenção a fraudes: barrar cadastros com CPF suspenso, cancelado ou nulo.
- Cobrança: validar o devedor antes de negativar ou de entrar com uma ação.
- RH e admissão: conferir os dados do candidato antes da contratação.
- Seguros e locação: checar o titular antes de emitir apólice ou contrato.
Em todos esses casos, a automação reduz erro de digitação, acelera a decisão e deixa um registro de cada consulta.
API Receita Federal: o que mudou na consulta de CPF em 2026
Em 2026, a Receita Federal mudou as regras da consulta de CPF. Com a Portaria RFB nº 667/2026, a nova versão da Consulta CPF passou a exigir o CPF e a data de nascimento do titular. Ou seja, a consulta deixa de depender de um único dado isolado.
Além disso, a nova versão passou a informar o nome social, quando existe, e a data de inscrição no cadastro. Segundo o Serpro, em 12 de outubro de 2026, 96% das requisições já usavam a nova versão.
O que isso muda para quem integra
Para as empresas, a mudança tem um efeito direto: sistemas que enviam só o número do CPF precisam ser adaptados. Por isso, o formulário de cadastro deve pedir a data de nascimento e avisar na hora quando o dado for rejeitado. Além disso, a data ajuda a confirmar a maioridade do cliente, exigência que ganhou força com o ECA Digital (Lei 15.211/2025). Do mesmo modo, o motor de crédito e a esteira de cobrança devem capturar e enviar a data de nascimento junto com o documento.
O Valida Fácil, da Think Data, já faz a consulta à Receita Federal com CPF e data de nascimento. Assim, a empresa segue a regra nova sem precisar refazer a integração.
API de consulta de CPF: dados retornados e status do CPF
A consulta na Receita Federal devolve, em JSON, um conjunto enxuto de informações:
- nome completo e nome social;
- situação cadastral do CPF;
- data da situação cadastral;
- data de inscrição no cadastro;
- código de controle do comprovante, que serve de registro da consulta.
Por outro lado, a Receita não devolve endereço, telefone nem e-mail. Por isso, para cobrança, contato e prevenção a fraudes, esses dados fazem falta.
Situação cadastral e status do CPF: o que cada um significa
Vale destacar que os status abaixo não são erros da API. Na verdade, são a resposta da Receita sobre a situação do titular, e cada um pede uma ação diferente da empresa:
| Status do CPF | O que significa | O que a empresa deve fazer |
|---|---|---|
| Regular | Cadastro sem pendências | Seguir com a análise |
| Pendente de regularização | O titular deixou de entregar alguma declaração | Pedir regularização antes de aprovar |
| Suspensa | Cadastro com dados incorretos ou incompletos | Bloquear e pedir correção |
| Cancelada | CPF cancelado por decisão administrativa ou judicial | Recusar o cadastro |
| Titular falecido | Óbito informado à Receita | Recusar e acionar a área de fraude ou de espólio |
| Nula | Inscrição anulada por fraude | Recusar e registrar como tentativa de fraude |
Além da Receita: os dados que fecham a análise
Assim, para ir além da situação cadastral, o Valida Fácil retorna endereço atual e histórico, e-mails, telefones fixos e celulares (com indicação de WhatsApp), busca de novos telefones em mais de 400 fontes, processos, veículos, participação societária e indicativo de óbito. Além disso, cada checagem complementar pode ser ligada ou desligada por consulta, o que ajuda a controlar o custo.
Já para saber se o telefone está mesmo em uso pelo titular, a Localização Garantida entrega o número validado nas operadoras. Para entender esse processo, veja também o artigo sobre consultar telefone pelo CPF.
API de consulta de CPF: gratuita, Serpro ou API completa?
Portanto, antes de escolher, vale comparar as três opções do mercado. Afinal, cada uma atende a um tipo de operação:
| Critério | API gratuita | Serpro (Consulta CPF) | Valida Fácil (Think Data) |
|---|---|---|---|
| Dados da Receita | Básicos, com cache (podem estar desatualizados) | Nome, situação cadastral, nome social e data de inscrição | Dados da Receita em tempo real |
| Endereço e telefone | ❌ Não (a Receita não devolve) | ❌ Não (a Receita não devolve) | ✅ Sim, com telefone validado nas operadoras |
| Limite de consultas | Poucas consultas, com trava por minuto ou por dia | Pela faixa contratada | Alto volume: mais de 1 milhão de chamadas por dia, individual ou em lote |
| Situação na Serasa e score | ❌ Não | ❌ Não | ✅ Sim, na plataforma da Think Data |
| Processos e veículos | ❌ Não | ❌ Não | ✅ Sim |
| Custo | Grátis, com limite | Por faixa de volume | Muito mais baixo que o Serpro |
| Contratação | Cadastro simples | Exige e-CNPJ e contrato | Teste grátis: é só solicitar |
| Disponibilidade e suporte | Sem garantia | SLA de órgão público | 99,9% e suporte dedicado |
Quando cada opção faz sentido
Em primeiro lugar, a API gratuita serve para testes e consultas pontuais, e pode até validar o consumo inicial antes da migração para uma operação estável. No entanto, o cache, a trava de consultas e a falta de suporte impedem o uso em processos de negócio.
O Serpro, por sua vez, entrega o dado oficial, mas exige e-CNPJ, contrato e um custo mais alto. Além disso, devolve só o que está na Receita.
Já uma API de consulta à Receita Federal completa, como o Valida Fácil, junta a situação cadastral com os dados de contato e de risco em uma única integração e ajuda a tomar decisões com mais segurança. Hoje, a plataforma da Think Data processa mais de 1 milhão de chamadas por dia. Por isso, ela atende crédito, cobrança e compliance ao mesmo tempo, mesmo em operações de alto volume.
Situação financeira e negativação
Além disso, para completar a análise, a Consulta CPF e CNPJ Serasa Experian mostra pendências, protestos e score do titular. Afinal, a Think Data é a maior distribuidora autorizada da Serasa Experian no Brasil. Do mesmo modo, quem usa o CPF na cobrança pode fazer a negativação de devedores na Serasa também pela Think Data.
API de consulta de CPF: como integrar ao seu sistema
Na prática, a integração é simples para a equipe de tecnologia. Em geral, o processo segue seis etapas:
- Solicite o teste: primeiro, peça o teste gratuito e receba as credenciais de acesso.
- Conecte o sistema: em seguida, ligue o seu sistema ao Web Service do Valida Fácil, com retorno em JSON.
- Envie CPF e data de nascimento: depois, mande os dois dados em cada consulta, como pede a regra nova da Receita. Antes, valide os dígitos do CPF no próprio sistema para evitar requisições desnecessárias.
- Escolha as buscas complementares: então, defina quais dados extras a consulta deve trazer, como telefones, endereço e veículos.
- Trate o status e guarde o comprovante: com a resposta em mãos, aplique a regra de cada status e arquive o comprovante da consulta.
- Processe em lote quando precisar: por fim, atualize bases inteiras de clientes ou devedores de uma vez.
Erros de integração mais comuns
Por outro lado, diferente dos status do CPF, os erros abaixo indicam falha na chamada e devem ser corrigidos pela equipe técnica:
- Data de nascimento divergente: a data enviada não bate com o cadastro da Receita.
- CPF com dígito inválido: o número não passa na validação dos dígitos verificadores.
- Credencial expirada: o acesso precisa ser renovado.
- Excesso de requisições: muitas chamadas em pouco tempo, sem controle de fila.
Por isso, trate os erros de autenticação de forma adequada e limite o número de requisições por segundo, o que protege a aplicação contra falhas. Além disso, use sempre conexão HTTPS e registre cada consulta para auditoria e histórico.
Segurança, LGPD e validação de identidade
Vale lembrar que a consulta de CPF trata dados pessoais. Por isso, a empresa precisa ter uma finalidade definida e uma base legal da LGPD, como a proteção do crédito ou a prevenção a fraudes (art. 7º). Além disso, o acesso à API exige justificativa legal e autenticação robusta. A empresa também deve consultar só os dados necessários para aquela decisão e evitar armazenar informações desnecessárias. Assim, reduz riscos e reforça a confiabilidade da operação. Da mesma forma, os dados pessoais precisam ser protegidos com criptografia em trânsito e em repouso, e os logs de auditoria não devem expor o CPF em texto aberto.
Além disso, para confirmar que o cliente é mesmo o titular do CPF, o KYC – Valida Identidade faz a verificação nas operadoras para saber se o telefone informado pertence a ele. Já para atualizar bases inteiras, o Enriquecimento Cadastral processa milhares de CPFs em lote. Alguns provedores também exigem o cadastro do IP de origem, uma camada extra de segurança. Para montar a ordem dessas checagens, leia também o guia de antifraude via API.
Quer testar antes de integrar? Então, basta solicitar o teste gratuito à Think Data.
Para conhecer gratuitamente o Valida Fácil, a Localização Garantida, o KYC – Valida Identidade e a consulta de CPF ou CNPJ na Serasa Experian, através da plataforma da Think Data, acesse: https://www.thinkdata.com.br/teste-gratuito/.
Perguntas frequentes
Tem API da Receita Federal?
Sim. Por um lado, a solução oficial é a Consulta CPF do Serpro, contratada com certificado e-CNPJ. Além dela, há APIs de terceiros que fazem a consulta à Receita Federal de forma automatizada, como o Valida Fácil, que também retorna endereço, telefone e outros dados.
A API da Receita Federal é gratuita?
Não. Na verdade, a Consulta CPF do Serpro é paga, com preço por faixa de volume. As APIs gratuitas existem, mas têm limite de consultas, usam cache e não oferecem suporte, por isso não servem para processos de negócio.
O que é API do CPF?
A API do CPF é uma integração que consulta o número do documento e devolve os dados cadastrais do titular direto no sistema da empresa. Assim, a validação deixa de ser manual e passa a acontecer em segundos, dentro do cadastro, da análise de crédito ou da cobrança.
Qual API posso usar para consultar o CPF?
Você pode usar a Consulta CPF do Serpro, que é a solução oficial, ou uma API de consulta à Receita Federal de terceiros. Para operações de crédito, cobrança e prevenção a fraudes, uma API completa, como o Valida Fácil, é a opção mais indicada, porque junta a situação cadastral com endereço, telefone e dados de risco.
Como se consulta o CPF na Receita Federal?
No portal da Receita, a consulta é manual: basta informar o CPF e a data de nascimento do titular. Já para consultar em escala, a empresa integra uma API ao sistema e recebe a situação cadastral de cada CPF automaticamente.
Existe alguma API para validar o CPF?
Sim. Uma API de consulta de CPF valida, primeiro, se o número é matematicamente válido e, depois, se o CPF existe e qual é a sua situação na Receita Federal. Além disso, uma API completa confirma se o telefone informado pertence ao titular.
Quais dados a API de consulta de CPF retorna?
A consulta na Receita retorna nome, nome social, situação cadastral, data da situação e data de inscrição. Por outro lado, uma API completa, como o Valida Fácil, acrescenta sexo, nome da mãe, endereço, telefones, e-mails, processos, veículos e participação societária, inclusive para atualizar uma lista inteira em consultas em lote.
O que mudou na consulta de CPF da Receita em 2026?
Em 2026, a consulta passou a exigir CPF e data de nascimento, conforme a Portaria RFB nº 667/2026. Além disso, a nova versão informa o nome social e a data de inscrição do titular no cadastro.
A API de consulta de CPF retorna endereço e telefone?
A Receita Federal não retorna endereço nem telefone. Já o Valida Fácil devolve esses dados e, com a Localização Garantida, entrega o telefone validado nas operadoras.
Como conseguir a API de consulta de CPF?
Para usar a API oficial, a empresa contrata a Consulta CPF na loja do Serpro, com certificado e-CNPJ. Já para usar o Valida Fácil, basta solicitar o teste gratuito à Think Data e receber as credenciais de acesso.
Posso testar a API antes de contratar?
Sim. Para isso, basta solicitar o teste gratuito à Think Data, sem compromisso, para validar o retorno das consultas antes de integrar o seu sistema.
API de consulta de CPF: conclusão
Em resumo, a API de consulta de CPF tira a validação de cadastros do trabalho manual e coloca a resposta da Receita Federal direto no sistema da empresa, em JSON, para facilitar a integração. Com a regra nova de 2026, ela também passa a exigir a data de nascimento, o que pede ajuste nas integrações. No entanto, a Receita entrega só a situação cadastral. Por isso, as empresas que decidem crédito, cobram e previnem fraudes ganham mais com uma API que junta, em uma só consulta, os dados da Receita, o contato validado e a informação de risco, reforçando a proteção da operação ao validar o Cadastro de Pessoas Físicas.
Para conhecer gratuitamente o Valida Fácil, a Localização Garantida, o KYC – Valida Identidade e a consulta de CPF ou CNPJ na Serasa Experian, através da plataforma da Think Data, acesse: https://www.thinkdata.com.br/teste-gratuito/.
