Documentación API - CPF.CNPJ

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:

• Ley General de Protección de Datos (LGPD)
• Seguridad y Cumplimiento
• Políticas de Privacidad
• Términos de Uso

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.

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.

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.

Parámetros de la Solicitud

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 A: 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:

Objeto cac

Objeto cac{} contendo os dados da Certidão de Antecedentes Criminais (SINIC) emitida pela Polícia Federal. Retornado no Pacote CPF CAC/SINIC (27).

Array PPE

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

Array relacionados (PPE)

Array relacionados[] con familiares cercanos del titular que ocupan cargo PEP. Devuelto en el Paquete CPF PPE (14).

Array empresas

Array empresas[] con empresas en las que el CPF es socio o administrador. Devuelto en el Paquete CPF Empresas (15).

Array programasSociais

Array programasSociais[] con beneficios sociales activos para el CPF. Devuelto en el Paquete CPF Programas Sociales (22).

Array mandados (BNMP)

Array mandados[] con órdenes de captura registradas en la Base Nacional de Mandados de Prisión (BNMP/CNJ). Devuelto en los Paquetes CPF BNMP (20) y CPF Antecedentes Penales (23).

Array interpol

Array interpol[] con alertas rojas/amarillas de Interpol. Devuelto en el Paquete CPF Antecedentes Penales (23).

Objeto arrestWarrant (interpol)

Objeto interno de cada item de interpol[].arrestWarrants[].

Objeto nacionalidade

Objeto nacionalidade{} com a nacionalidade declarada do CPF.

Array enderecos (PF)

Array enderecos[] con direcciones adicionales conocidas del CPF. La dirección principal viene en los campos endereco, numero, cep de la raíz.

Array telefones (PF)

Array telefones[] de strings (teléfonos en formato E.164 sin el signo más, o solo DDD+número según la fuente). Ejemplo: ["11999999999","3188888888"].

Array whatsapp (PF)

Array whatsapp[] de strings con números que tienen WhatsApp activo confirmado. Subconjunto de telefones[].

Array emails (PF)

Array emails[] de strings con direcciones de correo conocidas del CPF.

Respuestas CNPJs

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

Objeto simplesNacional

Objeto simplesNacional{} contendo informações de Simples Nacional:

Objeto simei

Objeto simei{} contendo informações de SIMEI (Sistema de Recolhimento em Valores Fixos Mensais dos Tributos abrangidos pelo Simples Nacional, exclusivo para MEI):

Array anteriores

Array anteriores[] com registros históricos de adesão e saída do regime tributário (Simples Nacional ou SIMEI). Cada item descreve um período em que a empresa esteve enquadrada anteriormente.

Objeto matrizEndereco

Objeto matrizfilial

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

Array telefones

Objeto fax

Objeto situacao

Objeto situacao{} com dados da situação cadastral da empresa.

Pacote 6: Situação cadastral obtida em tempo real diretamente da Receita Federal, garantindo dados sempre atualizados.

Objeto motivo (situacao)

Objeto interno de situacao.motivo{} descrevendo o motivo da situação cadastral.

Objeto naturezaJuridica

Objeto naturezaJuridica{} com dados da natureza jurídica.
Lista oficial

Objeto cnae

Objeto cnae{} com dados do CNAE principal.
Tabela CNAE

Array secundarias (cnae)

Array secundarias[] de objetos representando os CNAEs secundários cadastrados.

Objeto porte

Objeto porte{} contendo dados do porte da empresa.

Array socios

Array socios[] contendo dados do QSA (Quadro de Sócios e Administradores):

Pacote 25 (CNPJ Percentual Societário): estrutura reduzida contendo apenas cpf_cnpj_socio, nome, qualificacao_socio (string), data_entrada (formato DD/MM/AAAA) e percentual. Os demais pacotes CNPJ retornam a estrutura completa abaixo, com data_entrada em formato YYYY-MM-DD e qualificacao_socio como objeto.

Objeto dispensa

Objeto dispensa{} contendo informações sobre dispensa de licenciamento e autorizações. Disponível apenas no pacote 6, obtido em tempo real da Receita Federal.

Array condicoes (dispensa)

Array de objetos contendo as condições de dispensa por órgão:

Objeto ibge

Objeto ibge{} com os identificadores oficiais (IBGE/SIAFI) de país, estado e cidade do endereço. Retornado em respostas de CNPJ.

Objeto pais

Objeto pais{} com identificadores do país.

Objeto estado

Objeto estado{} com identificadores do estado.

Objeto cidade

Objeto cidade{} com identificadores da cidade.

Objeto qualificacao

Estrutura comum reutilizada nos campos responsavelQualificacao, qualificacao_socio, qualificacao_representante e situacao.motivo.

Array inscricoesEstaduais

Array inscricoesEstaduais[] com todas as inscrições estaduais conhecidas da empresa em cada UF, ativas ou inativas. Disponível no Pacote 16.

Array inscricoesSuframa

Array inscricoesSuframa[] com inscrições SUFRAMA da empresa, quando aplicável.

