---
title: "Consulta de CPF — Receita Federal | NFE.io Docs"
description: "Consulte a situação cadastral de um CPF via página pública da Receita Federal. Endpoint /v1/naturalperson/status com coleta direta no portal público da RFB."
source_url: https://nfe.io/docs/documentacao/consultas/consulta-cpf-receita-federal
last_updated: 2026-05-29
---

# Consulta de CPF — Receita Federal

> Esta modalidade consulta a situação cadastral de um CPF a partir da página pública da Receita Federal. É a opção indicada para volumes altos e menor custo por consulta.

A consulta retorna os dados do Comprovante de Situação Cadastral disponíveis em [servicos.receita.fazenda.gov.br](https://servicos.receita.fazenda.gov.br/servicos/cpf/consultasituacao/consultapublica.asp). A API faz a coleta direta no portal público da RFB a cada requisição e retorna a situação cadastral correspondente.

> ![Tela de consulta de Situação Cadastral do CPF no portal da Receita Federal](https://nfe.io/docs/static/docs/consultas/image_2021-05-06_101847.png)
> **Figura 1.** Página pública de consulta de Situação Cadastral do CPF.

> ![Exemplo de retorno do Comprovante de Situação Cadastral do CPF](https://nfe.io/docs/static/docs/consultas/image_2021-05-06_103732.png)
> **Figura 2.** Comprovante de Situação Cadastral retornado pela Receita Federal.

## 1. Base para a consulta

Para consultar a situação cadastral de um CPF nesta modalidade, informe o número do CPF e a data de nascimento da pessoa. O endpoint é único e está descrito abaixo.

| Método | URL                                                                                                  |
| ------ | ---------------------------------------------------------------------------------------------------- |
| GET    | `https://naturalperson.api.nfe.io/v1/naturalperson/status/{federalTaxNumber}/{birthDate}`            |

Parâmetros de caminho:

- `federalTaxNumber` — CPF sem máscara, somente dígitos (sem pontos nem traços).
- `birthDate` — data de nascimento no formato `aaaa-mm-dd`.

### Autenticação

Você precisa de uma chave de API. Crie sua conta em [nossa plataforma](/docs/documentacao/nossa-plataforma/criar-conta/) e gere a chave conforme [chaves de autenticação](/docs/documentacao/nossa-plataforma/chaves-de-autenticacao/). A API aceita três formas equivalentes de envio:

| Modo                 | Exemplo                                              |
| -------------------- | ---------------------------------------------------- |
| Header `Authorization` | `Authorization: Bearer {apiKey}`                   |
| Header `X-NFEIO-APIKEY` | `X-NFEIO-APIKEY: {apiKey}`                        |
| Query string          | `?apiKey={apiKey}`                                  |

### Exemplo de chamada

```bash
curl -X GET \
  "https://naturalperson.api.nfe.io/v1/naturalperson/status/72946154***/****-**-**" \
  -H "Authorization: Bearer 5th************"
```

## 2. Quando usar esta modalidade

Use a consulta Receita Federal quando o seu fluxo prioriza menor custo por consulta. A latência pode variar conforme a disponibilidade do portal público da RFB (coleta direta com solver de captcha).

| Aspecto              | Receita Federal                                       | Irrestrita                                           |
| -------------------- | ----------------------------------------------------- | ---------------------------------------------------- |
| Fonte                | Página pública da RFB (coleta direta)                 | Base de dados irrestrita (comercial)                 |
| Latência             | Pode variar com o portal público da RFB               | Consistente                                          |
| `socialName`         | Pode não vir                                          | Confiável quando consta na base                      |
| Custo                | Menor                                                 | Maior (consulta comercial)                           |
| Recomendado para     | Volume alto e menor custo                             | Consultas críticas com cobertura ampla               |

Para a outra modalidade, veja [Consulta de CPF — Irrestrita](/docs/documentacao/consultas/consulta-cpf-irrestrita/).

## 3. Dados de retorno

A API responde com os seguintes códigos HTTP:

| Status | Significado                                                |
| ------ | ---------------------------------------------------------- |
| 200    | Sucesso na requisição                                      |
| 400    | Parâmetro informado de forma incorreta                     |
| 401    | Autenticação inválida                                      |
| 403    | Sem permissão para o recurso                               |
| 404    | CPF não encontrado ou data de nascimento divergente        |
| 500    | Erro no processamento                                      |
| 503    | Temporariamente indisponível                               |

O payload de retorno segue o formato abaixo.

```json
{
  "createdOn": "2026-05-27T13:09:16.346Z",
  "name": "string",
  "socialName": "string",
  "federalTaxNumber": "string",
  "birthOn": "1980-01-01T00:00:00.000Z",
  "status": "Regular"
}
```

### Dicionário de campos

---

**createdOn** _string($date-time)_
Data da consulta.

---

**name** _string_
Nome da pessoa consultada.

---

**socialName** _string?_
Nome social. Pode vir nulo nesta modalidade quando o portal público não expõe o campo. Para retorno mais confiável de nome social, use a consulta [Irrestrita](/docs/documentacao/consultas/consulta-cpf-irrestrita/).

---

**federalTaxNumber** _string_
CPF consultado.

---

**birthOn** _string($date-time)_
Data de nascimento.

---

**status** _string(enum)_
Situação cadastral do CPF.

| Texto do retorno          | Significado                |
| ------------------------- | -------------------------- |
| **Unknown**               | Desconhecido               |
| **Regular**               | Regular / ativo            |
| **Null**                  | Nulo                       |
| **Suspended**             | Suspenso                   |
| **Canceled**              | Cancelado                  |
| **RegularizationPending** | Pendente de regularização  |
| **OwnerDeceased**         | Titular falecido           |

---