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://api.mapacnpj.com.br/v1/cnpj/{cnpj}
Autenticação
Todas as requisições à API devem incluir sua chave de API no header X-API-Key.
curl -X GET \
'https://api.mapacnpj.com.br/v1/cnpj/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) |
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://api.mapacnpj.com.br/v1/cnpj/{$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://api.mapacnpj.com.br/v1/cnpj/{cnpj}",
headers=headers
)
data = response.json()
print(data["razao_social"])
JavaScript
const apiKey = 'sua_api_key';
const cnpj = '12345678000199';
fetch(`https://api.mapacnpj.com.br/v1/cnpj/${cnpj}`, {
headers: { 'X-API-Key': apiKey }
})
.then(response => response.json())
.then(data => console.log(data.razao_social));