NovoCentral de APIs
Cadastral

Receita Federal - Pessoa Física

Situação do CPF na Receita Federal: regularidade, inscrição e indicador de óbito.

Fonte
Receita Federal do Brasil
Entrada
CPF
Comprovante PDF
R$ 0,54 por chamada
Preço
R$ 0,36 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/receita-federal-pessoa-fisica?cpf=00000000000

Para que serve

Confirma na Receita Federal se o CPF existe e está regular, com nome, data de nascimento, data de inscrição e o indicador de óbito. É a checagem básica antes de qualquer cadastro, contrato ou concessão de crédito para pessoa física.

Ideal para

Onboarding e KYCCadastro de produtoresPrevenção a fraudeConcessão de crédito

Por que usar

  • Barre CPF irregular cedo

    Situação suspensa, cancelada ou com óbito aparece antes de o cadastro avançar.

  • Nome oficial

    Use o nome como a Receita registra para conferir o que o cliente informou.

  • Prova para auditoria

    Comprovante em PDF da consulta, com data e hora, guardado por 90 dias para anexar ao processo de crédito ou de compliance.

Parâmetros

ParâmetroDescriçãoRegra
cpfCPFCPF do titular, somente dígitos ou formatado.Obrigatório
dataNascimentoData de nascimentoData de nascimento do titular (dd/MM/aaaa). Opcional — informe se a consulta voltar pedindo a data.Opcional

O que você recebe

13 campos no retorno, como o seu sistema recebe.

  • numeroCPFDado pessoal

    CPF

    Número do CPF da pessoa física.

  • nomePessoaFisicaDado pessoal

    Nome

    Nome completo da pessoa física.

  • nomeSocialDado pessoal

    Nome social

    Nome social registrado, quando houver.

  • dataNascimentoDado pessoal

    Data de nascimento

    Data de nascimento da pessoa física.

  • situacaoCadastral

    Situação cadastral

    Situação do cadastro no órgão (ex.: Regular, Ativa, Suspensa, Baixada).

  • dataInscricao

    Data de inscrição

    Data em que o cadastro foi feito.

  • dataInscricaoAnterior1990

    Inscrito antes de 1990

    Indica se o CPF foi inscrito antes de 1990.

  • digitoVerificador

    Dígito verificador

    Dígito verificador do CPF.

  • possuiObitoDado pessoal

    Indicador de óbito

    Indica se há óbito registrado para o CPF.

  • anoObitoDado pessoal

    Ano do óbito

    Ano do óbito, quando registrado.

  • dataEmissao

    Data de emissão

    Data de emissão do documento ou da certidão.

  • codigoControleComprovante

    Código de controle

    Código emitido pela fonte para conferir a autenticidade do comprovante.

  • dataConsulta

    Data da consulta

    Data e hora em que a fonte foi consultada.

Opções da chamada

  • assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.
  • comprovante=trueGera também o comprovante da consulta em PDF (custo adicional).

Códigos de resposta

  • 200Sucesso — Consulta concluída; o retorno traz os dados da fonte.
  • 202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.
  • 422Requisição inválida — Parâmetros validados antes de qualquer cobrança.
  • 429Limite simultâneo — Até 5 consultas simultâneas por cliente.
  • 503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.

Como é cobrado

  • Débito por chamada — do saldo pré-pago ou do contrato pós-pago
  • Preço exibido na plataforma antes de executar
  • Falhas estornadas automaticamente
  • Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/receita-federal-pessoa-fisica?cpf=00000000000" \  -H "X-Api-Key: $AGROLITICS_API_KEY"
Resposta · envelope padrão
200 OK
{  "metaDados": {    "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90",    "apiIdentificador": "receita-federal-pessoa-fisica",    "apiNome": "Receita Federal - Pessoa Física",    "fonte": "Receita Federal do Brasil",    "status": "Concluída",    "resultado": "Sucesso",    "tempoExecucaoMs": 1840,    "assincrono": false,    "urlComprovante": null  },  "retorno": { /* dados da fonte — variam por consulta */ }}
Referência completa no Swagger

Perguntas frequentes sobre Receita Federal - Pessoa Física

É opcional. Informe se a consulta voltar pedindo a data, o que a Receita exige em alguns casos.

Comece a integrar

Leve as fontes oficiais do agro para dentro do seu sistema

Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.

  • APIs de fontes oficiais, com resposta padronizada
  • Pague por chamada — sem mensalidade, falhas estornadas
  • API do Dossiê BNIR com lotes de até 1.000 CARs
  • Webhooks assinados e comprovante em PDF
  • Conformidade LGPD — fontes oficiais, log auditável

Solicite uma Demonstração

Nossa equipe entrará em contato em breve.

Sem compromisso. Seus dados são usados só para este contato, conforme a Política de Privacidade.