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) com 100% de cobertura dos documentos consultados. 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 e Limites 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.

Há ainda um limite de 20 requisições por segundo. Caso esse limite seja atingido, aguarde o próximo segundo e tente novamente. Se necessário, você pode solicitar o aumento desse limite diretamente com o suporte técnico.

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
20 CPF Family
R$1,00
22 CPF Programas Sociais
  • Nome Completo
  • Lista dos Programas Sociais em que o titular é participante no atual ano
 R$0,15
23 CPF Antecedentes Criminais
R$1,30
24 CPF CNS
R$0,22
26 CPF D Simplificado
  • Nome Completo
  • Data de Nascimento
  • Situação Cadastral na Receita Federal
 R$0,33
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
  • CPF do Responsável Legal e Sócios
 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
25 CNPJ QsA Detalhado
  • Porcentagem Societária de cada Sócio
 R$2,00
100 NFe Unificada PF e PJ
  • Consulta em tempo real de notas fiscais NFe PF e PJ
 R$0,15

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), F (Feminino) ou O (Outro).
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 (o mesmo fora deste objeto).
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.
programasSociais programasSociais[] Lista contendo os programas sociais em que o titular é beneficiário no ano atual.
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).
responsavelCpf string CPF do responsável legal.
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.
Atenção: O nome "matriz" do objeto em questão, não refere-se especificamente ao endereço da matriz 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
cpf_cnpj_socio string CPF completo ou CNPJ do sócio.
nome string Nome do sócio PF ou Razão Social PJ.
tipo string Pessoa Física ou Pessoa Jurídica
data_entrada string Data de entrada na dociedade no formato DD/MM/YYYY.
cpf_representante_legal string CPF completo do Representante Legal quando sócio Pessoa Jurídica.
nome_representante string Nome do Representante Legal quando sócio Pessoa Jurídica.
faixa_etaria string Faixa etária do representante PF.
atualizado_em datetime Data e hora da última atualização das informações do sócio.
pais_id string ID do país de origem do sócio.
qualificacao_socio objeto Contendo id e descricao da qualificação do sócio.
qualificacao_representante objeto Contendo id e descricao da qualificação do representante PF em caso de sócio PJ.
pais objeto Contendo id, iso2, iso3, nome do país e comex_id do representante PF em caso de sócio PJ.
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.
400
 CPF/CNPJ Incorrect parameters. A formatação da URI está incorreta. Verifique a orienteção no tópico "Realizando Consultas > Definição".
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.