Consulta de CNPJ

GET https://api.cnpj.wiki/v1/cnpj/{cnpj}

Parâmetro

Nome	Onde	Observação
`{cnpj}`	path	14 caracteres. Pontos e hífens são ignorados

Exemplo

curl https://api.cnpj.wiki/v1/cnpj/00000000000191

{
	"cnpj": "00000000000191",
	"cnpj_base": "00000000",
	"razao_social": "BANCO DO BRASIL SA",
	"nome_fantasia": "DIRECAO GERAL",
	"matriz_filial": { "id": 1, "descricao": "MATRIZ" },
	"situacao_cadastral": {
		"id": "02",
		"descricao": "ATIVA",
		"data": "2005-11-03",
		"motivo": { "id": "00", "descricao": "SEM MOTIVO" }
	},
	"situacao_especial": null,
	"data_inicio_atividade": "1966-08-01",
	"natureza_juridica": { "id": "2038", "descricao": "Sociedade de Economia Mista" },
	"porte": { "id": "05", "descricao": "DEMAIS" },
	"capital_social": 120000000000,
	"qualificacao_responsavel": { "id": "10", "descricao": "Diretor" },
	"ente_federativo_responsavel": null,
	"endereco": {
		"tipo_logradouro": "QUADRA",
		"logradouro": "SAUN QUADRA 5 BLOCO B TORRE I, II, III",
		"numero": "SN",
		"complemento": "ANDAR T I SL S101 A S1602 T II SL C101 A C1602 TIII SL N101 A N1602",
		"bairro": "ASA NORTE",
		"cep": "70040912",
		"municipio": { "id": "9701", "descricao": "BRASILIA" },
		"uf": "DF",
		"pais": null,
		"cidade_exterior": null
	},
	"contato": {
		"telefone_1": "61 34939002",
		"telefone_2": null,
		"fax": "61 34931040",
		"email": "[email protected]"
	},
	"cnae_principal": { "id": "6422100", "descricao": "Bancos múltiplos, com carteira comercial" },
	"cnaes_secundarios": [
		{
			"id": "6499999",
			"descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
		}
	],
	"simples": {
		"optante": false,
		"data_opcao": "2007-07-01",
		"data_exclusao": "2007-07-01",
		"mei": false,
		"data_opcao_mei": "2009-07-01",
		"data_exclusao_mei": "2009-07-01"
	},
	"socios": [
		{
			"nome": "TARCIANA PAULA GOMES MEDEIROS",
			"documento": "***128734**",
			"tipo": 2,
			"qualificacao": { "id": "16", "descricao": "Presidente" },
			"data_entrada": "2023-01-26",
			"faixa_etaria": 5,
			"pais": null,
			"representante_legal": {
				"documento": "***000000**",
				"nome": null,
				"qualificacao": { "id": "00", "descricao": "Não informada" }
			}
		}
	]
}

Campos da resposta

Campo	Tipo	Observação
`cnpj`	string	14 caracteres, sem máscara
`cnpj_base`	string	8 primeiros caracteres, comuns a matriz e filiais
`razao_social`	string \| null	Nome empresarial registrado
`nome_fantasia`	string \| null
`matriz_filial`	objeto \| null	`{ id: 1, descricao: "MATRIZ" }` ou `{ id: 2, descricao: "FILIAL" }`
`situacao_cadastral`	objeto	`id`, `descricao`, `data` e `motivo`
`situacao_especial`	objeto \| null	Preenchido só quando existe
`data_inicio_atividade`	string \| null	`AAAA-MM-DD`
`natureza_juridica`	objeto \| null
`porte`	objeto \| null
`capital_social`	número \| null	Em reais
`qualificacao_responsavel`	objeto \| null
`ente_federativo_responsavel`	string \| null	Só para órgãos públicos
`endereco`	objeto	Ver abaixo
`contato`	objeto	`telefone_1`, `telefone_2`, `fax`, `email`
`cnae_principal`	objeto \| null
`cnaes_secundarios`	lista	Pode ser vazia
`simples`	objeto \| null	`null` quando o CNPJ não consta na tabela do Simples
`socios`	lista	Quadro completo, sem teto

Campos de código seguem o formato { "id": "02", "descricao": "ATIVA" }. O id é string para preservar o zero à esquerda da Receita ("02", "08").

`endereco`

tipo_logradouro, logradouro, numero, complemento, bairro, cep, municipio, uf, pais e cidade_exterior.

cep vem sem máscara, com 8 dígitos. municipio.id é o código da Receita, diferente do código do IBGE.

`socios`

Cada item traz nome, documento, tipo, qualificacao, data_entrada, faixa_etaria, pais e representante_legal.

documento vem mascarado da Receita, no formato ***550179**.

tipo indica 1 para pessoa jurídica, 2 para pessoa física e 3 para estrangeiro.

Erros

Toda falha responde no mesmo formato, com mensagem em português:

{ "erro": "dígito verificador inválido", "codigo": "cnpj_invalido" }

Status	`codigo`	Quando acontece
`400`	`cnpj_invalido`	Formato errado ou dígito verificador incorreto
`404`	`nao_encontrado`	CNPJ válido, mas ausente da base da Receita
`429`	`limite_excedido`	Acima de 60 requisições por minuto
`500`	`erro_interno`	Erro no servidor