Como consultar CPF na Receita Federal via API?

Você faz uma requisição HTTP GET ao endpoint da API CPF.CNPJ enviando o CPF e seu token de autenticação no cabeçalho. A API consulta a base oficial da Receita Federal e retorna em JSON o nome do titular, a situação cadastral e, conforme a permissão, a data de nascimento. Não há captcha nem dependência do site do governo.

A consulta de CPF é em tempo real?

Sim. A consulta é feita na fonte oficial no momento da chamada (D+0) e retorna a situação cadastral atual do CPF, sem cache desatualizado. A resposta média fica entre 0,4 e 2 segundos.

Quais dados a API de CPF retorna?

A API retorna o nome completo do titular e a situação cadastral (Regular, Pendente de Regularização, Suspensa, Cancelada, Nula ou Titular Falecido). Quando o pacote contratado e as regras de uso permitem, também retorna a data de nascimento associada ao CPF.

É legal e está de acordo com a LGPD consultar CPF?

Sim, desde que haja base legal e finalidade legítima, como prevenção a fraudes, cumprimento de obrigação regulatória ou execução de contrato. A consulta usa a fonte oficial e a CPF.CNPJ opera com certificações de segurança e privacidade (ISO/IEC 27001 e 27701). Cabe ao contratante garantir a base legal de tratamento prevista na LGPD para o uso dos dados.

Quanto custa a API de consulta de CPF?

O preço é por consulta e varia conforme o volume contratado, a partir de R$ 0,13 por consulta nos pacotes de maior volume. Você cria a conta gratuitamente, recebe créditos para teste e consulta os planos atualizados na página de preços.

//API CPF

API de Consulta de CPF na Receita Federal

Na CPF.CNPJ, nós simplificamos e agilizamos o acesso a informações essenciais de pessoas físicas e jurídicas.

Por que consultar o CPF diretamente na Receita Federal

O CPF é o identificador oficial de pessoas físicas no Brasil, mas o número, por si só, não comprova nada: dígitos válidos no algoritmo de verificação não significam que o CPF exista, esteja regular ou pertença à pessoa informada. Sem consultar a base da Receita Federal, empresas aceitam cadastros com CPF inexistente, de terceiros ou em situação irregular, abrindo brecha para fraude de identidade, fraude documental e descumprimento de obrigações de prevenção a fraudes no onboarding.

A consulta retorna a situação cadastral do CPF, que pode estar Regular, Pendente de Regularização, Suspensa, Cancelada, Nula ou indicar Titular Falecido. Cada situação tem efeito prático: um CPF Suspenso ou Pendente impede emissão de notas e contratações; um CPF Cancelado ou de titular falecido usado em um cadastro novo é forte indício de fraude. Validar essa situação antes de aprovar o cliente é o que separa um onboarding seguro de um passivo de fraude e compliance.

Fazer isso manualmente não escala. Equipes que processam milhares de cadastros por dia não conseguem conferir CPF a CPF no site da Receita, que ainda exige captcha e não oferece resposta programática. Uma API de consulta de CPF resolve o gargalo: integra a verificação diretamente no fluxo de cadastro, retorna a situação cadastral em tempo real e permite automatizar a decisão de aprovar, reprovar ou enviar o caso para revisão humana.

O que a API de Consulta de CPF entrega

1. Nome e situação cadastral oficiais

A API retorna o nome completo do titular e a situação cadastral do CPF exatamente como constam na base da Receita Federal: Regular, Pendente de Regularização, Suspensa, Cancelada, Nula ou Titular Falecido. Com esses dados você confronta o nome declarado pelo cliente com o nome oficial e bloqueia automaticamente CPFs que não estejam regulares.

2. Data de nascimento conforme permissão

Quando o pacote contratado e as regras de uso permitem, a resposta inclui a data de nascimento associada ao CPF. Isso viabiliza checagens adicionais como conferência de maioridade (18+) e cross-matching de data declarada contra a data oficial, reforçando a prevenção a fraude de identidade sintética.

3. Resposta em tempo real (D+0)

A consulta é feita na fonte oficial e responde em tempo real, sem cache desatualizado. A situação cadastral refletida é a do momento da consulta (D+0), garantindo que decisões de onboarding usem o estado atual do CPF e não um snapshot antigo.

4. REST/JSON com autenticação por token

A integração é uma API REST que retorna JSON, autenticada por um token enviado no cabeçalho da requisição. Não há captcha, não há dependência de tela do governo: basta uma chamada HTTP a partir do seu backend para receber os dados estruturados e tratá-los no seu fluxo.

Como integrar a Consulta de CPF

A consulta é uma chamada HTTP GET autenticada por token Bearer. Envie o CPF como parâmetro e receba a situação cadastral em JSON. Exemplo com cURL:

# Consulta de CPF na Receita Federal via API
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/12345678909" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json"

# Resposta (JSON)
{
  "status": 1,
  "cpf": "123.456.789-09",
  "nome": "JOSE DA SILVA",
  "situacao_cadastral": "REGULAR",
  "data_nascimento": "1990-05-14",
  "data_consulta": "2026-06-02T10:32:11Z"
}

Trate o campo situacao_cadastral no seu backend: aprove apenas CPFs REGULAR, bloqueie CANCELADA, NULA e TITULAR FALECIDO, e envie PENDENTE ou SUSPENSA para revisão. A referência completa de endpoints, pacotes e códigos de retorno está em https://www.cpfcnpj.com.br/dev/.

O que esperar da API de Consulta de CPF

Latência baixa: Resposta média entre 0,4 e 2 segundos por consulta de CPF
Uptime 99,9%: Disponibilidade do serviço para integrar a consulta no seu onboarding
Fonte oficial Receita Federal: Situação cadastral consultada na base oficial, sem dado intermediário
Cobertura nacional: Consulta de qualquer CPF emitido no Brasil, em tempo real (D+0)