Sobre

API para consulta de CPF na Receita Federal, permitindo integração ágil, sem captcha ou data de nascimento. Assim, você obtém dados de pessoas e de empresas em tempo real, reduzindo fraudes e garantindo a confiabilidade dos cadastros em suas aplicações.

Além disso, nossa API para consulta de CPF e CNPJ tem tempo médio de resposta abaixo de 1 segundo, viabilizando a automatização de processos e a manutenção de um banco de dados completo e seguro.
Conheça mais em nosso site.

Certificações

Em 2025, obtivemos três certificações de destaque que comprovam nosso compromisso com a privacidade, a segurança da informação e o cumprimento da legislação:

Selo LGPD Selo GDPR Selo Cyber

  • Selo LGPD: atesta nossa plena conformidade com a Lei Geral de Proteção de Dados, garantindo o tratamento adequado e seguro de dados pessoais no Brasil.
  • Selo GDPR: confirma nossa adesão aos padrões europeus de proteção de dados, assegurando altos níveis de privacidade globalmente.
  • Selo CyberSec: reconhece nossas boas práticas em segurança cibernética, reforçando a proteção de sistemas e informações frente às ameaças digitais.

Para saber mais sobre nossos processos e políticas, consulte:

Veracidade e Atualização dos Dados

Disponibilizamos apenas dados atualizados em tempo real (D+0). Assim, qualquer alteração cadastral do titular é refletida exatamente conforme consta na Receita Federal. Ao contrário de muitos provedores do mercado, não utilizamos bases antigas, incompletas ou vazadas, o que nos permite garantir cobertura integral para todos os documentos consultados.

Para mais informações, acesse: www.cpfcnpj.com.br

Introdução

Este documento apresenta as diretrizes para integrar rapidamente aos serviços da CPF.CNPJ via HTTP (HTTP API).
Qualquer linguagem de programação é compatível com nossa solução.

Regras de Uso

Para evitar o uso indevido da API e manter sua alta disponibilidade, estabelecemos as seguintes restrições:

  • Após 3 consultas consecutivas com Token inválido: bloqueio de 5 minutos;
  • Após 3 consultas consecutivas do mesmo CPF/CNPJ no mesmo pacote em menos de 1 minuto: bloqueio de 3 minutos;
  • Após 3 consultas consecutivas sem créditos em menos de 1 minuto: bloqueio de 5 minutos.

URL Base

As requisições GET são feitas em uma URL base sob protocolo HTTPS.

URL: https://api.cpfcnpj.com.br/

Firewall

Certifique-se de conceder permissões em seu firewall para os IPs da CloudFlare.

Acesse a lista de IPs para liberação: https://www.cloudflare.com/ips/

Content-Type

O retorno de dados da API será via JSON.

Content-Type: application/json.

Timeout

Use o timeout padrão de 60 segundos. Caso utilize um valor inferior, em uma instabilidade da API poderá ocorrer de sua requisição ser abortada antes de receber a resposta, consumindo créditos.

Atualmente, a média de retorno das consultas está em 2 segundos.

Tokens

Para realizar consultas, será necessário gerar o token de integração. Para isso, acesse a opção API > Tokens em seu Painel de Controle. Após o cadastro, seu token será gerado para que seja inserido na URL da requisição.

IDs dos Pacotes

Em cada requisição, será necessário informar na URL o ID do Pacote desejado, aqui nomeado de {pacote}.

Para contratar os pacotes desejados, acesse o Painel de Controle. Consulte-os em nosso site.

ID
 Pacote Dados Retornados Custo por Consulta (BRL)
1 CPF A
  • Nome Completo
 R$0,15
7 CPF B
  • Nome Completo
  • Data de Nascimento
 R$0,22
2 CPF C
  • Nome Completo
  • Data de Nascimento
  • Nome Completo da Mãe
  • Gênero
 R$0,25
8 CPF D
  • Nome Completo
  • Nome Social
  • Data de Nascimento
  • Situação Cadastral na Receita Federal
  • Óbito e Data
  • Número de Comprovante da Consulta
  • PDF Comprovante da Consulta

Consultas em tempo real com a Receita Federal e resposta em 1 segundo!

 R$0,36
9 CPF E
  • Nome Completo
  • Nome Social
  • Nome Completo da Mãe
  • Data de Nascimento
  • Gênero
  • Situação Cadastral na Receita Federal
  • Óbito e Data
  • Número de Comprovante da Consulta
  • PDF Comprovante da Consulta

Consultas em tempo real com a Receita Federal e resposta em 1 segundo!

 R$0,47
