Acerca de

API para consulta de CPF en la Agencia Tributaria Federal de Brasil, permitiendo integración ágil, sin captcha ni fecha de nacimiento. Así, obtiene datos de personas y empresas en tiempo real, reduciendo fraudes y garantizando la confiabilidad de los registros en sus aplicaciones.

Además, nuestra API para consulta de CPF y CNPJ tiene un tiempo promedio de respuesta inferior a 1 segundo, posibilitando la automatización de procesos y el mantenimiento de una base de datos completa y segura.
Conozca más en nuestro sitio.

Certificaciones

En 2025, obtuvimos tres certificaciones ISO/IEC destacadas que demuestran nuestro compromiso con la privacidad, la seguridad de la información y el cumplimiento normativo:


  • Information Security Management 27001:2022 (Certificado Q7LUQTCU20251113BRAIS1Z1): certifica nuestro Sistema de Gestión de Seguridad de la Información, garantizando la confidencialidad, integridad y disponibilidad de los datos.
  • Privacy Information Management 27701:2025 (Certificado Q7LUQTCU20251113BRAPI15R): certifica nuestra conformidad con las mejores prácticas de gestión de privacidad de la información, incluyendo LGPD y GDPR.
  • Compliance Management System 37301:2021 (Certificado Q7LUQTCC20251113BRACM1X7): demuestra nuestra adhesión a un sistema de gestión de cumplimiento robusto, asegurando el cumplimiento de normas y regulaciones.

Para saber más sobre nuestros procesos y políticas, consulte:

Veracidad y Actualización de Datos

Proporcionamos solo datos actualizados en tiempo real (D+0) con 100% de cobertura de los documentos consultados. Así, cualquier cambio registral del titular se refleja exactamente como consta en la Agencia Tributaria. A diferencia de muchos proveedores del mercado, no utilizamos bases antiguas, incompletas o filtradas, lo que nos permite garantizar cobertura total para todos los documentos consultados.

Para más información, acceda a: www.cpfcnpj.com.br

Introducción

Este documento presenta las directrices para integrar rápidamente los servicios de CPF.CNPJ vía HTTP (HTTP API).
Cualquier lenguaje de programación es compatible con nuestra solución.

Reglas y Límites de Uso

Para evitar el uso indebido de la API y mantener su alta disponibilidad, establecemos las siguientes restricciones:

  • Después de 3 consultas consecutivas con Token inválido: bloqueo de 5 minutos;
  • Después de 3 consultas consecutivas del mismo CPF/CNPJ en el mismo paquete en menos de 1 minuto: bloqueo de 3 minutos;
  • Después de 3 consultas consecutivas sin créditos en menos de 1 minuto: bloqueo de 5 minutos.

También hay un límite de 20 solicitudes por segundo. Si se alcanza este límite, espere al siguiente segundo e intente nuevamente. Si es necesario, puede solicitar un aumento de este límite directamente con el soporte técnico.

URL Base

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

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

Firewall

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

Acceda a la lista de IPs para liberación: https://www.cloudflare.com/ips/

Content-Type

El retorno de datos de la API será vía JSON.

Content-Type: application/json.

Timeout

Use el timeout predeterminado de 60 segundos. Si utiliza un valor inferior, en caso de inestabilidad de la API, su solicitud podría ser abortada antes de recibir la respuesta, consumiendo créditos.

Actualmente, el promedio de retorno de las consultas es de 2 segundos.

Tokens

Para realizar consultas, será necesario generar el token de integración. Para ello, acceda a la opción API > Tokens en su Panel de Control. Después del registro, su token será generado para ser insertado en la URL de la solicitud.

IDs de Paquetes

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

Para contratar los paquetes deseados, acceda al Panel de Control. Consúltelos en nuestro sitio.

ID
 Paquete Datos Retornados Costo por Consulta (BRL)
1 CPF A
  • Nome Completo
 R$ 0,15 BRL
7 CPF B
  • Nome Completo
  • Data de Nascimento
 R$ 0,22 BRL
2 CPF C
  • Nome Completo
  • Data de Nascimento
  • Nome Completo da Mãe
  • Gênero
 R$ 0,25 BRL
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 BRL
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 BRL
3 CPF F
  • Nome Completo
  • Data de Nascimento
  • Gênero
  • Endereço Completo
 R$ 1,20 BRL
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² BRL
15 CPF I
  • Empresas no Nome

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

 R$ 0,20 BRL
17 CPF J
  • Nome Completo
  • Nacionalidade (ID + País)
 R$ 0,18 BRL
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 BRL
21 CPF Lookalike
  • Nome Completo
  • E-mails
  • Telefones
  • WhatsApp
 R$ 0,24 BRL
