CNPJws
Español
Español
  • Visión General
  • Modelos de datos
    • Países
    • Estados
    • Ciudades
    • Naturalezas Jurídicas
    • Tamaños
    • Actividades Económicas
    • Calificaciones Societarias
    • Socios
    • Simples Nacional y MEI
    • Establecimientos
    • Inscripciones Estatales
    • Suframa
    • Regímenes Tributarios
    • Situaciones Cadastrales
    • Mensajes de Error
  • Changelog
  • Referencia de API
    • API - Comercial
      • Consultando CNPJ en la API Comercial
      • Consultando por la Raíz del CNPJ
      • Búsqueda de Empresas
      • Consultando el Consumo de Solicitudes Mensuales
      • Validando Inscripción en Suframa
    • API - Pública
      • Consultando CNPJ en la API Pública
      • Validando Inscripción en Suframa en la API Pública
      • Limitaciones
  • BLOG
    • Qué es el CNPJ
    • Consultar CNPJ con Java
    • Consultar CNPJ Gratuitamente con Excel
    • Consultar CNPJ con PHP
    • Gatillo para consultar CNPJ en Protheus
    • Mantener el registro de clientes y proveedores actualizado
    • Consultar CNPJ con Javascript y Node.JS
    • Consultar CNPJ con ADVPL (Protheus)
    • Proyecto CNPJ.ws
Con tecnología de GitBook
En esta página

¿Te fue útil?

  1. Referencia de API
  2. API - Comercial

Consultando CNPJ en la API Comercial

AnteriorAPI - ComercialSiguienteConsultando por la Raíz del CNPJ

Última actualización hace 5 meses

¿Te fue útil?

En la API comercial puedes hacer una consulta directa por un CNPJ en nuestra base. En este endpoint debes enviar el header x_api_token con el token que te fue enviado por correo electrónico.

También puedes pasar el token como un parámetro en la URL, ejemplo:

https://comercial.cnpj.ws/cnpj/27865757000102?token=SEU_TOKEN

Método: GET

Endpoint: https://comercial.cnpj.ws/cnpj/NUMERO_DO_CNPJ_SEM_CARACTERES_ESPECIAIS

Ejemplos de Solicitud

Nosotros tenemos un paquete que puede ayudarte en la integración con JavaScript:

yarn add consultar-cnpj
const consultarCNPJ = require("consultar-cnpj");

async function getCNPJ() {
  const token = "INFORME O SEU TOKEN DE ACESSO";

  const empresa = await consultarCNPJ("27865757000102", token);
  console.log(empresa);
}

Ejemplo de Retorno

A continuación, un ejemplo del JSON retornado al buscar por el CNPJ 27865757000102:

{
  "cnpj_raiz": "27865757",
  "razao_social": "GLOBO COMUNICACAO E PARTICIPACOES S/A",
  "capital_social": "6983568523.86",
  "responsavel_federativo": "",
  "atualizado_em": "2023-11-11T03:00:00.000Z",
  "porte": {
    "id": "05",
    "descricao": "Demais"
  },
  "natureza_juridica": {
    "id": "2054",
    "descricao": "Sociedade Anônima Fechada"
  },
  "qualificacao_do_responsavel": {
    "id": 10,
    "descricao": "Diretor "
  },
  "socios": [
    {
      "cpf_cnpj_socio": "***048947**",
      "nome": "PAULO DAUDT MARINHO",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "41 a 50 anos",
      "atualizado_em": "2023-10-14T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null,
      "pais": {
        "id": "1058",
        "iso2": "BR",
        "iso3": "BRA",
        "nome": "Brasil",
        "comex_id": "105"
      }
    },
    {
      "cpf_cnpj_socio": "***834960**",
      "nome": "CLAUDIA FALCAO DA MOTTA",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2023-10-14T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null,
      "pais": {
        "id": "1058",
        "iso2": "BR",
        "iso3": "BRA",
        "nome": "Brasil",
        "comex_id": "105"
      }
    },
    {
      "cpf_cnpj_socio": "***486498**",
      "nome": "RAYMUNDO COSTA PINTO BARROS",
      "tipo": "Pessoa Física",
      "data_entrada": "2021-03-15",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "61 a 70 anos",
      "atualizado_em": "2023-10-14T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null,
      "pais": {
        "id": "1058",
        "iso2": "BR",
        "iso3": "BRA",
        "nome": "Brasil",
        "comex_id": "105"
      }
    },
    {
      "cpf_cnpj_socio": "***223047**",
      "nome": "ERICK DE MIRANDA BRETAS",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "41 a 50 anos",
      "atualizado_em": "2023-10-14T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null,
      "pais": {
        "id": "1058",
        "iso2": "BR",
        "iso3": "BRA",
        "nome": "Brasil",
        "comex_id": "105"
      }
    },
    {
      "cpf_cnpj_socio": "***189808**",
      "nome": "AMAURI SERGIO SOARES",
      "tipo": "Pessoa Física",
      "data_entrada": "2022-02-11",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2023-10-14T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 5,
        "descricao": "Administrador "
      },
      "qualificacao_representante": null,
      "pais": {
        "id": "1058",
        "iso2": "BR",
        "iso3": "BRA",
        "nome": "Brasil",
        "comex_id": "105"
      }
    }
  ],
  "simples": null,
  "estabelecimento": {
    "cnpj": "27865757000102",
    "atividades_secundarias": [
      {
        "id": "5911102",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.11-1",
        "subclasse": "5911-1/02",
        "descricao": "Produção de filmes para publicidade"
      },
      {
        "id": "5911199",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.11-1",
        "subclasse": "5911-1/99",
        "descricao": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente"
      },
      {
        "id": "5912002",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.12-0",
        "subclasse": "5912-0/02",
        "descricao": "Serviços de mixagem sonora em produção audiovisual"
      },
      {
        "id": "5913800",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.13-8",
        "subclasse": "5913-8/00",
        "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
      },
      {
        "id": "5920100",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.2",
        "classe": "59.20-1",
        "subclasse": "5920-1/00",
        "descricao": "Atividades de gravação de som e de edição de música"
      },
      {
        "id": "6022501",
        "secao": "J",
        "divisao": "60",
        "grupo": "60.2",
        "classe": "60.22-5",
        "subclasse": "6022-5/01",
        "descricao": "Programadoras"
      },
      {
        "id": "6204000",
        "secao": "J",
        "divisao": "62",
        "grupo": "62.0",
        "classe": "62.04-0",
        "subclasse": "6204-0/00",
        "descricao": "Consultoria em tecnologia da informação"
      },
      {
        "id": "6209100",
        "secao": "J",
        "divisao": "62",
        "grupo": "62.0",
        "classe": "62.09-1",
        "subclasse": "6209-1/00",
        "descricao": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
      },
      {
        "id": "6311900",
        "secao": "J",
        "divisao": "63",
        "grupo": "63.1",
        "classe": "63.11-9",
        "subclasse": "6311-9/00",
        "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
      },
      {
        "id": "6319400",
        "secao": "J",
        "divisao": "63",
        "grupo": "63.1",
        "classe": "63.19-4",
        "subclasse": "6319-4/00",
        "descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
      },
      {
        "id": "6463800",
        "secao": "K",
        "divisao": "64",
        "grupo": "64.6",
        "classe": "64.63-8",
        "subclasse": "6463-8/00",
        "descricao": "Outras sociedades de participação, exceto holdings"
      },
      {
        "id": "7020400",
        "secao": "M",
        "divisao": "70",
        "grupo": "70.2",
        "classe": "70.20-4",
        "subclasse": "7020-4/00",
        "descricao": "Atividades de consultoria em gestão empresarial, exceto consultoria técnica específica"
      },
      {
        "id": "7490104",
        "secao": "M",
        "divisao": "74",
        "grupo": "74.9",
        "classe": "74.90-1",
        "subclasse": "7490-1/04",
        "descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
      },
      {
        "id": "7739099",
        "secao": "N",
        "divisao": "77",
        "grupo": "77.3",
        "classe": "77.39-0",
        "subclasse": "7739-0/99",
        "descricao": "Aluguel de outras máquinas e equipamentos comerciais e industriais não especificados anteriormente, sem operador"
      },
      {
        "id": "7740300",
        "secao": "N",
        "divisao": "77",
        "grupo": "77.4",
        "classe": "77.40-3",
        "subclasse": "7740-3/00",
        "descricao": "Gestão de ativos intangíveis não financeiros"
      },
      {
        "id": "9001902",
        "secao": "R",
        "divisao": "90",
        "grupo": "90.0",
        "classe": "90.01-9",
        "subclasse": "9001-9/02",
        "descricao": "Produção musical"
      },
      {
        "id": "9319101",
        "secao": "R",
        "divisao": "93",
        "grupo": "93.1",
        "classe": "93.19-1",
        "subclasse": "9319-1/01",
        "descricao": "Produção e promoção de eventos esportivos"
      },
      {
        "id": "9512600",
        "secao": "S",
        "divisao": "95",
        "grupo": "95.1",
        "classe": "95.12-6",
        "subclasse": "9512-6/00",
        "descricao": "Reparação e manutenção de equipamentos de comunicação"
      }
    ],
    "cnpj_raiz": "27865757",
    "cnpj_ordem": "0001",
    "cnpj_digito_verificador": "02",
    "tipo": "Matriz",
    "nome_fantasia": "TV/REDE/CANAIS/G2C+GLOBO GLOBO.COM GLOBOPLAY",
    "situacao_cadastral": "Ativa",
    "data_situacao_cadastral": "2005-11-03",
    "data_inicio_atividade": "1986-01-31",
    "nome_cidade_exterior": null,
    "tipo_logradouro": "RUA",
    "logradouro": "LOPES QUINTAS",
    "numero": "303",
    "complemento": null,
    "bairro": "JARDIM BOTANICO",
    "cep": "22460901",
    "ddd1": "21",
    "telefone1": "21554551",
    "ddd2": "21",
    "telefone2": "21554552",
    "ddd_fax": "21",
    "fax": "25408773",
    "email": null,
    "situacao_especial": null,
    "data_situacao_especial": null,
    "atualizado_em": "2023-11-11T03:00:00.000Z",
    "atividade_principal": {
      "id": "6021700",
      "secao": "J",
      "divisao": "60",
      "grupo": "60.2",
      "classe": "60.21-7",
      "subclasse": "6021-7/00",
      "descricao": "Atividades de televisão aberta"
    },
    "pais": {
      "id": "1058",
      "iso2": "BR",
      "iso3": "BRA",
      "nome": "Brasil",
      "comex_id": "105"
    },
    "estado": {
      "id": 19,
      "nome": "Rio de Janeiro",
      "sigla": "RJ",
      "ibge_id": 33
    },
    "cidade": {
      "id": 3243,
      "nome": "Rio de Janeiro",
      "ibge_id": 3304557,
      "siafi_id": "6001"
    },
    "motivo_situacao_cadastral": null,
    "inscricoes_estaduais": [
      {
        "inscricao_estadual": "113717433112",
        "ativo": false,
        "atualizado_em": "2023-07-19T04:12:55.698Z",
        "estado": {
          "id": 26,
          "nome": "São Paulo",
          "sigla": "SP",
          "ibge_id": 35
        }
      },
      {
        "inscricao_estadual": "84295760",
        "ativo": true,
        "atualizado_em": "2023-07-19T04:12:55.698Z",
        "estado": {
          "id": 19,
          "nome": "Rio de Janeiro",
          "sigla": "RJ",
          "ibge_id": 33
        }
      },
      {
        "inscricao_estadual": "84347353",
        "ativo": false,
        "atualizado_em": "2023-07-19T04:12:55.698Z",
        "estado": {
          "id": 19,
          "nome": "Rio de Janeiro",
          "sigla": "RJ",
          "ibge_id": 33
        }
      },
      {
        "inscricao_estadual": "9000073850",
        "ativo": true,
        "atualizado_em": "2023-11-04T03:00:00.000Z",
        "estado": {
          "id": 23,
          "nome": "Rio Grande do Sul",
          "sigla": "RS",
          "ibge_id": 43
        }
      },
      {
        "inscricao_estadual": "0629985490214",
        "ativo": true,
        "atualizado_em": "2023-11-04T03:00:00.000Z",
        "estado": {
          "id": 11,
          "nome": "Minas Gerais",
          "sigla": "MG",
          "ibge_id": 31
        }
      },
      {
        "inscricao_estadual": "819017430118",
        "ativo": true,
        "atualizado_em": "2023-11-20T03:00:00.000Z",
        "estado": {
          "id": 26,
          "nome": "São Paulo",
          "sigla": "SP",
          "ibge_id": 35
        }
      }
    ],
    "inscricoes_suframa": [],
    "regimes_tributarios": [
      {
        "ano": 2021,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2020,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2019,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2018,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2017,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2016,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2015,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      },
      {
        "ano": 2014,
        "regime_tributario": "LUCRO REAL",
        "forma_de_tributacao": "LUCRO REAL",
        "atualizado_em": "2023-01-26T03:00:00.000Z"
      }
    ]
  }
}

Más información del paquete

Recupera dados de uma empresa pelo seu CNPJ (API Comercial)

get
Autorizaciones
Parámetros de ruta
cnpjintegerRequerido
Respuestas
200
Sucesso
application/json
401
Não autenticado
application/json
404
Não encontrado
application/json
get
GET /cnpj/{cnpj} HTTP/1.1
Host: comercial.cnpj.ws
Authorization: Bearer JWT
Accept: */*
{
  "cnpj_raiz": "text",
  "razao_social": "text",
  "capital_social": "text",
  "responsavel_federativo": "text",
  "atualizado_em": "2025-06-10T05:11:42.863Z",
  "porte": {
    "id": "text",
    "descricao": "text"
  },
  "natureza_juridica": {
    "id": "text",
    "descricao": "text"
  },
  "qualificacao_do_responsavel": {
    "id": 1,
    "descricao": "text"
  },
  "socios": [
    {
      "cpf_cnpj_socio": "text",
      "nome": "text",
      "tipo": "text",
      "data_entrada": "2025-06-10",
      "cpf_representante_legal": "text",
      "nome_representante": "text",
      "faixa_etaria": "text",
      "atualizado_em": "2025-06-10T05:11:42.863Z",
      "pais_id": "text",
      "qualificacao_socio": {
        "id": 1,
        "descricao": "text"
      },
      "qualificacao_representante": "text",
      "pais": {
        "id": "text",
        "iso2": "text",
        "iso3": "text",
        "nome": "text",
        "comex_id": "text"
      }
    }
  ],
  "simples": {
    "simples": "text",
    "data_opcao_simples": "2025-06-10",
    "data_exclusao_simples": "2025-06-10",
    "mei": "text",
    "data_opcao_mei": "2025-06-10",
    "data_exclusao_mei": "2025-06-10",
    "atualizado_em": "2025-06-10T05:11:42.863Z"
  },
  "estabelecimento": {
    "cnpj": "text",
    "atividades_secundarias": [
      {
        "id": "text",
        "secao": "text",
        "divisao": "text",
        "grupo": "text",
        "classe": "text",
        "subclasse": "text",
        "descricao": "text"
      }
    ],
    "cnpj_raiz": "text",
    "cnpj_ordem": "text",
    "cnpj_digito_verificador": "text",
    "tipo": "text",
    "nome_fantasia": "text",
    "situacao_cadastral": "text",
    "data_situacao_cadastral": "2025-06-10",
    "data_inicio_atividade": "2025-06-10",
    "nome_cidade_exterior": "text",
    "tipo_logradouro": "text",
    "logradouro": "text",
    "numero": "text",
    "complemento": "text",
    "bairro": "text",
    "cep": "text",
    "ddd1": "text",
    "telefone1": "text",
    "ddd2": "text",
    "telefone2": "text",
    "ddd_fax": "text",
    "fax": "text",
    "email": "text",
    "situacao_especial": "text",
    "data_situacao_especial": "2025-06-10",
    "atualizado_em": "2025-06-10T05:11:42.863Z",
    "atividade_principal": {
      "id": "text",
      "secao": "text",
      "divisao": "text",
      "grupo": "text",
      "classe": "text",
      "subclasse": "text",
      "descricao": "text"
    },
    "pais": {
      "id": "text",
      "iso2": "text",
      "iso3": "text",
      "nome": "text",
      "comex_id": "text"
    },
    "estado": {
      "id": 1,
      "nome": "text",
      "sigla": "text",
      "ibge_id": 1
    },
    "cidade": {
      "id": 1,
      "nome": "text",
      "ibge_id": 1,
      "siafi_id": "text"
    },
    "motivo_situacao_cadastral": "text",
    "inscricoes_estaduais": [
      {
        "inscricao_estadual": "text",
        "ativo": true,
        "atualizado_em": "2025-06-10T05:11:42.863Z",
        "estado": {
          "id": 1,
          "nome": "text",
          "sigla": "text",
          "ibge_id": 1
        }
      }
    ]
  }
}
  • Ejemplos de Solicitud
  • GETRecupera dados de uma empresa pelo seu CNPJ (API Comercial)