{"openapi":"3.1.0","info":{"title":"CNPJ API (Receita Federal)","description":"API REST para consultar **CNPJ** a partir da **base pública da Receita Federal do Brasil**.\n\n- Fonte: dados abertos (dados.gov.br — Cadastro Nacional da Pessoa Jurídica)\n- Campos conforme o plano (Essencial / Comercial / Completo)\n- Autenticação: `Authorization: Bearer <token>` (compra no site; WhatsApp só suporte)\n- Saúde da base: `GET /health` (público)\n- Texto para modelos: https://cnpjapi.site/llms.txt\n\nNão é o órgão Receita Federal; não substitui certidão oficial.","contact":{"name":"CNPJ API","url":"https://wa.me/5548998590584?text=Ol%C3%A1%21%20Preciso%20de%20suporte%20na%20CNPJ%20API."},"license":{"name":"Dados públicos da Receita Federal do Brasil","url":"https://dados.gov.br/dados/conjuntos-dados/cadastro-nacional-da-pessoa-juridica---cnpj"},"version":"1.0.0"},"servers":[{"url":"https://cnpjapi.site","description":"Produção"}],"paths":{"/health":{"get":{"tags":["health"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/cnpj/{cnpj}":{"get":{"tags":["cnpj"],"summary":"Consultar um CNPJ","operationId":"consultar_cnpj_v1_cnpj__cnpj__get","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","title":"Cnpj"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Campos liberados pelo plano do token + competência ativa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CnpjResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/version":{"get":{"tags":["health"],"summary":"Version","operationId":"version_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Version Version Get"}}}}}}}},"components":{"schemas":{"CnpjResponse":{"properties":{"cnpj":{"type":"string","title":"Cnpj","description":"CNPJ completo com 14 caracteres, sem máscara"},"situacao_cadastral":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"cnae_principal":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"porte":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"situacao_simples":{"$ref":"#/components/schemas/SituacaoSimples"},"competencia":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competencia","description":"Competência YYYY-MM da base da Receita Federal em uso","examples":["2026-08"]},"razao_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Razao Social","description":"Plano Comercial ou Completo"},"nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nome Fantasia","description":"Plano Comercial ou Completo"},"natureza_juridica":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}],"description":"Plano Comercial ou Completo"},"capital_social":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Capital Social","description":"Plano Comercial ou Completo"},"identificador_matriz_filial":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}],"description":"Plano Comercial ou Completo"},"data_inicio_atividade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Inicio Atividade","description":"Plano Completo"},"endereco":{"anyOf":[{"$ref":"#/components/schemas/Endereco"},{"type":"null"}],"description":"Plano Completo"},"telefone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefone","description":"Plano Completo"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Plano Completo"}},"type":"object","required":["cnpj","situacao_simples"],"title":"CnpjResponse"},"CodigoDescricao":{"properties":{"codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo","description":"Código na tabela da Receita Federal"},"descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descricao","description":"Descrição oficial do código"}},"type":"object","title":"CodigoDescricao"},"Endereco":{"properties":{"tipo_logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Logradouro"},"logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logradouro"},"numero":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero"},"complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Complemento"},"bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bairro"},"cep":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cep"},"uf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uf"},"municipio":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]}},"type":"object","title":"Endereco"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SituacaoSimples":{"properties":{"optante_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Optante Simples","description":"True se a empresa é optante do Simples Nacional"},"optante_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Optante Mei","description":"True se a empresa é optante do MEI"}},"type":"object","title":"SituacaoSimples"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"cnpj","description":"Consulta autenticada de um CNPJ"},{"name":"health","description":"Competência ativa e status da base"}]}