{"openapi":"3.1.0","info":{"title":"Apizen","version":"1.0.0","summary":"APIs de CNPJ e CEP com os dados abertos da Receita Federal e do IBGE.","description":"Documentação: https://apizen.com.br/docs/inicio. Para IAs: https://apizen.com.br/llms.txt.","contact":{"name":"Apizen","url":"https://apizen.com.br/contato"}},"externalDocs":{"url":"https://apizen.com.br/docs/inicio"},"security":[{"bearer":[]}],"paths":{"/cnpj/{cnpj}":{"servers":[{"url":"https://cnpj.apizen.com.br/v1"}],"get":{"operationId":"consultarCnpj","summary":"Cadastro de um CNPJ","description":"Situação, endereço, CNAE, Simples Nacional e contato de um estabelecimento.","tags":["CNPJ"],"parameters":[{"name":"cnpj","in":"path","required":true,"description":"14 caracteres; pontos, hífen e a barra (codificada como %2F ou omitida) são aceitos. Desde julho de 2026 os 12 primeiros podem ser letras (CNPJ alfanumérico).","schema":{"type":"string"},"example":"33000167000101"}],"responses":{"200":{"description":"O estabelecimento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cnpj"}}}},"400":{"description":"Formato inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Sem chave, ou chave inválida, revogada ou pausada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"CNPJ que não está na base","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cnpj/{cnpj}/nome":{"servers":[{"url":"https://cnpj.apizen.com.br/v1"}],"get":{"operationId":"nomeCnpj","summary":"Razão social e nome fantasia","tags":["CNPJ"],"parameters":[{"name":"cnpj","in":"path","required":true,"description":"14 caracteres; pontos, hífen e a barra (codificada como %2F ou omitida) são aceitos. Desde julho de 2026 os 12 primeiros podem ser letras (CNPJ alfanumérico).","schema":{"type":"string"},"example":"33000167000101"}],"responses":{"200":{"description":"Os nomes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyName"}}}},"400":{"description":"Formato inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Sem chave, ou chave inválida, revogada ou pausada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"CNPJ que não está na base","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cep/{cep}":{"servers":[{"url":"https://ceps.apizen.com.br/v1"}],"get":{"operationId":"consultarCep","summary":"Endereço de um CEP","description":"Logradouro, bairro, município com código IBGE, UF e coordenadas.","tags":["CEP"],"parameters":[{"name":"cep","in":"path","required":true,"description":"8 dígitos, com ou sem hífen","schema":{"type":"string"},"example":"01001000"}],"responses":{"200":{"description":"O CEP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cep"}}}},"400":{"description":"Formato inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Sem chave, ou chave inválida, revogada ou pausada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"CEP que não está na base","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A chave da API (sk_cnpj_… ou sk_ceps_…), criada no painel."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Code":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":["string","null"]}}},"Municipio":{"type":"object","properties":{"codigo_ibge":{"type":["string","null"]},"nome":{"type":["string","null"]}}},"CompanyName":{"type":"object","properties":{"cnpj":{"type":"string"},"razao_social":{"type":["string","null"]},"nome_fantasia":{"type":["string","null"]}}},"Cnpj":{"type":"object","properties":{"cnpj":{"type":"string"},"razao_social":{"type":["string","null"]},"nome_fantasia":{"type":["string","null"]},"matriz":{"type":"boolean"},"ativa":{"type":"boolean"},"situacao":{"$ref":"#/components/schemas/Code","description":"01 Nula, 02 Ativa, 03 Suspensa, 04 Inapta, 08 Baixada"},"data_situacao":{"type":["string","null"],"format":"date"},"data_inicio_atividade":{"type":["string","null"],"format":"date"},"simples":{"type":["boolean","null"]},"mei":{"type":["boolean","null"]},"cnae":{"oneOf":[{"$ref":"#/components/schemas/Code"},{"type":"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":{"$ref":"#/components/schemas/Municipio"},"uf":{"type":["string","null"]}}},"telefone":{"type":["string","null"]},"email":{"type":["string","null"]}}},"Cep":{"type":"object","properties":{"cep":{"type":"string"},"logradouro":{"type":["string","null"]},"bairro":{"type":["string","null"]},"municipio":{"$ref":"#/components/schemas/Municipio"},"uf":{"type":["string","null"]},"localizacao":{"oneOf":[{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},{"type":"null"}]},"enderecos":{"type":["integer","null"]},"estabelecimentos":{"type":["integer","null"]},"fonte":{"type":"string","enum":["cnefe","receita","cnefe+receita"]}}}}}}