3 CPF F
  • Nome Completo
  • Data de Nascimento
  • Gênero
  • Endereço Completo
 R$1,20
13 CPF G
  • Nome Completo
  • Nível de probabilidade de inadimplência futura, segundo a SERASA.

Clique aqui e leia nosso artigo para mais informações.

 R$1,00
14 CPF H
  • Nome Completo¹
  • Pessoa Politicamente Exposta e Relacionados (PPE / PEP)

Também retorna relacionados familiares.

Clique aqui e leia nosso artigo para mais informações.

¹ Caso não seja uma PPE/PEP (ou relacionado), o retorno será null.
² A cobrança também é feita se o CPF consultado não for uma PPE/PEP.

 R$0,20²
15 CPF I
  • Empresas no Nome

Lista de CNPJs em que o titular faz parte do quadro societário.

 R$0,20
17 CPF J
  • Nome Completo
  • Nacionalidade (ID + País)
 R$0,18
18 CPF K
  • Nome Completo
  • Data de Nascimento
  • Endereço Completo
  • Situação Cadastral na Receita Federal

Apenas a Situação Cadastral em tempo real, sem comprovante.

 R$1,40
21 CPF Lookalike
  • Nome Completo
  • E-mails
  • Telefones
  • WhatsApp
 R$0,24
4 CNPJ A
  • Razão Social
 R$0,13
5 CNPJ B
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
 R$0,24
10 CNPJ C
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
  • Início das Atividades
  • Telefones
  • Faxes
  • E-mail
  • Situação Cadastral na Receita Federal
 R$0,32
6 CNPJ D
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
  • Início das Atividades
  • Telefones
  • Faxes
  • E-mail
  • Código e Descrição da Atividade Econômica Principal
  • Código e Descrição da Natureza Jurídica
  • Nome do Responsável pela Empresa
  • Porte da Empresa
  • Quadro de Sócios e Administradores (QSA)
  • Situação Cadastral na Receita Federal
  • Informações sobre Simples Nacional
 R$0,45
11 CNPJ F
  • Razão Social
  • Informações sobre Simples Nacional
  • Informações sobre SIMEI
  • Informações sobre Suframa
 R$0,30
12 CNPJ G
  • Razão Social
  • Nível de probabilidade de inadimplência futura, segundo a SERASA.

Clique aqui e leia nosso artigo para mais informações.

 R$1,00
16 CNPJ H
  • Inscrições Estaduais
  • Razão Social
 R$0,15
19 CNPJ Lookalike
  • Razão Social
  • E-mails dos Sócios
  • Telefones dos Sócios
  • WhatsApp dos Sócios

Cobrança feita por cada sócio retornado.

 R$0,26

Realizando Consultas

Em poucas etapas, explicaremos como a consulta é feita pela API da CPF.CNPJ.

Após gerar o token, conforme Introdução, será necessário montar a URL da requisição.

Definição

Endpoint que conterá o Token, ID do Pacote e número do CPF ou CNPJ a ser consultado, respectivamente.

URL: https://api.cpfcnpj.com.br/{token}/{pacote}/{cpfcnpj}

Parâmetros da Requisição

Parâmetro Tipo Descrição Obrigatório?
token string Token gerado no Painel de Controle.
pacote int ID do pacote a ser utilizado, conforme tabela.
cpfcnpj string Número do CPF com 11 dígitos ou CNPJ com 14 dígitos.

Exemplos de URL:

Consultar CPF no pacote CPF E: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/9/00000000000

Consultar CNPJ no pacote CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/6/27272134000118

Parâmetros das Respostas

Confira abaixo os campos retornados para CPFs e CNPJs.

Cada pacote de consultas possui seus respectivos parâmetros de respostas. Sendo assim, integre de acordo.

Respostas CPFs

Objeto principal da resposta que varia de acordo com o pacote:

Parâmetro Tipo Descrição
status bool 1 para sucesso e 0 para falha (ver tabela de erros).
cpf string Número formatado do CPF consultado com 14 dígitos.
nome string Nome completo do titular (sem acentuação).
nomeSocial string Nome social, conforme Decreto nº 8.727/2016.
nascimento string Data de nascimento, formato DD/MM/AAAA.
mae string Nome completo da mãe (sem acentuação).
genero string M (Masculino) ou F (Feminino).
situacao string Situação cadastral: Regular, Cancelada, Suspensa, Pendente, Nula.
situacaoDigito string Código da situação (00, 02, 03, 04, 05, 08, 09).
situacaoMotivo string Motivo da situação cadastral.
situacaoAnoObito string Ano de óbito (DD/MM/AAAA), se houver.
situacaoInscricao string Data de inscrição na Receita (DD/MM/AAAA ou texto do tipo "anterior a ...").
situacaoComprovante string Código de controle do comprovante em tempo real.
situacaoComprovanteEmissao string Data (DD/MM/AAAA HH:MM:SS) em que a consulta foi feita na Receita Federal (realtime).
situacaoComprovantePdf string PDF da consulta feita em base64.
risco risco[] Objeto de probabilidade de inadimplência futura (Score SERASA).
endereco string Endereço principal residencial (logradouro).
numero string Número no endereço.
complemento string Complemento do endereço.
bairro string Bairro do endereço.
cep string CEP do endereço.
cidade string Cidade do endereço.
uf string Estado (UF) com 2 letras.
enderecos enderecos[] Lista contendo o histórico de endereços e também o mais recente (que está fora da array).
telefones telefones[] Lista contendo o histórico de possíveis números de telefone.
whatsapp whatsapp[] Com base na lista de telefones, uma verificação em tempo real é feita e identifica quais números de telefones são WhatsApp.
emails emails[] Lista contendo o histórico de possíveis emails.
ppe ppe[] Lista de cargos da PPE/PEP, se for uma Pessoa Politicamente Exposta.
relacionados relacionados[] Lista parentes relacionados que são PPE/PEP.
empresas empresas[] Lista contendo o CNPJ de empresas em que o titular faz parte do quadro societário.
pacoteUsado int ID do pacote usado.
saldo int Saldo do pacote após a consulta.
consultaID string ID da consulta (16 dígitos).
delay float Tempo total da consulta em segundos.
Array PPE

Array ppe[] contendo lista de cargos da PPE/PEP:

Parâmetro Tipo Descrição
sigla string Sigla do cargo político.
funcao string Função do cargo.
nivel string Nível de hierarquia política.
orgao string Órgão de atuação.
inicioexercicio string Data de início (DD/MM/AAAA).
fimexercicio string Data de término do exercício (DD/MM/AAAA).
fimcarencia string Data de fim de carência (DD/MM/AAAA).

Respostas CNPJs

Objeto principal da resposta que varia de acordo com o pacote:

Parâmetro Tipo Descrição
status bool 1 para sucesso, 0 para falha (ver erros).
cnpj string CNPJ formatado (18 dígitos).
razao string Razão social da empresa.
fantasia string Nome fantasia da empresa.
inicioAtividade string Data de início das atividades (DD/MM/AAAA).
email string E-mail de cadastro da empresa.
responsavel string Nome do responsável legal (sem acentuação).
simplesNacional simplesNacional[] Dados de possível adesão ao Simples Nacional.
simei simei[] Dados de possível adesão ao SIMEI.
matrizEndereco matrizEndereco[] Objeto do endereço completo do CNPJ consultado.
matrizfilial matrizfilial[] Dados do órgão competente (matriz/filial).
telefones telefones[] Telefones da empresa (até 2).
fax fax[] Fax da empresa.
situacao situacao[] Situação cadastral na Receita Federal.
naturezaJuridica naturezaJuridica[] Dados da natureza jurídica.
cnae cnae[] CNAE principal.
porte porte[] Dados do porte da empresa.
socios socios[] QSA: sócios/administradores.
risco risco[] Nível de probabilidade de inadimplência (SERASA).
pacoteUsado int ID do pacote usado.
saldo int Saldo do pacote após a consulta.
consultaID string ID da consulta (16 dígitos).
delay float Tempo para processar a consulta (segundos).
Objeto simplesNacional

Objeto simplesNacional[] contendo informações de Simples Nacional:

Parâmetro Tipo Descrição
optante string Sim ou Não.
inicio string Data início (DD/MM/AAAA).
fim string Data fim (DD/MM/AAAA).
Objeto simei

Objeto simei[] contendo informações de SIMEI:

Parâmetro Tipo Descrição
optante string Sim ou Não.
anteriores matriz Objeto anteriores[] com registros anteriores.
Objeto anteriores
Parâmetro Tipo Descrição
inicio string Data início (DD/MM/AAAA).
fim string Data fim (DD/MM/AAAA).
detalhamento string Descrição do registro.
Objeto matrizEndereco
Parâmetro Tipo Descrição
cep string CEP com 9 dígitos.
tipo string Tipo de endereço (ex: Rua, Avenida etc.).
logradouro string Logradouro da empresa.
numero string Número no endereço.
complemento string Complemento do endereço.
bairro string Bairro do endereço.
cidade string Cidade do endereço.
uf string Estado (UF) com 2 letras.
Objeto matrizfilial

