Receita Federal - Pessoa Física

GET https://app.fontedata.com/api/v1/consulta/receita-federal-pf
R$ 0,54 por consulta

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

Consulta em tempo real (sem cache) a situação cadastral e dados fiscais de uma pessoa física direto na Receita Federal. Basta informar o CPF — não precisa de mais nada.

É uma consulta essencial para processos de validação de identidade, onboarding de clientes e fornecedores, análise de risco de crédito e detecção de fraudes.

Requisição

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

Parâmetros

NomeTipoDescriçãoExemplo
cpf obrigatórioCPFCPF (somente números, 11 dígitos)000.000.000-00

Resposta

A consulta retorna os seguintes campos:

  • numeroCPF — Número do documento
  • nomePessoaFisica — Nome registrado do indivíduo
  • nomeSocial — Nome social, quando registrado
  • dataNascimento — Data de nascimento
  • situacaoCadastral — Status atual do registro
  • dataInscricao — Data de inscrição no cadastro
  • dataInscricaoAnterior1990 — Indicador se a inscrição é anterior a 1990
  • digitoVerificador — Dígito verificador do CPF
  • dataEmissao — Data e hora exatas em que a consulta foi realizada (sempre ao vivo, nunca cache)
  • codigoControleComprovante — Código de controle oficial do comprovante emitido pela Receita Federal nesta consulta
  • link_validacaoLink de auditoria: URL oficial da Receita Federal (servicos.receita.fazenda.gov.br) que permite conferir, a qualquer momento, a autenticidade do comprovante desta consulta específica — mostra CPF, nome e situação cadastral direto na fonte
  • possuiObito — Indicador de óbito (verdadeiro ou falso)
  • anoObito — Ano de óbito, quando aplicável

Todos os dados são padronizados e refletem informações oficiais, consultadas no momento exato da requisição — nunca uma resposta em cache.

Exemplo — 200 OK
{
  "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
}
Schema da resposta (JSON Schema)
JSON Schema
{
  "type": "object",
  "properties": {
    "anoObito": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ano do óbito."
    },
    "numeroCPF": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do CPF."
    },
    "nomeSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome social da pessoa."
    },
    "dataEmissao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data e hora da emissão do comprovante."
    },
    "possuiObito": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se há registro de óbito."
    },
    "dataInscricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de inscrição."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento."
    },
    "link_validacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link de auditoria: URL oficial da Receita Federal para validar a autenticidade deste comprovante (mostra CPF, nome e situacao cadastral direto na fonte)."
    },
    "nomePessoaFisica": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da pessoa física."
    },
    "digitoVerificador": {
      "type": [
        "string",
        "null"
      ],
      "description": "Dígito verificador."
    },
    "situacaoCadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral."
    },
    "codigoControleComprovante": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código de controle do comprovante."
    },
    "dataInscricaoAnterior1990": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se a inscrição é anterior a 1990."
    }
  }
}

Códigos de erro

CódigoMensagemQuando acontece
400CPF inválidoO CPF informado é inválido ou está ausente. Envie um CPF com 11 dígitos (com ou sem pontuação).
401Não autenticadoChave de API ausente ou inválida. Verifique o header X-API-Key.
403Acesso negadoSaldo insuficiente ou sua chave não tem permissão para esta consulta.
404CPF não encontradoO CPF consultado não foi localizado na base da Receita Federal.
408Tempo esgotadoA Receita Federal demorou mais que o esperado para responder. Tente novamente em alguns instantes.
500Falha na consultaNão foi possível concluir a consulta. Se o problema persistir, entre em contato com o suporte.
502Serviço da Receita indisponívelA Receita Federal está temporariamente instável ou fora do ar. Aguarde alguns instantes e tente novamente.
503Consulta em manutençãoEsta consulta está temporariamente em manutenção. Tente novamente mais tarde.

Observações

  • Só precisa do CPF — nenhum outro parâmetro é necessário.
  • Consulta em tempo real, sem cache — cada chamada é uma consulta nova e ao vivo na fonte oficial, garantindo que os dados retornados são os mais atuais possíveis.
  • Auditável — o campo link_validacao permite comprovar, a qualquer momento e para qualquer parte interessada, que a consulta foi feita de verdade e que os dados batem com o que a Receita Federal tem registrado.
  • Uma consulta por requisição — cada solicitação deve conter um único CPF.
  • Tratamento de erros — a API retorna códigos HTTP padrão indicando sucesso ou tipo de falha (como requisição inválida, recurso não encontrado, limite de taxa ou indisponibilidade temporária).
  • Latência típica — a maioria das consultas responde em poucos segundos; em cenários raros de alta demanda na fonte oficial pode levar um pouco mais.

Utilize este endpoint em fluxos de onboarding, análise de crédito, monitoramento de conformidade e prevenção de fraudes em operações financeiras e comerciais.

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.