Acerca de

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

Introducción

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.

Normas 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

Las solicitudes GET se realizan sobre una URL base bajo el protocolo HTTPS.

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

Cortafuegos

Asegúrese de conceder permisos en su firewall para las IPs de CloudFlare.

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

Tipo de contenido

La devolución de datos de la API se hará a través de JSON.

Tipo de contenido: application/json.

Tiempo de espera

Utilice el tiempo de espera predeterminado de 60 segundos. Si utiliza un valor inferior, en caso de inestabilidad de la API, su solicitud puede ser abortada antes de recibir la respuesta, consumiendo créditos.

Actualmente, el tiempo medio de respuesta a las consultas es de 2 segundos.

Fichas

Para realizar consultas, será necessário gerar o token de integração. Para isso, acesse a opção API > Tokens en su Panel de control. Após o cadastro, seu token será gerado para que seja inserido na URL de la solicitud.

ID de los paquetes

En cada solicitud, será necesario informar en la URL el ID del paquete deseado, aquí denominado {pacote}.

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

ID
 Pacote Datos devueltos Coste por consulta (BRL)
1 CPF A
  • Nombre completo
 R$0,15
7 CPF B
  • Nombre completo
  • Fecha de nacimiento
 R$0,22
2 CPF C
  • Nombre completo
  • Fecha de nacimiento
  • Nombre completo de la madre
  • Género
 R$0,25
8 CPF D
  • Nombre completo
  • Nome Social
  • Fecha de nacimiento
  • Situación catastral en la Hacienda 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
  • Nombre completo
  • Nome Social
  • Nombre completo de la madre
  • Fecha de nacimiento
  • Género
  • Situación catastral en la Hacienda 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
  • Nombre completo
  • Fecha de nacimiento
  • Género
  • Dirección completa
 R$1,20
13 CPF G
  • Nombre completo
  • Nivel de probabilidad de impago futuro, según SERASA.

Haga clic aquí y lea nuestro artículo para obtener más información.

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

Também retorna relacionados familiares.

Haga clic aquí y lea nuestro artículo para obtener más información.

¹ 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 en el nombre

Lista de CNPJ en los que el titular es miembro de la empresa.

 R$0,20
17 CPF J
  • Nombre completo
  • Nacionalidade (ID + País)
 R$0,18
18 CPF K
  • Nombre completo
  • Fecha de nacimiento
  • Dirección completa
  • Situación catastral en la Hacienda Federal

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

 R$1,40
21 CPF Lookalike
  • Nombre completo
  • E-mails
  • Teléfonos
  • WhatsApp
 R$0,24
4 CNPJ A
  • Nombre de la empresa
 R$0,13
5 CNPJ B
  • Nombre de la empresa
  • Nombre de la empresa
  • Dirección completa
 R$0,24
10 CNPJ C
  • Nombre de la empresa
  • Nombre de la empresa
  • Dirección completa
  • Inicio de actividades
  • Teléfonos
  • Faxes
  • Correo electrónico
  • Situación catastral en la Hacienda Federal
 R$0,32
6 CNPJ D
  • Nombre de la empresa
  • Nombre de la empresa
  • Dirección completa
  • Inicio de actividades
  • Teléfonos
  • Faxes
  • Correo electrónico
  • Código y descripción de la actividad económica principal
  • Código y descripción de la naturaleza jurídica
  • Nombre del responsable de la empresa
  • Tamaño de la empresa
  • Consejo de Socios y Directores (QSA)
  • Situación catastral en la Hacienda Federal
  • Información sobre Simples Nacional
 R$0,45
11 CNPJ F
  • Nombre de la empresa
  • Información sobre Simples Nacional
  • Información sobre el SIMEI
  • Información sobre Suframa
 R$0,30
12 CNPJ G
  • Nombre de la empresa
  • Nivel de probabilidad de impago futuro, según SERASA.

Haga clic aquí y lea nuestro artículo para obtener más información.

 R$1,00
16 CNPJ H
  • Entradas estatales
  • Nombre de la empresa
 R$0,15
19 CNPJ Lookalike
  • Nombre de la empresa
  • E-mails dos Sócios
  • Telefones dos Sócios
  • WhatsApp dos Sócios

Cobrança feita por cada sócio retornado.

 R$0,26

Hacer consultas

En unos pocos pasos, explicaremos cómo se realiza la consulta mediante la API CPF.CNPJ.

Después de generar el token, según Introducciónserá necesario construir la URL de la solicitud.

Definición

Endpoint que contendrá el TokenID de la Pacote y número del CPF o del CNPJ a consultar, respectivamente.

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

Parámetros de solicitud

Parámetro Tipo Descripción ¿Obligatorio?
ficha cadena Token generado en el Panel de Control.
pacote int ID del paquete a utilizar, según la tabla.
cpfcnpj cadena Número CPF con 11 dígitos o CNPJ con 14 dígitos.

Ejemplos de URL:

Consulte el CPF en el paquete CPF E: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/9/00000000000

Consulte el CNPJ en el paquete CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/6/27272134000118

Parámetros de respuesta

Compruebe a continuación los campos devueltos para los CPF y los CNPJ.

Cada paquete de consulta tiene sus respectivos parámetros de respuesta. Por lo tanto, intégrese en consecuencia.

Respuestas del CPF

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