Array regimesTributarios

Array regimesTributarios[] com o histórico do regime tributário declarado por ano-calendário.

Exemplos de Resposta por Pacote

Todos os exemplos abaixo refletem o JSON retornado pelo Token de Testes 5ae973d7a997af13f0aaf2bf60e65803. Em produção, os dados são reais e os campos opcionais podem variar.

Pacote 1, 2, 3, 7, 8, 9, 17, 18 — CPF Completo / RF / Simples

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "telefones": ["11999999999", "3188888888"],
  "whatsapp": ["11999999999"],
  "emails": ["[email protected]", "[email protected]"],
  "endereco": "Rua A",
  "numero": "100 B",
  "complemento": "Apto 03",
  "bairro": "Centro",
  "cep": "99999123",
  "cidade": "Sao Paulo",
  "uf": "SP",
  "ibge": "1234567",
  "mae": "Maria Jose",
  "genero": "M",
  "enderecos": [
    {"endereco": "Rua A", "numero": "100 B", "complemento": "Apto 03", "bairro": "Centro", "cep": "99999123", "cidade": "Sao Paulo", "uf": "SP", "ibge": "1234567"},
    {"endereco": "Rua B", "numero": "200 B", "complemento": "Apto 10", "bairro": "Centro", "cep": "99999123", "cidade": "Sao Paulo", "uf": "SP", "ibge": "1234567"}
  ],
  "nacionalidade": {"idPais": 76, "paisOrigem": "Brasil"},
  "situacaoInscricao": "anterior a 10/11/1990",
  "situacao": "Cancelada",
  "situacaoDigito": "03",
  "situacaoMotivo": "TITULAR FALECIDO",
  "situacaoAnoObito": 2015,
  "situacaoComprovante": "1A1A.2B2B.3C3C.4D4D",
  "situacaoComprovanteEmissao": "01/01/2025 12:00:00",
  "situacaoComprovantePdf": "base64",
  "pacoteUsado": 1,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 4 — Pesquisa por Razão Social

Endpoint: https://api.cpfcnpj.com.br/{token}/4/?rzsocial=GOOGLE BRASIL

