Consultando pela Raiz do CNPJ

Na API comercial você também pode fazer uma consulta utilizando a raiz do CNPJ, que são os 8 primeiros dígitos do CNPJ e que, nesse caso, irá retornar todos os CNPJs da empresa em questão. Nesse endpoint, você deve enviar o header x_api_token com o token que lhe foi enviado via e-mail.

Você também pode passar o token como um parâmetro na URL, exemplo:

https://comercial.cnpj.ws/cnpj-raiz/27865757?token=SEU_TOKEN

Método: GET

Endpoint: https://comercial.cnpj.ws/cnpj-raiz/RAIZ_DO_CNPJ

Exemplo de Requisição

Recupera dados de uma empresa pelo CNPJ raiz

get

Autorizações

x_api_tokentoken

x_api_tokenstringObrigatório

Parâmetros de rota

cnpj-raizintegerObrigatório

Parâmetros de consulta

tokenstringOpcional

Token de autenticação (opcional, pode ser passado no header como x_api_token)

Parâmetros de cabeçalho

x_api_tokenstringOpcional

Token de autenticação (opcional, pode ser passado na query como token)

Respostas

200

Sucesso

application/json

401

Não autenticado

application/json

404

Não encontrado

application/json

get

/cnpj-raiz/{cnpj-raiz}

HTTPcURLJavaScriptPython

GET /cnpj-raiz/{cnpj-raiz} HTTP/1.1
Host: comercial.cnpj.ws
x_api_token: YOUR_API_KEY
Accept: */*

{
  "data": [
    "text"
  ],
  "paginacao": {
    "limite": 1,
    "pagina": 1,
    "paginas": 1
  },
  "ordenacao": [
    "text"
  ],
  "filtros_disponiveis": [
    "text"
  ],
  "filtros_aplicados": {
    "nome_fantasia": "text",
    "pais_id": "text",
    "estado_id": "text",
    "cidade_id": "text",
    "atividade_principal_id": "text",
    "tipo": "text"
  }
}

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);
}

Mais informações do pacote

Paginação

Caso a empresa possua mais de 20 filiais a API irá dividir a resposta em páginas. Você pode verificar isso no JSON de retono da API, na propriedade "paginacao", que exibe a página atual, o total de páginas e o total de filiais:

{
  "paginacao": {
    "limite": 20,
    "pagina": 1,
    "paginas": 5,
    "total": 87
  }
}

Para buscar uma página específica basta informar o número da página na requisição:

curl -X GET https://comercial.cnpj.ws/cnpj-raiz/27865757?page=2 -H "x_api_token: SEU_TOKEN"

Exemplo de Retorno

Abaixo um exemplo do JSON retornado ao se buscar pela raiz do 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": {}
}