Documentação da API

curl -X GET \
'https://mapacnpj.seunegocionanuvem.com.br/api/11474116000189' \
-H 'X-API-Key: sua_api_key_aqui'

{
    "razao_social": "GOTA WEB SOLUCOES EM TECNOLOGIA LTDA",
    "fantasia": "GOTA WEB - SOLUCOES EM TECNOLOGIA",
    "contato": "GOTA WEB - SOLUCOES EM TECNOLOGIA",
    "cnpj": "11474116000189",
    "imunicipal": "",
    "suframa": "",
    "indIEDest": "1",
    "endereco": "PRESIDENTE GETULIO VARGAS",
    "numero": "373",
    "complemento": "LOJAS 06 E 07",
    "bairro": "CENTRO",
    "cidade": "Santos Dumont",
    "cd_cidade": "3160702",
    "estado": "MG",
    "cd_estado": "31",
    "cd_pais": "1058",
    "pais": "Brasil",
    "cep": "36240075",
    "telefone": "32 32510659",
    "celular": "",
    "fax": "",
    "email": "contato@gotaweb.com.br",
    "data_cadastro": "2010-01-20",
    "atualizado_em": "2026-09-07 17:18:14",
    "lgpd": 0,
    "data_ultima_atualizacao": "2026-09-07 17:18:14",
    "cnaes_secundarios": [
        {
            "codigo": "4751202",
            "descricao": "Recarga de cartuchos para equipamentos de informática"
        },
        {
            "codigo": "4752100",
            "descricao": "Comércio varejista especializado de equipamentos de telefonia e comunicação"
        },
        {
            "codigo": "4753900",
            "descricao": "Comércio varejista especializado de eletrodomésticos e equipamentos de áudio e vídeo"
        },
        {
            "codigo": "4761003",
            "descricao": "Comércio varejista de artigos de papelaria"
        },
        {
            "codigo": "4789007",
            "descricao": "Comércio varejista de equipamentos para escritório"
        },
        {
            "codigo": "6190699",
            "descricao": "Outras atividades de telecomunicações não especificadas anteriormente"
        },
        {
            "codigo": "7733100",
            "descricao": "Aluguel de máquinas e equipamentos para escritório"
        },
        {
            "codigo": "8219901",
            "descricao": "Fotocópias"
        },
        {
            "codigo": "8219999",
            "descricao": "Preparação de documentos e serviços especializados de apoio administrativo não especificados anteriormente"
        },
        {
            "codigo": "8599603",
            "descricao": "Treinamento em informática"
        },
        {
            "codigo": "9511800",
            "descricao": "Reparação e manutenção de computadores e de equipamentos periféricos"
        },
        {
            "codigo": "9512600",
            "descricao": "Reparação e manutenção de equipamentos de comunicação"
        },
        {
            "codigo": "9521500",
            "descricao": "Reparação e manutenção de equipamentos eletroeletrônicos de uso pessoal e doméstico"
        }
    ],
    "inscricoes_estaduais": [
        {
            "inscricao_estadual": "0015374170074",
            "ativo": 1,
            "estado_sigla": "MG",
            "atualizado_em": "2026-09-07 17:18:14"
        }
    ],
    "simples_nacional": {
        "simples": "Sim",
        "data_opcao_simples": "2010-01-20",
        "data_exclusao_simples": null,
        "mei": "Não",
        "data_opcao_mei": "2010-01-20",
        "data_exclusao_mei": "2013-12-31",
        "atualizado_em": "2026-09-07 17:18:14"
    },
    "socios": [
        {
            "cnpj_basico": "11474116",
            "identificador_socio": "Pessoa Física",
            "nome_socio": "PEDRO HENRIQUE",
            "cpf_cnpj_socio": "***089556**",
            "qualificacao_socio": "49",
            "data_entrada_sociedade": "2022-06-30",
            "pais": "1058",
            "representante_legal": "***000000**",
            "nome_representante": null,
            "qualificacao_representante": null,
            "faixa_etaria": "31 a 40 anos"
        }
    ],
    "cnae_principal": {
        "codigo": "4751201",
        "descricao": "Comércio varejista especializado de equipamentos e suprimentos de informática"
    },
    "natureza_juridica": {
        "codigo": "2062",
        "descricao": "Sociedade Empresária Limitada"
    },
    "porte_empresa": {
        "codigo": "01",
        "descricao": "Micro Empresa"
    },
    "situacao_cadastral": {
        "situacao": "Ativa",
        "data": "2005-11-03",
        "motivo": null
    }
}

"porte_empresa": {
"codigo": "01",
"descricao": "Micro Empresa"
}

"natureza_juridica": {
"codigo": "2062",
"descricao": "Sociedade Empresária Limitada"
}

"inscricoes_estaduais": [
{
"inscricao_estadual": "0015374170074",
"ativo": 1,
"estado_sigla": "MG",
"atualizado_em": "2026-09-07 17:18:14"
}
]

{
"status": 400,
"erro": "Bad Request",
"mensagem": "O CNPJ informado deve conter exatamente 14 digitos numericos."
}

{
"status": 401,
"erro": "Unauthorized",
"mensagem": "Chave de API (X-API-Key) invalida ou nao informada."
}

{
"status": 404,
"erro": "Not Found",
"mensagem": "CNPJ nao encontrado na base de dados."
}

HTTP/1.1 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1700000000

<?php
$cnpj = '11474116000189';
$apiKey = 'sua_api_key_aqui'; // Opcional para plano gratuito

$ch = curl_init("https://mapacnpj.seunegocionanuvem.com.br/api/{$cnpj}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: {$apiKey}"]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
$data = json_decode($response, true);
echo "Razão Social: " . $data['razao_social'] . "\n";
echo "Situação: " . $data['situacao_cadastral']['situacao'] . "\n";
echo "Simples Nacional: " . $data['simples_nacional']['simples'];
} else {
echo "Erro ({$httpCode}): " . $response;
}

import requests

api_key = "sua_api_key_aqui" # Opcional para plano gratuito
cnpj = "11474116000189"

headers = {"X-API-Key": api_key}
response = requests.get(
f"https://mapacnpj.seunegocionanuvem.com.br/api/{cnpj}",
headers=headers
)

if response.status_code == 200:
data = response.json()
print("Razão Social:", data.get("razao_social"))
print("Atividade Principal:", data.get("cnae_principal", {}).get("descricao"))
else:
print(f"Erro {response.status_code}:", response.json())

const apiKey = 'sua_api_key_aqui'; // Opcional para plano gratuito
const cnpj = '11474116000189';

async function consultarCNPJ() {
try {
const response = await fetch(`https://mapacnpj.seunegocionanuvem.com.br/api/${cnpj}`, {
headers: { 'X-API-Key': apiKey }
});

const data = await response.json();

if (response.ok) {
console.log('Empresa:', data.razao_social);
console.log('Inscrições Estaduais:', data.inscricoes_estaduais);
} else {
console.error(`Erro ${response.status}:`, data.mensagem);
}
} catch (error) {
console.error('Erro de conexão:', error);
}
}

consultarCNPJ();