WebService de Consulta CPF

Saiba mais sobre o WebService de Consulta CPF

O WebService de Consulta CPF do Hub do Desenvolvedor consulta a base da Receita Federal em tempo real e retorna os dados oficiais do documento: nome completo do titular, situação cadastral e data de nascimento. É a forma mais rápida de validar se um CPF existe, se está regular e se pertence mesmo à pessoa que está preenchendo o seu cadastro, tudo por uma chamada de API com resposta em JSON ou XML.

O que a consulta de CPF retorna

A cada consulta, a API devolve o nome completo registrado na Receita Federal, a data de nascimento do titular e a situação cadastral do CPF. Com esses três dados você confirma a identidade do usuário no momento do cadastro, sem depender de digitação correta ou de documentos enviados por foto.

O que é a situação cadastral do CPF?

É o status oficial do documento na Receita Federal. Um CPF pode estar em uma destas situações: Regular (sem pendências), Pendente de Regularização (alguma declaração não foi entregue), Suspensa (cadastro com inconsistências), Cancelada (duplicidade ou decisão administrativa), Titular Falecido ou Nula (fraude constatada). Sistemas de crédito, marketplaces, fintechs e RHs usam essa informação para barrar cadastros de risco antes de qualquer transação.

Preciso da data de nascimento para consultar?

A consulta direta na Receita Federal exige CPF e data de nascimento. Se o seu sistema não tem a data de nascimento do usuário, o Hub resolve isso automaticamente: nossa infraestrutura localiza a data vinculada ao CPF e completa a consulta na Receita para você, na mesma chamada. Você envia só o número do CPF e recebe o retorno completo.

Para que serve na prática?

Os usos mais comuns dos nossos clientes: validação de cadastro (KYC) em fintechs e plataformas, prevenção à fraude em e-commerces e marketplaces, análise de crédito e cobrança, admissão em RH e departamento pessoal, e higienização de bases de clientes (identificar CPFs cancelados ou de titulares falecidos antes de uma campanha ou de uma cobrança).

Qual a diferença para o WebService de Dados por CPF?

Este WebService (Consulta CPF) traz os dados oficiais da Receita: nome, situação cadastral e nascimento. Já o WebService de Dados por CPF (cadastral) é um serviço de enriquecimento: retorna telefones, endereços, e-mails e nome da mãe vinculados ao documento. Muitos clientes usam os dois em conjunto, valida na Receita e enriquece o cadastro na sequência, e ambos estão incluídos no mesmo plano.

Como integro a consulta de CPF no meu sistema?

A integração é uma requisição HTTP simples: você chama o endpoint com o CPF e o seu token e recebe a resposta em JSON (ou XML) em segundos. Funciona com qualquer linguagem – PHP, Python, Node.js, Java, C#, Delphi – e a documentação traz exemplos prontos. Antes de integrar, dá para testar aqui mesmo na página, no botão “Faça um teste”.

A consulta de CPF é segura e está adequada à LGPD?

Sim. As consultas trafegam por HTTPS, exigem token de autenticação com controle de IPs permitidos, e o tratamento de dados segue a LGPD. O uso é restrito a finalidades legítimas como validação cadastral, prevenção à fraude e cumprimento de obrigações legais, e formalizamos contrato de tratamento de dados com os clientes.

Quanto custa consultar CPF via API?

O Hub trabalha com planos mensais de créditos a partir de R$ 39,90, e os créditos valem para todos os mais de 20 WebServices do catálogo (CPF, CNPJ, CEP, frete e outros) sem custo por serviço separado. Você pode criar sua conta e testar grátis por 3 dias antes de assinar.