{
  "status": 1,
  "razao": "TOKEN TEST",
  "resultado": ["11222333000181", "44555666000199", "77888999000110"],
  "pacoteUsado": 4,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 4, 5, 6, 10, 11, 16, 19 — CNPJ Completo / RF / WS / IE

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "tipo": "Matriz",
  "razao": "TOKEN TEST LTDA",
  "fantasia": "TOKEN TEST",
  "capitalSocial": 95000,
  "inicioAtividade": "31/12/1999",
  "email": "[email protected]",
  "responsavel": "Joao Jose",
  "responsavelCpf": "111.222.333-44",
  "responsavelQualificacao": {"id": 49, "descricao": "Sócio-Administrador"},
  "simplesNacional": {"optante": "Não", "inicio": "17/01/2020", "fim": "01/01/2023"},
  "simei": {"optante": "Sim", "inicio": "17/01/2023", "fim": null},
  "matrizEndereco": {"cep": "0000-111", "tipo": "Rua", "logradouro": "Rua A", "numero": "1", "complemento": "Sala 1", "bairro": "Centro", "cidade": "Montes Claros", "uf": "MG"},
  "matrizfilial": {"id": 1, "tipo": "Matriz"},
  "telefones": [{"ddd": "11", "numero": "22334454"}],
  "fax": {"ddd": "11", "numero": "22334455"},
  "situacao": {"id": 4, "nome": "Inapta", "data": "03/04/2020", "motivo": {"id": 63, "descricao": "Omissão De Declarações"}},
  "naturezaJuridica": {"codigo": "2062", "descricao": "Sociedade Empresaria Limitada"},
  "cnae": {"fiscal": "6202300", "secao": "J", "divisao": "62", "grupo": "62.0", "classe": "62.02-3", "subClasse": "6202-3/00", "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis", "secundarias": []},
  "porte": {"id": "03", "descricao": "Empresa de Pequeno Porte"},
  "socios": [
    {"cpf_cnpj_socio": "111.222.333-44", "nome": "Joao Jose", "tipo": "Pessoa Física", "data_entrada": "2020-01-01", "qualificacao_socio": {"id": 49, "descricao": "Sócio-Administrador"}, "pais": {"id": "1058", "iso2": "BR", "iso3": "BRA", "nome": "Brasil"}}
  ],
  "inscricoesEstaduais": [
    {"inscricao_estadual": "0010101010101", "ativo": true, "atualizado_em": "2023-10-03T03:00:00.000Z", "estado": {"id": 11, "nome": "Minas Gerais", "sigla": "MG", "ibge_id": 31}}
  ],
  "pacoteUsado": 6,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 12 — CNPJ Risco

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "razao": "TOKEN TEST LTDA",
  "risco": {"nivel": 2, "descricao": "Médio", "score": "251-600"},
  "pacoteUsado": 12,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 13 — CPF Risco

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "risco": {"nivel": 2, "descricao": "Médio", "score": "501-700"},
  "pacoteUsado": 13,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 14 — CPF PPE

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "ppe": [
    {"sigla": "001", "funcao": "PRESIDENTE DA REPUBLICA", "nivel": "001", "orgao": "PRESIDENCIA DA REPUBLICA", "inicioexercicio": "01/01/2019", "fimexercicio": null, "fimcarencia": null}
  ],
  "relacionados": [
    {"cpf": "11122233344", "nome": "Relacionado Teste", "parentesco": "IRMA(O)", "situacaocadastral": "Regular", "ppe": []}
  ],
  "pacoteUsado": 14,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 15 — CPF Empresas

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "empresas": [
    {"cnpj": "77888999000110", "razao": "LOJA LTDA", "fantasia": "MINHA LOJA", "dataSociedade": "01/02/2018", "qualificacao": "SOCIO-ADMINISTRADOR", "situacao": "Ativa"},
    {"cnpj": "11222333000120", "razao": "EMPRESA LTDA", "fantasia": null, "dataSociedade": "02/12/2020", "qualificacao": "SOCIO-ADMINISTRADOR", "situacao": "Baixada"}
  ],
  "pacoteUsado": 15,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 20 — CPF BNMP (Mandados de Prisão)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "mae": "Maria Jose",
  "mandados": [
    {"id": "BNMP-0001", "tribunal": "TJSP", "orgaoJudiciario": "Vara Criminal de São Paulo", "tipoPeca": "Mandado de Prisão", "status": "Em aberto", "dataExpedicao": "01/03/2025", "recaptura": false}
  ],
  "pacoteUsado": 20,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 21 — CPF Telefones+WhatsApp+Emails

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "telefones": ["11999999999", "3188888888", "2133334444"],
  "whatsapp": ["11999999999"],
  "emails": ["[email protected]", "[email protected]"],
  "pacoteUsado": 21,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 22 — CPF Programas Sociais

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "programasSociais": [
    {"programa": "BPC", "nis": "1.111.111.111-1", "municipio": "Montes Claros", "ano": 2025, "valorDisponibilizado": 3036},
    {"programa": "Novo Bolsa Família", "nis": "1.111.111.111-1", "municipio": "Montes Claros", "ano": 2025, "valorDisponibilizado": 800}
  ],
  "pacoteUsado": 22,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 23 — CPF Antecedentes Criminais (BNMP + Interpol + CAC)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "mandados": [
    {"id": "BNMP-0001", "tribunal": "TJSP", "orgaoJudiciario": "Vara Criminal de São Paulo", "tipoPeca": "Mandado de Prisão", "status": "Em aberto", "dataExpedicao": "01/03/2025", "recaptura": false}
  ],
  "interpol": [
    {
      "entityId": "2025/12345",
      "name": "TEST TOKEN",
      "forename": "TEST",
      "dateOfBirth": "1900/12/31",
      "nationalities": ["BR"],
      "eyeColor": "Brown",
      "hairColor": "Black",
      "sexId": "M",
      "weight": 80,
      "height": 1.75,
      "arrestWarrants": [
        {"charge": "Test charge", "issuingCountryId": "BR", "chargeTranslation": "Mandado de teste"}
      ]
    }
  ],
  "cac": {
    "nrProtocolo": "123456789012",
    "comprovantePdfBase64": "base64",
    "nadaConsta": true
  },
  "pacoteUsado": 23,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 24 — CPF CNS (Cartão Nacional de Saúde)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "cns": "123456789012345",
  "pacoteUsado": 24,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 25 — CNPJ Percentual Societário

{
  "status": 1,
  "cnpj": "11.222.333/0001-81",
  "razao": "TOKEN TEST LTDA",
  "fantasia": "TOKEN TEST",
  "socios": [
    {"cpf_cnpj_socio": "111.111.111-11", "nome": "Sócio Teste", "qualificacao_socio": "ADMINISTRADOR", "data_entrada": "14/11/2018", "percentual": 40},
    {"cpf_cnpj_socio": "11.111.111/0001-11", "nome": "CORPORATION, INC.", "qualificacao_socio": "SOCIO PESSOA JURIDICA DOMICILIADO NO EXTERIOR", "data_entrada": "17/09/2015", "percentual": 60}
  ],
  "pacoteUsado": 25,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 26 — CPF Básico

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "nascimento": "31/12/1900",
  "genero": "M",
  "pacoteUsado": 26,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

Pacote 27 — CPF CAC/SINIC (Antecedentes Criminais PF)

{
  "status": 1,
  "cpf": "111.444.777-35",
  "nome": "Test Token",
  "cac": {
    "nrProtocolo": "123456789012",
    "comprovantePdfBase64": "base64",
    "nadaConsta": true
  },
  "pacoteUsado": 27,
  "saldo": 123,
  "consultaID": "11bb22cc33dd44ee",
  "delay": 0.30
}

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.

Parámetros de la Solicitud

Parámetros de la Respuesta

Objeto pacote{} con información de saldo:

Códigos de Error

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