{"openapi":"3.1.0","info":{"title":"API do CNPJ Completo","version":"1.0.0","description":"Dados públicos de empresas brasileiras ativas, da Receita Federal, com dívida ativa da União e sanções. Sem chave: 5 consultas por minuto por endereço. Com chave (Básico, 30 por minuto; Pro, 120 por minuto): o valor da dívida e os registros das sanções. Também como servidor MCP em https://cnpjcompleto.com.br/mcp."},"servers":[{"url":"https://cnpjcompleto.com.br"}],"externalDocs":{"url":"https://cnpjcompleto.com.br/api"},"paths":{"/api/v1/cnpj/{cnpj}":{"get":{"operationId":"consultarCnpj","summary":"Consultar uma empresa pelo CNPJ","parameters":[{"name":"cnpj","in":"path","required":true,"description":"Numérico ou alfanumérico, com ou sem pontuação","schema":{"type":"string","examples":["11222333000181"]}}],"security":[{},{"chave":[]}],"responses":{"200":{"description":"A empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empresa"}}}},"400":{"description":"CNPJ inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Chave inválida ou assinatura encerrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Nenhuma empresa ativa com esse CNPJ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Indisponível; tente de novo em alguns minutos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"securitySchemes":{"chave":{"type":"http","scheme":"bearer","description":"A chave mostrada depois da assinatura, em https://cnpjcompleto.com.br/api"}},"schemas":{"Empresa":{"type":"object","properties":{"cnpj":{"type":"string","description":"14 caracteres, sem pontuação"},"matriz":{"type":"boolean"},"razao_social":{"type":["string","null"]},"nome_fantasia":{"type":["string","null"]},"situacao":{"type":"string","enum":["ativa"]},"data_abertura":{"type":["string","null"],"format":"date"},"natureza_juridica":{"type":["string","null"]},"porte":{"type":["string","null"],"enum":["MEI","ME","EPP","Demais",null]},"mei":{"type":"boolean"},"simples":{"type":"boolean"},"regime_tributario":{"type":["object","null"],"description":"Regime declarado na ECF; nulo para empresas do Simples e sem declaração","properties":{"regimes":{"type":"array","items":{"type":"string","enum":["lucro_real","lucro_presumido","lucro_arbitrado","imune","isenta"]}},"ano":{"type":"integer"}}},"capital_social":{"type":["number","null"]},"cnae_principal":{"type":["object","null"],"properties":{"codigo":{"type":"string"},"descricao":{"type":["string","null"]}}},"cnaes_secundarios":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":["string","null"]}}}},"endereco":{"type":"object","properties":{"logradouro":{"type":["string","null"]},"numero":{"type":["string","null"]},"complemento":{"type":["string","null"]},"bairro":{"type":["string","null"]},"cep":{"type":["string","null"]},"municipio":{"type":["string","null"]},"uf":{"type":["string","null"]}}},"telefones":{"type":"array","items":{"type":"string"},"description":"Vazio para MEI"},"email":{"type":["string","null"],"description":"Nulo para MEI"},"socios":{"type":"array","items":{"type":"object","properties":{"nome":{"type":["string","null"]},"qualificacao":{"type":["string","null"]},"desde":{"type":["string","null"],"format":"date"},"faixa_etaria":{"type":["string","null"]}}}},"tem_debito":{"type":["boolean","null"],"description":"Consta na dívida ativa da União; nulo se a fonte não respondeu"},"tem_sancao":{"type":["boolean","null"],"description":"Consta no CEIS, no CNEP ou na lista do trabalho escravo"},"divida_ativa":{"type":["object","null"],"description":"Só com chave","properties":{"valor":{"type":"number"},"inscricoes":{"type":"integer"},"situacoes":{"type":"array","items":{"type":"string"}},"ajuizado":{"type":"boolean"},"corresponsavel":{"type":"boolean"}}},"sancoes":{"type":"array","items":{"type":"object"},"description":"Só com chave: registros do CEIS e do CNEP"},"lista_suja":{"type":["object","null"],"description":"Só com chave: registro na lista do trabalho escravo"},"fontes":{"type":"object","additionalProperties":{"type":"string"},"description":"Só com chave: data de cada fonte"},"dados_de":{"type":"string","description":"Mês dos dados da Receita, como 2026-10"}},"required":["cnpj","situacao","dados_de"]},"Erro":{"type":"object","properties":{"erro":{"type":"string"}},"required":["erro"]}}}}