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.
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_validacao — Link 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.
{
"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ódigo
Mensagem
Quando acontece
400
CPF inválido
O CPF informado é inválido ou está ausente. Envie um CPF com 11 dígitos (com ou sem pontuação).
401
Não autenticado
Chave de API ausente ou inválida. Verifique o header X-API-Key.
403
Acesso negado
Saldo insuficiente ou sua chave não tem permissão para esta consulta.
404
CPF não encontrado
O CPF consultado não foi localizado na base da Receita Federal.
408
Tempo esgotado
A Receita Federal demorou mais que o esperado para responder. Tente novamente em alguns instantes.
500
Falha na consulta
Não foi possível concluir a consulta. Se o problema persistir, entre em contato com o suporte.
502
Serviço da Receita indisponível
A Receita Federal está temporariamente instável ou fora do ar. Aguarde alguns instantes e tente novamente.
503
Consulta em manutenção
Esta 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.