Documentação da API

Bem-vindo à documentação oficial da API Mapa CNPJ. Nossa API RESTful fornece acesso a dados completos de empresas brasileiras de forma rápida e segura.

GET https://mapacnpj.seunegocionanuvem.com.br/api/{cnpj}

Autenticação

Todas as requisições à API devem incluir sua chave de API no header X-API-Key.

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

Consultar CNPJ

Retorna todos os dados disponíveis para um CNPJ específico.

Parâmetros

Parâmetro Tipo Descrição
cnpj string CNPJ com 14 dígitos (apenas números)

Atenção

No momento, a API retorna a Inscrição Estadual (IE) apenas para os seguintes estados:

  • Bahia (BA)
  • Goiás (GO)
  • Minas Gerais (MG)
  • Paraíba (PB)
  • Paraná (PR)
  • Pernambuco (PE)
  • Rio Grande do Sul (RS)
  • Santa Catarina (SC)
  • São Paulo (SP)
  • Sergipe (SE)

Estamos trabalhando continuamente para disponibilizar as Inscrições Estaduais dos demais estados em breve.

Exemplo de Resposta

{
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "cnpj": "12345678000199",
  "situacao_cadastral": "Ativa",
  "cnae_principal": {
    "codigo": "6201501",
    "descricao": "Desenvolvimento de software"
  },
  "endereco": {
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "cidade": "São Paulo",
    "estado": "SP"
  }
}

Exemplos de Código

PHP

<?php
$cnpj = '12345678000199';
$apiKey = 'sua_api_key';

$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);
$data = json_decode($response, true);

echo $data['razao_social'];

Python

import requests

api_key = "sua_api_key"
cnpj = "12345678000199"

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

data = response.json()
print(data["razao_social"])

JavaScript

const apiKey = 'sua_api_key';
const cnpj = '12345678000199';

fetch(`https://mapacnpj.seunegocionanuvem.com.br/api/${cnpj}`, {
    headers: { 'X-API-Key': apiKey }
})
.then(response => response.json())
.then(data => console.log(data.razao_social));
Suporte Técnico