20 CPF Family
R$ 1,00 BRL
22 CPF Programas Sociais
  • Nome Completo
  • Lista dos Programas Sociais em que o titular é participante no atual ano
 R$ 0,15 BRL
23 CPF Antecedentes Criminais
  • Mandados de Busca e Apreensão
  • Lista INTERPOL
 R$ 1,30 BRL
24 CPF CNS
R$ 0,22 BRL
26 CPF D Simplificado
  • Nome Completo
  • Data de Nascimento
  • Situação Cadastral na Receita Federal
 R$ 0,33 BRL
4 CNPJ A
  • Razão Social
Para pesquisar empresas por meio da Razão Social, use o endpoint, exemplo /4/?razao_social=GOOGLE BRASIL 		R$ 0,13 BRL
5 CNPJ B
  • Razão Social
  • Nome Fantasia
  • Endereço Completo
 R$ 0,24 BRL
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 BRL
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 BRL
11 CNPJ F
  • Razão Social
  • Informações sobre Simples Nacional
  • Informações sobre SIMEI
  • Informações sobre Suframa
 R$ 0,30 BRL
16 CNPJ H
  • Inscrições Estaduais
  • Razão Social
 R$ 0,15 BRL
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 BRL
25 CNPJ QsA Detalhado
  • Porcentagem Societária de cada Sócio
 R$ 2,00 BRL
100 NFe Unificada PF e PJ
  • Consulta em tempo real de notas fiscais NFe PF e PJ
 R$ 0,15 BRL

Realizando Consultas

En pocos pasos, explicaremos cómo se realiza la consulta a través de la API de CPF.CNPJ.

Después de generar el token, conforme a Introducción, será necesario construir la URL de la solicitud.

Definición

Endpoint que contendrá el Token, ID del Paquete y número del CPF o CNPJ a consultar, respectivamente.

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

Parámetros de la Solicitud

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

Ejemplos de URL:

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

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

Consultar lista de empresas por Razón Social en el paquete CNPJ D: https://api.cpfcnpj.com.br/5ae973d7a997af13f0aaf2bf60e65803/4?razao_social=GOOGLE BRASIL

Parámetros de las Respuestas

Consulte a continuación los campos retornados para CPFs y CNPJs.

Cada paquete de consultas tiene sus propios parámetros de respuesta. Por lo tanto, integre de acuerdo.

Respuestas CPFs

Objeto principal de la respuesta que varía según el paquete:

Parámetro Tipo Descripción
status bool 1 para éxito y 0 para fallo (ver tabla de errores).
cpf string Número del CPF formateado con 14 dígitos.
nome string Nombre completo del titular (sin acentuación).
nomeSocial string Nombre social, conforme al Decreto nº 8.727/2016.
nascimento string Fecha de nacimiento, formato DD/MM/AAAA.
mae string Nombre completo de la madre (sin acentuación).
genero string M (Masculino), F (Femenino) u O (Otro).
situacao string Situación registral: Regular, Cancelada, Suspensa, Pendente, Nula.
situacaoDigito string Código de la situación (00, 02, 03, 04, 05, 08, 09).
situacaoMotivo string Motivo de la situación registral.
situacaoAnoObito string Año de fallecimiento (DD/MM/AAAA), si existe.
situacaoInscricao string Fecha de inscripción en la Agencia Tributaria (DD/MM/AAAA o texto del tipo "anterior a ...").
situacaoComprovante string Código de control del comprobante en tiempo real.
situacaoComprovanteEmissao string Fecha (DD/MM/AAAA HH:MM:SS) en que la consulta fue realizada en la Agencia Tributaria (realtime).
situacaoComprovantePdf string PDF de la consulta en base64.
endereco string Dirección principal residencial (calle).
numero string Número de la dirección.
complemento string Complemento de la dirección.
bairro string Barrio de la dirección.
cep string Código postal de la dirección.
cidade string Ciudad de la dirección.
uf string Estado (UF) con 2 letras.
enderecos enderecos[] Lista que contiene el historial de direcciones y también la más reciente (la misma fuera de este objeto).
telefones telefones[] Lista que contiene el historial de posibles números de teléfono.
whatsapp whatsapp[] Basándose en la lista de teléfonos, se realiza una verificación en tiempo real para identificar qué números son WhatsApp.
emails emails[] Lista que contiene el historial de posibles emails.
ppe ppe[] Lista de cargos de PPE/PEP, si es una Persona Políticamente Expuesta.
relacionados relacionados[] Lista de parientes relacionados que son PPE/PEP.
empresas empresas[] Lista que contiene el CNPJ de empresas en las que el titular forma parte del cuadro societario.
programasSociais programasSociais[] Lista que contiene los programas sociales en los que el titular es beneficiario en el año actual.
pacoteUsado int ID del paquete utilizado.
saldo int Saldo del paquete después de la consulta.
consultaID string ID de la consulta (16 dígitos).
delay float Tiempo total de la consulta en segundos.
Array PPE

