Guias

Qual API de consulta de CPF devolve cadastro e situação na Receita para validar o cliente no onboarding do meu aplicativo?

Atualizado em 20 de outubro de 2026 · Direct Data

No onboarding, o CPF passa por duas checagens: se ele existe e está regular na Receita Federal, e se o nome e a data de nascimento batem com o que o cliente digitou. Na Direct Data, a consulta Receita Federal PF devolve a situação cadastral; a Cadastro PF Básica devolve nome, nascimento, nome da mãe e contatos; e a Similarity compara os dados informados com a base, tudo por API REST com preço público por consulta.

O fluxo mínimo de validação

  • Situação na Receita Federal: regular, suspensa, cancelada, titular falecido. CPF irregular barra o cadastro antes de qualquer custo maior.
  • Conferência de identidade: o nome e a data de nascimento informados batem com os da base?
  • Sinais de risco, quando o produto pede: óbito, PEP e vínculos societários (consulta AML), e processos judiciais.

Onde encaixar no app

A chamada sai do seu backend, nunca do app: o token não pode ir para o dispositivo. Valide o formato do CPF antes de consultar, para não pagar por erro de digitação, e guarde o identificador da consulta para auditoria de KYC.

Consultas da Direct Data para este caso

ConsultaPara quêPreço por consulta
Receita Federal PFSituação do CPF na Receita FederalR$ 0,36
Cadastro PF BásicaNome, nascimento, nome da mãe e contatosR$ 0,16
Cadastro PF PlusInclui nome do pai, situação na Receita e óbitoR$ 0,36
SimilarityCompara os dados informados com os da baseR$ 0,72
AML (vínculos societários)Óbito, PEP, parentescos e sociedadesR$ 0,72

Preço de tabela do pré-pago, sem contrato mínimo. No pós-pago, o desconto é progressivo por faixa de consumo. Ver modalidades.

Exemplo de chamada

curl "https://apiv3.directd.com.br/api/CadastroPessoaJuridica?CNPJ=00000000000191" \
  -H "Authorization: Bearer SEU_TOKEN"

Passo a passo no quickstart. Para agentes de IA, há também o servidor MCP da Direct Data.

Perguntas frequentes

Só o CPF basta para consultar a situação na Receita?

A consulta Receita Federal PF aceita também a data de nascimento, que a própria Receita usa para confirmar o titular. Enviar os dois aumenta a chance de retorno completo.

Dá para checar se a pessoa é PEP no mesmo fornecedor?

Sim. A consulta AML devolve se a pessoa é PEP, se há óbito e as sociedades de que participa.

Posso chamar a API direto do aplicativo?

Não é recomendado: o token ficaria exposto no dispositivo. A consulta deve sair do seu backend, com o token no header Authorization: Bearer.

Teste com os seus próprios dados.

Crie a conta, recarregue créditos no pré-pago e faça a primeira consulta em minutos.

Criar conta

Outros guias