Cadastro Pessoal com Receita Federal

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/cadastro-rf-pf

R$ 0,75 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Consulta, em uma única chamada, o cadastro de uma pessoa física a partir do CPF e a situação desse CPF perante a Receita Federal. A resposta traz duas seções independentes: receita, com a situação cadastral oficial e os dados do comprovante de inscrição, e cadastro, com o perfil da pessoa (nome, nascimento, filiação, telefones, endereços, e-mails e estimativas de renda).

É o endpoint indicado para onboarding de clientes e fornecedores, validação de identidade, análise de crédito, KYC e prevenção a fraudes — casos em que é preciso, ao mesmo tempo, localizar a pessoa e comprovar que o CPF dela está regular.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/cadastro-rf-pf?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF (somente números, 11 dígitos)	000.000.000-00

Resposta

Seção receita — situação na Receita Federal

Identificação: numeroCPF, nomePessoaFisica, nomeSocial, dataNascimento, digitoVerificador
Situação: situacaoCadastral (REGULAR, PENDENTE DE REGULARIZAÇÃO, SUSPENSA, CANCELADA, NULA ou TITULAR FALECIDO)
Inscrição: dataInscricao e dataInscricaoAnterior1990
Óbito: possuiObito e anoObito
Comprovante: dataEmissao, codigoControleComprovante e link_validacao

Seção cadastro — perfil da pessoa

Identificação: cpf, nome, dataNascimento, idade, sexo, signo
Filiação: nomeMae
Contato: telefones (com tipo, operadora, indicador de WhatsApp e de bloqueio de telemarketing), enderecos (completos, com CEP) e emails
Renda: rendaEstimada e rendaFaixaSalarial

Exemplo — 200 OK

{
  "receita": {
    "anoObito": null,
    "numeroCPF": "string",
    "nomeSocial": null,
    "dataEmissao": "string",
    "possuiObito": "boolean",
    "dataInscricao": "string",
    "dataNascimento": "string",
    "link_validacao": "string",
    "nomePessoaFisica": "string",
    "digitoVerificador": "string",
    "situacaoCadastral": "string",
    "codigoControleComprovante": "string",
    "dataInscricaoAnterior1990": null
  },
  "cadastro": {
    "cpf": "string",
    "nome": "string",
    "sexo": "string",
    "idade": "number",
    "signo": "string",
    "emails": [
      {
        "enderecoEmail": "string"
      }
    ],
    "nomeMae": "string",
    "enderecos": [
      {
        "uf": "string",
        "cep": "string",
        "bairro": "string",
        "cidade": "string",
        "numero": "string",
        "logradouro": "string",
        "complemento": "string"
      }
    ],
    "telefones": [
      {
        "whatsApp": "boolean",
        "operadora": "string",
        "tipoTelefone": "string",
        "telefoneComDDD": "string",
        "telemarketingBloqueado": "boolean"
      }
    ],
    "rendaEstimada": "string",
    "dataNascimento": "string",
    "rendaFaixaSalarial": "string"
  }
}

O JSON Schema desta consulta é longo demais para caber aqui. A íntegra está na versão em Markdown desta página e na especificação OpenAPI.

Códigos de erro

Código	Mensagem	Quando acontece
400	Requisição Inválida	a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado	o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado	o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado	o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado	o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta	o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção	a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

Comprovação na fonte oficial: o campo link_validacao é uma URL do site da Receita Federal que reexibe o comprovante desta consulta, com nome e situação cadastral. Serve como evidência auditável de que a situação retornada é a que a Receita Federal apresentava no momento da consulta (dataEmissao).
Inscrições antigas: CPFs inscritos antes de 10/11/1990 não têm data exata registrada na Receita Federal. Nesses casos dataInscricao vem nula, e dataInscricaoAnterior1990 vem true quando se sabe que esse é o motivo. Só é devolvida uma data quando a Receita Federal de fato a registra — nenhuma data é presumida.
Formato das datas: dataNascimento e dataInscricao vêm como dd/mm/aaaa hh:mm:ss, com a hora sempre 00:00:00. dataEmissao traz a hora real da emissão do comprovante.
Ordem das listas: telefones e enderecos vêm do registro mais recente para o mais antigo.
Renda é estimativa: rendaEstimada e rendaFaixaSalarial são estimativas estatísticas, não valores declarados.
Situação em tempo real: a seção receita é apurada na consulta, sem reaproveitamento de resultado anterior — o que o cliente recebe é a situação cadastral vigente naquele momento.
Titular não localizado: quando não há registro para o CPF informado, a consulta retorna 404.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.