{"openapi":"3.1.0","info":{"title":"cnpj.ai — API pública","description":"API gratuita de dados cadastrais. Crie sua chave na Conta em https://cnpj.ai/conta. Guia: https://cnpj.ai/api. O limite é compartilhado por todas as chaves da conta.","version":"1.0.1"},"paths":{"/v1/cnpj/{cnpj}":{"get":{"tags":["Consulta de CNPJ"],"summary":"Consultar cadastro da empresa","description":"Aceita CNPJ básico (8 posições) ou completo (14, com DV válido), sem máscara. Com 8 posições, estabelecimentos contém todos os estabelecimentos da raiz. Com 14, contém somente o estabelecimento solicitado; se não existir, retorna 404. Empresa, sócios e Simples/MEI são dados da empresa em ambos os casos. Datas ISO 8601; ausências de datas são null. Cada chamada admitida consome uma unidade, inclusive 400, 404 e falhas posteriores à admissão.","operationId":"consultar_v1_cnpj__cnpj__get","security":[{"ChaveAPI":[]}],"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","title":"Cnpj"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaCNPJ"}}}},"400":{"description":"CNPJ inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaErro"}}}},"401":{"description":"Chave inválida ou revogada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaErro"}}}},"404":{"description":"CNPJ não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaErro"}}}},"429":{"description":"Limite da conta excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaErro"}}}},"503":{"description":"Serviço indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaErro"}}}}}}}},"components":{"schemas":{"Codigo":{"properties":{"codigo":{"type":"string","title":"Codigo"},"descricao":{"type":"string","title":"Descricao"}},"type":"object","required":["codigo","descricao"],"title":"Codigo"},"Contato":{"properties":{"telefone1":{"type":"string","title":"Telefone1"},"telefone2":{"type":"string","title":"Telefone2"},"email":{"type":"string","title":"Email"}},"type":"object","required":["telefone1","telefone2","email"],"title":"Contato"},"DadosEmpresa":{"properties":{"cnpj_basico":{"type":"string","title":"Cnpj Basico"},"empresa":{"anyOf":[{"$ref":"#/components/schemas/Empresa"},{"type":"null"}]},"estabelecimentos":{"items":{"$ref":"#/components/schemas/Estabelecimento"},"type":"array","title":"Estabelecimentos"},"socios":{"items":{"$ref":"#/components/schemas/Socio"},"type":"array","title":"Socios"},"simples":{"anyOf":[{"$ref":"#/components/schemas/Simples"},{"type":"null"}]}},"type":"object","required":["cnpj_basico","empresa","estabelecimentos","socios","simples"],"title":"DadosEmpresa"},"DetalheErro":{"properties":{"codigo":{"type":"string","title":"Codigo"},"mensagem":{"type":"string","title":"Mensagem"}},"type":"object","required":["codigo","mensagem"],"title":"DetalheErro"},"Empresa":{"properties":{"razao_social":{"type":"string","title":"Razao Social"},"natureza_juridica":{"$ref":"#/components/schemas/Codigo"},"qualificacao_responsavel":{"$ref":"#/components/schemas/Codigo"},"capital_social":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Capital Social"},"porte":{"$ref":"#/components/schemas/Codigo"},"ente_federativo_responsavel":{"type":"string","title":"Ente Federativo Responsavel"}},"type":"object","required":["razao_social","natureza_juridica","qualificacao_responsavel","capital_social","porte","ente_federativo_responsavel"],"title":"Empresa"},"Endereco":{"properties":{"tipo_logradouro":{"type":"string","title":"Tipo Logradouro"},"logradouro":{"type":"string","title":"Logradouro"},"numero":{"type":"string","title":"Numero"},"complemento":{"type":"string","title":"Complemento"},"bairro":{"type":"string","title":"Bairro"},"cep":{"type":"string","title":"Cep"},"uf":{"type":"string","title":"Uf"},"municipio":{"type":"string","title":"Municipio"}},"type":"object","required":["tipo_logradouro","logradouro","numero","complemento","bairro","cep","uf","municipio"],"title":"Endereco"},"Estabelecimento":{"properties":{"cnpj":{"type":"string","title":"Cnpj"},"cnpj_ordem":{"type":"string","title":"Cnpj Ordem"},"matriz_filial":{"type":"string","title":"Matriz Filial"},"nome_fantasia":{"type":"string","title":"Nome Fantasia"},"situacao_cadastral":{"$ref":"#/components/schemas/Codigo"},"data_situacao_cadastral":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Situacao Cadastral"},"motivo_situacao_cadastral":{"$ref":"#/components/schemas/Codigo"},"data_inicio_atividade":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Inicio Atividade"},"cnae_principal":{"$ref":"#/components/schemas/Codigo"},"cnae_secundaria":{"items":{"$ref":"#/components/schemas/Codigo"},"type":"array","title":"Cnae Secundaria"},"endereco":{"$ref":"#/components/schemas/Endereco"},"contato":{"$ref":"#/components/schemas/Contato"}},"type":"object","required":["cnpj","cnpj_ordem","matriz_filial","nome_fantasia","situacao_cadastral","data_situacao_cadastral","motivo_situacao_cadastral","data_inicio_atividade","cnae_principal","cnae_secundaria","endereco","contato"],"title":"Estabelecimento"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Metadados":{"properties":{"versao":{"type":"string","title":"Versao","default":"v1"},"competencia":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competencia"},"requisicao_id":{"type":"string","format":"uuid","title":"Requisicao Id"}},"type":"object","required":["competencia","requisicao_id"],"title":"Metadados"},"Representante":{"properties":{"nome":{"type":"string","title":"Nome"},"qualificacao":{"$ref":"#/components/schemas/Codigo"}},"type":"object","required":["nome","qualificacao"],"title":"Representante"},"RespostaCNPJ":{"properties":{"dados":{"$ref":"#/components/schemas/DadosEmpresa"},"meta":{"$ref":"#/components/schemas/Metadados"}},"type":"object","required":["dados","meta"],"title":"RespostaCNPJ"},"RespostaErro":{"properties":{"erro":{"$ref":"#/components/schemas/DetalheErro"},"requisicao_id":{"type":"string","format":"uuid","title":"Requisicao Id"}},"type":"object","required":["erro","requisicao_id"],"title":"RespostaErro"},"Simples":{"properties":{"opcao_simples":{"type":"boolean","title":"Opcao Simples"},"data_opcao_simples":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Opcao Simples"},"data_exclusao_simples":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Exclusao Simples"},"opcao_mei":{"type":"boolean","title":"Opcao Mei"},"data_opcao_mei":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Opcao Mei"},"data_exclusao_mei":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Exclusao Mei"}},"type":"object","required":["opcao_simples","data_opcao_simples","data_exclusao_simples","opcao_mei","data_opcao_mei","data_exclusao_mei"],"title":"Simples"},"Socio":{"properties":{"nome":{"type":"string","title":"Nome"},"cpf_cnpj":{"type":"string","title":"Cpf Cnpj"},"tipo":{"type":"string","title":"Tipo"},"qualificacao":{"$ref":"#/components/schemas/Codigo"},"data_entrada":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Data Entrada"},"faixa_etaria":{"type":"string","title":"Faixa Etaria"},"representante_legal":{"anyOf":[{"$ref":"#/components/schemas/Representante"},{"type":"null"}]}},"type":"object","required":["nome","cpf_cnpj","tipo","qualificacao","data_entrada","faixa_etaria","representante_legal"],"title":"Socio"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ChaveAPI":{"type":"http","scheme":"bearer"}}}}