# Receita Federal - Pessoa Física

> Consulta em tempo real a situação cadastral de uma pessoa física na Receita Federal, sem cache — cada consulta é feita ao vivo na fonte oficial. Retorna nome, data de nascimento, situação cadastral e um link de auditoria direto no site da própria Receita Federal para validar a autenticidade do comprovante.

- **Consulta:** `receita-federal-pf`
- **Categoria:** Receita Federal
- **Preço:** R$ 0,54 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/receita-federal-pf`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/receita-federal/receita-federal-pf

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/receita-federal-pf",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/receita-federal-pf");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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_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.

### Exemplo de resposta

```json
{
  "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
{
  "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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **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.

---

Página em HTML: https://fontedata.com/docs/receita-federal/receita-federal-pf
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp