Consultando por la Raíz del CNPJ
En la API comercial también puedes hacer una consulta utilizando la raíz del CNPJ, que son los 8 primeros dígitos del CNPJ y que, en este caso, devolverá todos los CNPJs de la empresa en cuestión. 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-raiz/27865757?token=SEU_TOKEN
Método: GET
Endpoint: https://comercial.cnpj.ws/cnpj-raiz/RAIZ_DO_CNPJ
Ejemplo de Solicitud
GET /cnpj-raiz/{cnpj-raiz} 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-07-15T16:05:17.300Z",
"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-07-15",
"cpf_representante_legal": "text",
"nome_representante": "text",
"faixa_etaria": "text",
"atualizado_em": "2025-07-15T16:05:17.300Z",
"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-07-15",
"data_exclusao_simples": "2025-07-15",
"mei": "text",
"data_opcao_mei": "2025-07-15",
"data_exclusao_mei": "2025-07-15",
"atualizado_em": "2025-07-15T16:05:17.300Z"
},
"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-07-15",
"data_inicio_atividade": "2025-07-15",
"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-07-15",
"atualizado_em": "2025-07-15T16:05:17.300Z",
"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-07-15T16:05:17.300Z",
"estado": {
"id": 1,
"nome": "text",
"sigla": "text",
"ibge_id": 1
}
}
]
}
}
yarn add consultar-cnpj
const consultarCNPJ = require("consultar-cnpj");
async function getRaiz() {
const token = "INFORME O SEU TOKEN DE ACESSO";
const data = await consultarCNPJ.raiz("27865757", token);
console.log(data);
}
Paginación
En caso de que la empresa tenga más de 20 filiales, la API dividirá la respuesta en páginas. Puedes verificar esto en el JSON de retorno de la API, en la propiedad "paginacion", que muestra la página actual, el total de páginas y el total de filiales:
{
"paginacao": {
"limite": 20,
"pagina": 1,
"paginas": 5,
"total": 87
}
}
Para buscar una página específica basta con informar el número de la página en la solicitud:
curl -X GET https://comercial.cnpj.ws/cnpj-raiz/27865757?page=2 -H "x_api_token: SEU_TOKEN"
Ejemplo de Retorno
A continuación, un ejemplo del JSON retornado al buscar por la raíz del CNPJ 27865757:
{
"data": [
"27865757002148",
"27865757002229",
"27865757002300",
"27865757002490",
"27865757002571",
"27865757002652",
"27865757002733",
"27865757002814",
"27865757002903",
"27865757003039",
"27865757003110",
"27865757003209",
"27865757003381",
"27865757003462",
"27865757003543",
"27865757003624",
"27865757003705",
"27865757003896",
"27865757003977",
"27865757004000"
],
"paginacao": {
"limite": 20,
"pagina": 2,
"paginas": 5,
"total": 87
},
"ordenacao": [],
"filtros_disponiveis": ["nome_fantasia", "pais_id", "estado_id", "cidade_id"],
"filtros_aplicados": {}
}
Última actualización
¿Te fue útil?