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. A API faz a coleta direta no portal público da RFB a cada requisição e retorna a situação cadastral correspondente.
Figura 1. Página pública de consulta de Situação Cadastral do CPF.
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 formatoaaaa-mm-dd.
Autenticação
Você precisa de uma chave de API. Crie sua conta em nossa plataforma e gere a chave conforme chaves de autenticação. 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
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.
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.
{
"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.
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 |