Parámetro Tipo Descripción
status bool 1 para sucesso e 0 para falha (ver tabla de errores).
cpf cadena Número CPF formateado consultado con 14 dígitos.
nome cadena Nombre completo del titular (sin acentos).
nomeSocial cadena Nome social, conforme Decreto nº 8.727/2016.
nascimento cadena Data de nascimento, formato DD/MM/AAAA.
mae cadena Nome completo da mãe (sem acentuação).
genero cadena M (Masculino) ou F (Feminino).
situacao cadena Situação cadastral: Regular, Cancelada, Suspensa, Pendente, Nula.
situacaoDigito cadena Código da situação (00, 02, 03, 04, 05, 08, 09).
situacaoMotivo cadena Motivo da situação cadastral.
situacaoAnoObito cadena Ano de óbito (DD/MM/AAAA), se houver.
situacaoInscricao cadena Data de inscrição na Receita (DD/MM/AAAA ou texto do tipo "anterior a ...").
situacaoComprovante cadena Código de controle do comprovante em tempo real.
situacaoComprovanteEmissao cadena Data (DD/MM/AAAA HH:MM:SS) em que a consulta foi feita na Receita Federal (realtime).
situacaoComprovantePdf cadena PDF da consulta feita em base64.
risco risco[] Objeto de probabilidade de inadimplência futura (Score SERASA).
endereco cadena Endereço principal residencial (logradouro).
numero cadena Número en la dirección.
complemento cadena Complemento de dirección.
bairro cadena Dirección del barrio.
cep cadena Código postal de la dirección.
cidade cadena Ciudad de la dirección.
uf cadena 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 del paquete utilizado.
saldo int Saldo do pacote após a consulta.
consultaID cadena 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 Descripción
sigla cadena Sigla do cargo político.
funcao cadena Função do cargo.
nivel cadena Nível de hierarquia política.
orgao cadena Órgão de atuação.
inicioexercicio cadena Data de início (DD/MM/AAAA).
fimexercicio cadena Data de término do exercício (DD/MM/AAAA).
fimcarencia cadena Data de fim de carência (DD/MM/AAAA).

Respuestas del CNPJ

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

Parámetro Tipo Descripción
status bool 1 para sucesso, 0 para falha (ver erros).
cnpj cadena CNPJ formatado (18 dígitos).
razao cadena Razão social da empresa.
fantasia cadena Nombre comercial de la empresa.
inicioAtividade cadena Data de início das atividades (DD/MM/AAAA).
email cadena E-mail de cadastro da empresa.
responsavel cadena 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 del paquete utilizado.
saldo int Saldo do pacote após a consulta.
consultaID cadena 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 Descripción
optante cadena Sim o Não.
inicio cadena Data início (DD/MM/AAAA).
fim cadena Data fim (DD/MM/AAAA).
Objeto simei

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

Parámetro Tipo Descripción
optante cadena Sim o Não.
anteriores matriz Objeto anteriores[] com registros anteriores.
Objeto anteriores
Parámetro Tipo Descripción
inicio cadena Data início (DD/MM/AAAA).
fim cadena Data fim (DD/MM/AAAA).
detalhamento cadena Descrição do registro.
Objeto matrizEndereco
Parámetro Tipo Descripción
cep cadena CEP com 9 dígitos.
tipo cadena Tipo de endereço (ex: Rua, Avenida etc.).
logradouro cadena Logradouro da empresa.
numero cadena Número en la dirección.
complemento cadena Complemento de dirección.
bairro cadena Dirección del barrio.
cidade cadena Ciudad de la dirección.
uf cadena Estado (UF) com 2 letras.
Objeto matrizfilial

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

Parámetro Tipo Descripción
id int ID do órgão.
tipo cadena Cuerpo:

id 1: Matriz
id 2: Filial
Array telefones
Parámetro Tipo Descripción
ddd cadena DDD do telefone.
numero cadena Número do telefone.
Objeto fax
Parámetro Tipo Descripción
ddd cadena DDD do fax.
numero cadena Número do fax.
Objeto situacao
Parámetro Tipo Descripción
id int Identificación de la situación catastral.
nome cadena Nome da situação, por exemplo:

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

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

Parámetro Tipo Descripción
codigo cadena Código da natureza jurídica (4 dígitos).
descricao cadena Descripción de la naturaleza jurídica.
Objeto cnae

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

Parámetro Tipo Descripción
divisao cadena Código de la división.
grupo cadena Código de grupo.
classe cadena Código de clase.
subClasse cadena Código da subclasse.
fiscal cadena Código completo do CNAE (somente números).
descricao cadena Descripción del CNAE.
Objeto porte

Objeto porte[] que contiene datos sobre el tamaño de la empresa.

Parámetro Tipo Descripción
id cadena Identificación del puerto.
descricao cadena 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 Descripción
nome cadena Nombre del socio FP o PJ (sin acentuar).
cnpj cadena CNPJ formatado, se sócio PJ.
tipo cadena Tipo do sócio.
capitalSocial float Porcentagem de capital social.
pais cadena País de origen del socio.
Objeto risco

Objeto risco[] com dados do Score SERASA:

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

Comprobación de saldos

Sin coste alguno, compruebe el saldo del paquete deseado.

Definición

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

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

Parámetros de solicitud

Parámetro Tipo Descripción ¿Obligatorio?
token cadena Token generado en el Panel de Control.
pacote int ID do pacote (ver tabela).

Parámetros de respuesta

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

Parámetro Tipo Descripción
id int Identificación del paquete.
nome cadena Nome do pacote.
saldo int Saldo disponível.

Códigos de error

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

erroCodigo
 Valor erro Descripción
100
 CPF CPF inválido! El número introducido no es un CPF válido.
101
 CPF Informe um CPF com 11 dígitos! El CPF informado tiene 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! El número introducido no es un CNPJ válido.
201
 CNPJ Informe um CNPJ com 14 dígitos! El CNPJ informado tiene 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.