{"openapi":"3.1.0","info":{"title":"CNPJ API","version":"2.0.0","description":"\nAPI para consulta de dados cadastrais de empresas brasileiras a partir do **CNPJ**.\n\n## Formatos de CNPJ aceitos\n\nO CNPJ pode ser enviado **com ou sem pontuação**, e suporta o novo **CNPJ alfanumérico** (12 caracteres `0-9A-Z` + 2 dígitos verificadores):\n\n| Entrada | Exemplo |\n| --- | --- |\n| Somente números | `/06990590000123` |\n| Com máscara | `/06.990.590/0001-23` |\n| Alfanumérico | `/00000000E08G12` |\n| Alfanumérico com máscara | `/00.000.000/E08G-12` |\n\nLetras minúsculas são normalizadas para maiúsculas. Os dígitos verificadores são validados antes de qualquer consulta externa.\n\n## Fontes\n\nOs dados vêm da [Minha Receita](https://minhareceita.org); em caso de falha, é usada a [ReceitaWS](https://receitaws.com.br) como fallback (limite de ~3 req/min).\n\n## Versões\n\n- **v2** — `GET /{cnpj}`: retorna os dados diretamente; a fonte vem no header `X-Source`.\n- **v1** — `GET /api/v1/{cnpj}`: mantida por compatibilidade, retorna `{ \"source\", \"data\" }`.\n","license":{"name":"MIT"}},"servers":[{"url":"https://cnpj.juk.re","description":"Produção"},{"url":"/","description":"Servidor atual"}],"tags":[{"name":"v2","description":"Versão atual."},{"name":"v1","description":"Versão legada, mantida por compatibilidade."}],"paths":{"/{cnpj}":{"get":{"tags":["v2"],"summary":"Consultar CNPJ","operationId":"getCnpjV2","parameters":[{"name":"cnpj","in":"path","required":true,"description":"CNPJ numérico ou alfanumérico, com ou sem pontuação.","schema":{"type":"string"},"examples":{"numerico":{"summary":"Numérico, sem máscara","value":"06990590000123"},"mascara":{"summary":"Com pontuação (a barra é aceita na URL)","value":"06.990.590/0001-23"},"alfanumerico":{"summary":"Alfanumérico","value":"00000000E08G12"}}}],"responses":{"200":{"description":"Dados da empresa, no formato da fonte que respondeu.","headers":{"X-Source":{"description":"Fonte que respondeu a consulta.","schema":{"type":"string","enum":["minhareceita","receitaws"]}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"cnpj":"06990590000123","razao_social":"GOOGLE BRASIL INTERNET LTDA.","uf":"SP","descricao_situacao_cadastral":"ATIVA"}}}},"400":{"description":"CNPJ com formato ou dígitos verificadores inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"example":{"error":"CNPJ inválido: informe 12 caracteres alfanuméricos + 2 dígitos verificadores."}}}},"404":{"description":"CNPJ válido, mas não encontrado nas fontes.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"example":{"error":"CNPJ não encontrado."}}}},"502":{"description":"Nenhuma das fontes respondeu.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"minhareceita_error":{"type":"string"},"receitaws_error":{"type":"string"}}}}}}}}},"/api/v1/{cnpj}":{"get":{"tags":["v1"],"summary":"Consultar CNPJ (v1)","operationId":"getCnpjV1","parameters":[{"name":"cnpj","in":"path","required":true,"description":"CNPJ numérico ou alfanumérico, com ou sem pontuação.","schema":{"type":"string"},"examples":{"numerico":{"summary":"Numérico, sem máscara","value":"06990590000123"},"mascara":{"summary":"Com pontuação (a barra é aceita na URL)","value":"06.990.590/0001-23"},"alfanumerico":{"summary":"Alfanumérico","value":"00000000E08G12"}}}],"responses":{"200":{"description":"Dados da empresa envelopados com a fonte.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","enum":["minhareceita","receitaws"]},"data":{"type":"object","additionalProperties":true}},"required":["source","data"]},"example":{"source":"minhareceita","data":{"cnpj":"06990590000123","razao_social":"GOOGLE BRASIL INTERNET LTDA."}}}}},"400":{"description":"CNPJ com formato ou dígitos verificadores inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"CNPJ inválido: informe 12 caracteres alfanuméricos + 2 dígitos verificadores."}}}},"404":{"description":"CNPJ válido, mas não encontrado nas fontes.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"CNPJ não encontrado."}}}},"502":{"description":"Nenhuma das fontes respondeu.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"minhareceita_error":{"type":"string"},"receitaws_error":{"type":"string"}}}}}}}}}}}