Array ppe[] que contiene lista de cargos de PPE/PEP:

Parâmetro Tipo Descrição
sigla string Sigla del cargo político.
funcao string Función del cargo.
nivel string Nivel de jerarquía política.
orgao string Órgano de actuación.
inicioexercicio string Fecha de inicio (DD/MM/AAAA).
fimexercicio string Fecha de término del ejercicio (DD/MM/AAAA).
fimcarencia string Fecha de fin de carencia (DD/MM/AAAA).

Respuestas CNPJs

Objeto principal de la respuesta que varía según el paquete:

Parâmetro Tipo Descrição
status bool 1 para éxito y 0 para fallo (ver tabla de errores).
cnpj string CNPJ formateado (18 dígitos).
razao string Razón social de la empresa.
fantasia string Nombre de fantasía de la empresa.
inicioAtividade string Fecha de inicio de actividades (DD/MM/AAAA).
email string E-mail de registro de la empresa.
responsavel string Nombre del responsable legal (sin acentuación).
responsavelCpf string CPF del responsable legal.
simplesNacional simplesNacional[] Datos de posible adhesión al Simples Nacional.
simei simei[] Datos de posible adhesión al SIMEI.
matrizEndereco matrizEndereco[] Objeto de la dirección completa del CNPJ consultado.
Atención: El nombre "matriz" del objeto en cuestión, no se refiere específicamente a la dirección de la matriz del CNPJ consultado.
matrizfilial matrizfilial[] Datos del órgano competente (matriz/filial).
telefones telefones[] Teléfonos de la empresa (hasta 2).
fax fax[] Fax de la empresa.
situacao situacao[] Situación registral en la Agencia Tributaria.
naturezaJuridica naturezaJuridica[] Datos de la naturaleza jurídica.
cnae cnae[] CNAE principal.
porte porte[] Datos del porte de la empresa.
socios socios[] QSA: socios/administradores.
pacoteUsado int ID del paquete utilizado.
saldo int Saldo del paquete después de la consulta.
consultaID string ID de la consulta (16 dígitos).
delay float Tiempo para procesar la 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 de la dirección.
complemento string Complemento de la dirección.
bairro string Barrio de la dirección.
cidade string Ciudad de la dirección.
uf string Estado (UF) con 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.

Consultando Saldos

Sin costo, consulte el saldo del paquete deseado.

Definición

Endpoint que contendrá el Token y el ID del IDs de Paquetes, respectivamente.

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

Parámetros de la Solicitud

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

Parámetros de la Respuesta

Objeto pacote[] con información 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 Error

Lista de errores retornados en los parámetros erro y erroCodigo:

erroCodigo
 Valor erro Descripción
100
 CPF CPF inválido! El número ingresado no es un CPF válido.
101
 CPF Informe um CPF com 11 dígitos! El CPF ingresado tiene menos de 11 dígitos.
102
 CPF O CPF informado não existe (...) CPF válido, pero no consta en las bases de la Agencia Tributaria.
200
 CNPJ CNPJ inválido! El número ingresado no es un CNPJ válido.
201
 CNPJ Informe um CNPJ com 14 dígitos! El CNPJ ingresado tiene menos de 14 dígitos.
202
 CNPJ O CNPJ informado não existe (...) CNPJ válido, pero no consta en las bases de la Agencia Tributaria.
400
 CPF/CNPJ Incorrect parameters. El formato de la URI es incorrecto. Verifique la orientación en el tema "Realizando Consultas > Definición".
1000
 CPF/CNPJ Token inválido! (...) El Token no pertenece a la IP de origen.
1001
 CPF/CNPJ Créditos insuficientes! Sin créditos en el paquete seleccionado.
1002
 CPF/CNPJ Conta suspensa e/ou inativa! Contacte con soporte.
1003
 CPF/CNPJ Blacklist até *DATA* IP y Token suspendidos temporalmente.
1004
 CPF/CNPJ Pacote indisponível para consultas! ID del paquete inválido o no disponible.
1005
 CPF/CNPJ Não é possível consultar *CPF/CNPJ* neste pacote! Fallo del proveedor o error interno.
1006
 CPF/CNPJ Supplier 2 offline. Contact us! Proveedor de datos fuera de línea.
1007
 CPF/CNPJ Limite de requisições (20) por segundo excedido... Máximo de 20 consultas por segundo.