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
- JavaScript
- PHP
- Python
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)
}
<?php
$url = "https://comercial.cnpj.ws/cnpj-raiz/27865757";
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
"x_api_token: SEU_TOKEN",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
import requests
from requests.structures import CaseInsensitiveDict
url = "https://comercial.cnpj.ws/cnpj-raiz/27865757"
headers = CaseInsensitiveDict()
headers["x_api_token"] = "SEU_TOKEN"
resp = requests.get(url, headers=headers)
print(resp.status_code)
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": {}
}