Informações sobre o órgão competente (matriz ou filial):

Parâmetro Tipo Descrição
id int ID do órgão.
tipo string Órgão:

id 1: Matriz
id 2: Filial
Array telefones
Parâmetro Tipo Descrição
ddd string DDD do telefone.
numero string Número do telefone.
Objeto fax
Parâmetro Tipo Descrição
ddd string DDD do fax.
numero string Número do fax.
Objeto situacao
Parâmetro Tipo Descrição
id int ID da situação cadastral.
nome string Nome da situação, por exemplo:

id 1: Baixada
id 2: Ativa
id 3: Suspensa
id 4: Inapta
id 8: Baixada
data string Data da situação (DD/MM/AAAA).
Objeto naturezaJuridica

Objeto naturezaJuridica[] com dados da natureza jurídica.
Lista oficial

Parâmetro Tipo Descrição
codigo string Código da natureza jurídica (4 dígitos).
descricao string Descrição da natureza jurídica.
Objeto cnae

Objeto cnae[] com dados do CNAE principal.
Tabela CNAE

Parâmetro Tipo Descrição
divisao string Código da divisão.
grupo string Código do grupo.
classe string Código da classe.
subClasse string Código da subclasse.
fiscal string Código completo do CNAE (somente números).
descricao string Descrição do CNAE.
Objeto porte

Objeto porte[] contendo dados do porte da empresa.

Parâmetro Tipo Descrição
id string ID do porte.
descricao string Descrição do porte, por exemplo:

id 0: Demais
id 1: Matriz
id 3: Demais
id 5: Demais
Array socios

Objeto socios[] contendo dados do QSA:

Parâmetro Tipo Descrição
nome string Nome do sócio PF ou PJ (sem acentuação).
cnpj string CNPJ formatado, se sócio PJ.
tipo string Tipo do sócio.
capitalSocial float Porcentagem de capital social.
pais string País de origem do sócio.
Objeto risco

Objeto risco[] com dados do Score SERASA:

Parâmetro Tipo Descrição
nivel int ID do nível de risco (0 a 4).
descricao string Descrição do nível: Desconhecido, Baixo, Médio, Alto, Altíssimo.
score string Faixa de pontuação associada ao nível.

Consultando Saldos

Sem custos, consulte o saldo do pacote desejado.

Definição

Endpoint que conterá o Token e ID do Pacote, respectivamente.

URL: https://api.cpfcnpj.com.br/{token}/saldo/{pacote}

Parâmetros da Requisição

Parâmetro Tipo Descrição Obrigatório?
token string Token gerado no Painel de Controle.
pacote int ID do pacote (ver tabela).

Parâmetros da Resposta

Objeto pacote[] com informações de saldo:

Parâmetro Tipo Descrição
id int ID do pacote.
nome string Nome do pacote.
saldo int Saldo disponível.

Códigos de Erro

Lista de erros retornados nos parâmetros erro e erroCodigo:

erroCodigo
 Valor erro Descrição
100
 CPF CPF inválido! Número digitado não é um CPF válido.
101
 CPF Informe um CPF com 11 dígitos! CPF informado possui menos de 11 dígitos.
102
 CPF O CPF informado não existe (...) CPF válido, mas não consta em bases da Receita.
200
 CNPJ CNPJ inválido! Número digitado não é um CNPJ válido.
201
 CNPJ Informe um CNPJ com 14 dígitos! CNPJ informado possui menos de 14 dígitos.
202
 CNPJ O CNPJ informado não existe (...) CNPJ válido, mas não consta em bases da Receita.
1000
 CPF/CNPJ Token inválido! (...) Token não pertence ao IP de origem.
1001
 CPF/CNPJ Créditos insuficientes! Sem créditos no pacote selecionado.
1002
 CPF/CNPJ Conta suspensa e/ou inativa! Entre em contato com o suporte.
1003
 CPF/CNPJ Blacklist até *DATA* IP e Token suspenso temporariamente.
1004
 CPF/CNPJ Pacote indisponível para consultas! ID do pacote inválido ou indisponível.
1005
 CPF/CNPJ Não é possível consultar *CPF/CNPJ* neste pacote! Falha no fornecedor ou erro interno.
1006
 CPF/CNPJ Supplier 2 offline. Contact us! Fornecedor de dados off-line.
1007
 CPF/CNPJ Limite de requisições (20) por segundo excedido... Máximo de 20 consultas por segundo.