{"openapi":"3.1.0","info":{"title":"apipj · API de CNPJ","version":"0.1.0","summary":"Consulta de CNPJ a partir dos dados abertos da Receita Federal","description":"Dados cadastrais de empresas brasileiras (razão social, situação cadastral, endereço, atividades CNAE, Simples/MEI e sócios) a partir dos dados abertos da Receita Federal, atualizados uma vez por mês. Suporte a CNPJ alfanumérico.\n\nRecorte público da API: consulta (com chave de API, conta grátis em https://apipj.com.br/criar-conta), validação, status e planos. Documentação completa em https://apipj.com.br/docs.","termsOfService":"https://apipj.com.br/termos","contact":{"name":"apipj","url":"https://apipj.com.br","email":"brunogalizzi@masterbi.com"}},"externalDocs":{"description":"Documentação da API","url":"https://apipj.com.br/docs"},"servers":[{"url":"https://apipj.com.br"}],"tags":[{"name":"Consulta","description":"Consulta de CNPJ (exige chave de API)"},{"name":"Público","description":"Sem autenticação e sem consumo de cota"}],"paths":{"/v1/status":{"get":{"operationId":"status","summary":"Status do serviço e da base","description":"Informa se o serviço está no ar, o mês do lote da Receita Federal carregado e a quantidade de CNPJs. Aberta, sem chave e sem consumo de cota.","tags":["Público"],"security":[],"responses":{"200":{"description":"Status do serviço","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"},"examples":{"Status":{"$ref":"#/components/examples/Status"}}}}},"429":{"$ref":"#/components/responses/LimiteIp"}}}},"/v1/valida/{cnpj}":{"get":{"operationId":"validarCnpj","summary":"Validar formato e dígitos verificadores de um CNPJ","description":"Confere formato e dígitos verificadores (inclusive CNPJ alfanumérico, IN RFB 2.229/2024) sem consultar a base. Aberta, sem chave e sem consumo de cota; limite de 60 requisições por minuto por IP.","tags":["Público"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":32},"in":"path","name":"cnpj","required":true,"description":"CNPJ com ou sem pontuação (numérico ou alfanumérico)","example":"11378117000120"}],"security":[],"responses":{"200":{"description":"Resultado da validação (inválido também responde 200, com `valido: false`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validacao"},"examples":{"ValidacaoOk":{"$ref":"#/components/examples/ValidacaoOk"},"ValidacaoAlfanumerico":{"$ref":"#/components/examples/ValidacaoAlfanumerico"},"ValidacaoInvalido":{"$ref":"#/components/examples/ValidacaoInvalido"}}}}},"429":{"$ref":"#/components/responses/LimiteIp"}}}},"/v1/cnpj/{cnpj}":{"get":{"operationId":"consultarCnpj","summary":"Consultar os dados cadastrais de um CNPJ","description":"Devolve o documento cadastral de um CNPJ a partir dos dados abertos da Receita Federal (atualizados uma vez por mês; o campo `atualizado_em` traz o mês do lote). Exige chave de API: `Authorization: Bearer apipj_live_...` (conta grátis em /criar-conta). Cada consulta respondida, inclusive 404, conta 1 na cota mensal do plano; também vale um limite por minuto por chave. Formato `completo` (padrão: objetos aninhados, datas ISO e códigos da Receita) ou `simplificado` (formato plano com campos já formatados). Aceita CNPJ numérico ou alfanumérico, com ou sem pontuação.","tags":["Consulta"],"parameters":[{"schema":{"type":"string","enum":["completo","simplificado"],"default":"completo"},"in":"query","name":"formato","required":false,"description":"Formato da resposta: `completo` (padrão: documento estruturado, com códigos e descrições) ou `simplificado` (formato plano para integrações que preferem campos já formatados: datas DD/MM/AAAA, CNPJ, CEP e telefone com máscara)"},{"schema":{"type":"string","minLength":1,"maxLength":32},"in":"path","name":"cnpj","required":true,"description":"CNPJ com ou sem pontuação (numérico ou alfanumérico)","example":"11378117000120"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Documento cadastral do CNPJ","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DocumentoCompleto"},{"$ref":"#/components/schemas/DocumentoSimplificado"}]},"examples":{"DocumentoCompleto":{"$ref":"#/components/examples/DocumentoCompleto"},"DocumentoSimplificado":{"$ref":"#/components/examples/DocumentoSimplificado"}}}}},"400":{"$ref":"#/components/responses/CnpjInvalido"},"401":{"$ref":"#/components/responses/NaoAutorizado"},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/LimiteConsulta"},"503":{"$ref":"#/components/responses/BaseIndisponivel"}}}},"/v1/busca":{"get":{"operationId":"buscarCnpjs","summary":"Buscar CNPJs ativos por atividade (CNAE) e município","description":"Lista estabelecimentos ativos pela atividade econômica principal (`cnae`, 7 dígitos, com ou sem pontuação) e/ou pelo município (`municipio`: código da Receita com 4 dígitos ou do IBGE com 7); pelo menos um dos dois filtros. Exige chave de API. Cada CNPJ devolvido conta 1 na cota mensal e 1 no limite por minuto do plano; a página tem no máximo o limite por minuto do plano (ou `limite`, até esse valor; teto de 1000) e é cortada pelo saldo do minuto e da cota. Paginação por cursor: envie `proximo_cursor` como `cursor` (mesmos filtros); `null` indica o fim. `total` é o número exato de estabelecimentos do filtro. Cada resultado tem o mesmo documento da consulta individual, no formato pedido, sem o quadro de sócios.","tags":["Consulta"],"parameters":[{"schema":{"type":"string","maxLength":20},"in":"query","name":"cnae","required":false,"description":"CNAE da atividade principal, 7 dígitos, com ou sem pontuação (4781400 ou 47.81-4-00)"},{"schema":{"type":"string","maxLength":20},"in":"query","name":"municipio","required":false,"description":"Município: código da Receita Federal (4 dígitos, o `endereco.municipio.codigo_rfb`) ou do IBGE (7 dígitos)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false,"description":"Valor de `proximo_cursor` da página anterior (mesmos filtros)"},{"schema":{"type":"string","enum":["completo","simplificado"],"default":"completo"},"in":"query","name":"formato","required":false,"description":"Formato de cada resultado, como em `/v1/cnpj` (sem os sócios)"},{"schema":{"type":"integer","minimum":1},"in":"query","name":"limite","required":false,"description":"Tamanho máximo da página, de 1 até o limite por minuto do plano (padrão: esse limite)"}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Página de resultados","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuscaResultado"},"examples":{"BuscaResultado":{"$ref":"#/components/examples/BuscaResultado"}}}}},"400":{"$ref":"#/components/responses/BuscaInvalida"},"401":{"$ref":"#/components/responses/NaoAutorizado"},"429":{"$ref":"#/components/responses/LimiteBusca"},"503":{"$ref":"#/components/responses/BuscaIndisponivel"}}}},"/v1/plans":{"get":{"operationId":"planos","summary":"Planos e limites","description":"Planos públicos com preço mensal (BRL), consultas por minuto e cota mensal, e a disponibilidade das assinaturas. Aberta, sem chave.","tags":["Público"],"security":[],"responses":{"200":{"description":"Planos públicos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Planos"},"examples":{"Planos":{"$ref":"#/components/examples/Planos"}}}}},"429":{"$ref":"#/components/responses/LimiteIp"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"apipj_live_...","description":"Chave de API no cabeçalho `Authorization: Bearer apipj_live_...` (crie no painel; conta grátis)."}},"schemas":{"Erro":{"type":"object","description":"Corpo padrão de erro. Alguns códigos trazem campos extras (`retry_after`, `upgrade_url`, `reset`, `cnpj`, `details`).","required":["status","message","code"],"properties":{"status":{"const":"ERROR"},"message":{"type":"string","description":"Mensagem em português"},"code":{"type":"string","description":"Código estável em snake_case","examples":["invalid_cnpj","unauthorized","not_found","rate_limited","quota_exceeded","validation_error","dataset_unavailable","cursor_invalido","busca_indisponivel","busca_em_breve"]},"retry_after":{"type":"integer","description":"Só em `rate_limited`: segundos a esperar"},"upgrade_url":{"type":"string","description":"Só em `quota_exceeded`: página de planos","format":"uri"},"reset":{"type":"integer","description":"Só em `quota_exceeded`: epoch Unix (segundos) em que a cota zera"},"cnpj":{"type":"string","description":"Só em `invalid_cnpj`: a entrada normalizada"},"details":{"type":"array","description":"Só em `validation_error`","items":{"type":"object","properties":{"campo":{"type":"string"},"erro":{"type":"string"}}}},"disponivel_a_partir_de":{"type":"string","description":"Só em `busca_em_breve`: data de início da busca (AAAA-MM-DD)","format":"date"}}},"BuscaResultado":{"type":"object","description":"Página da busca por atividade e município.","required":["dataset_month","total","resultados","proximo_cursor"],"properties":{"dataset_month":{"type":"string","description":"Mês do lote da Receita Federal (AAAA-MM)"},"total":{"type":"integer","description":"Estabelecimentos ativos do filtro (todas as páginas)"},"resultados":{"type":"array","description":"Documentos no formato pedido, sem sócios (`socios`/`qsa`)","items":{"anyOf":[{"$ref":"#/components/schemas/DocumentoCompleto"},{"$ref":"#/components/schemas/DocumentoSimplificado"}]}},"proximo_cursor":{"type":["string","null"],"description":"Cursor opaco da próxima página; null no fim"}}},"CodigoDescricao":{"type":"object","properties":{"codigo":{"type":["string","null"],"description":"Código da Receita Federal"},"descricao":{"type":["string","null"],"description":"Descrição"}}},"Telefone":{"type":"object","properties":{"ddd":{"type":["string","null"],"description":"DDD"},"numero":{"type":["string","null"],"description":"Número, só dígitos"}}},"OpcaoRegime":{"type":"object","properties":{"optante":{"type":"boolean"},"data_opcao":{"type":["string","null"],"description":"Data da opção (AAAA-MM-DD)","format":"date"},"data_exclusao":{"type":["string","null"],"description":"Data da exclusão (AAAA-MM-DD)","format":"date"}}},"Socio":{"type":"object","properties":{"nome":{"type":["string","null"],"description":"Nome do sócio"},"tipo":{"type":["string","null"],"description":"PESSOA FISICA, PESSOA JURIDICA ou ESTRANGEIRO"},"cpf_cnpj":{"type":["string","null"],"description":"CPF já mascarado pela Receita (***123456**) ou raiz de 8 caracteres do CNPJ do sócio pessoa jurídica"},"qualificacao":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"data_entrada":{"type":["string","null"],"description":"Entrada na sociedade (AAAA-MM-DD)","format":"date"},"faixa_etaria":{"type":["string","null"],"description":"Faixa etária"},"pais":{"type":["string","null"],"description":"País (sócio estrangeiro)"},"representante_legal":{"anyOf":[{"type":"object","properties":{"cpf":{"type":["string","null"],"description":"CPF mascarado"},"nome":{"type":["string","null"],"description":"Nome"},"qualificacao":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]}}},{"type":"null"}]}}},"DocumentoCompleto":{"type":"object","description":"Formato `completo` (padrão). Campos ausentes na base da Receita vêm como `null`; nenhuma chave some.","required":["cnpj","cnpj_formatado","razao_social","situacao_cadastral","atualizado_em"],"properties":{"cnpj":{"type":"string","description":"14 caracteres, sem pontuação"},"cnpj_formatado":{"type":"string","description":"AA.AAA.AAA/AAAA-DD"},"razao_social":{"type":"string","description":"Razão social"},"nome_fantasia":{"type":["string","null"],"description":"Nome fantasia"},"matriz_filial":{"type":"string","description":"MATRIZ ou FILIAL"},"situacao_cadastral":{"type":"object","properties":{"codigo":{"type":["string","null"],"description":"Código"},"descricao":{"type":["string","null"],"description":"ATIVA, BAIXADA, INAPTA, SUSPENSA ou NULA"},"data":{"type":["string","null"],"description":"Data da situação (AAAA-MM-DD)","format":"date"},"motivo":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]}}},"situacao_especial":{"type":"object","properties":{"descricao":{"type":["string","null"],"description":"Situação especial"},"data":{"type":["string","null"],"description":"Data da situação especial (AAAA-MM-DD)","format":"date"}}},"data_inicio_atividade":{"type":["string","null"],"description":"Início da atividade (AAAA-MM-DD)","format":"date"},"natureza_juridica":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"qualificacao_responsavel":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"porte":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"capital_social":{"type":["number","null"],"description":"Capital social em reais"},"cnae_principal":{"anyOf":[{"$ref":"#/components/schemas/CodigoDescricao"},{"type":"null"}]},"cnaes_secundarios":{"type":"array","items":{"$ref":"#/components/schemas/CodigoDescricao"}},"endereco":{"type":"object","properties":{"tipo_logradouro":{"type":["string","null"],"description":"RUA, AVENIDA…"},"logradouro":{"type":["string","null"],"description":"Logradouro"},"numero":{"type":["string","null"],"description":"Número"},"complemento":{"type":["string","null"],"description":"Complemento"},"bairro":{"type":["string","null"],"description":"Bairro"},"cep":{"type":["string","null"],"description":"CEP, só dígitos"},"municipio":{"type":"object","properties":{"codigo_rfb":{"type":["string","null"],"description":"Código do município na Receita"},"codigo_ibge":{"type":["string","null"],"description":"Código IBGE (7 dígitos)"},"nome":{"type":["string","null"],"description":"Nome"}}},"uf":{"type":["string","null"],"description":"UF"},"pais":{"type":["string","null"],"description":"País (endereço no exterior)"},"cidade_exterior":{"type":["string","null"],"description":"Cidade no exterior"}}},"telefones":{"type":"array","items":{"$ref":"#/components/schemas/Telefone"}},"fax":{"anyOf":[{"$ref":"#/components/schemas/Telefone"},{"type":"null"}]},"email":{"type":["string","null"],"description":"E-mail informado à Receita"},"ente_federativo_responsavel":{"type":["string","null"],"description":"Ente federativo responsável (administração pública)"},"simples":{"$ref":"#/components/schemas/OpcaoRegime"},"mei":{"$ref":"#/components/schemas/OpcaoRegime"},"socios":{"type":"array","items":{"$ref":"#/components/schemas/Socio"}},"atualizado_em":{"type":"string","description":"Mês do lote da Receita Federal (AAAA-MM)"}}},"DocumentoSimplificado":{"type":"object","description":"Formato `simplificado`: plano, com datas DD/MM/AAAA, CNPJ, CEP e telefone já formatados e vazios como \"\".","properties":{"abertura":{"type":"string"},"situacao":{"type":"string"},"tipo":{"type":"string"},"nome":{"type":"string"},"fantasia":{"type":"string"},"porte":{"type":"string"},"natureza_juridica":{"type":"string"},"atividade_principal":{"type":"array"},"atividades_secundarias":{"type":"array"},"qsa":{"type":"array"},"logradouro":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"municipio":{"type":"string"},"bairro":{"type":"string"},"uf":{"type":"string"},"cep":{"type":"string"},"email":{"type":"string"},"telefone":{"type":"string"},"data_situacao":{"type":"string"},"cnpj":{"type":"string"},"ultima_atualizacao":{"type":"string"},"status":{"type":"string"},"efr":{"type":"string"},"motivo_situacao":{"type":"string"},"situacao_especial":{"type":"string"},"data_situacao_especial":{"type":"string"},"capital_social":{"type":"string"},"simples":{"type":"object"},"simei":{"type":"object"},"extra":{"type":"object"},"billing":{"type":"object"}}},"Validacao":{"type":"object","required":["cnpj","valido","formatado","alfanumerico","erro"],"properties":{"cnpj":{"type":"string","description":"Entrada normalizada (sem pontuação, maiúsculas)"},"valido":{"type":"boolean"},"formatado":{"type":["string","null"],"description":"AA.AAA.AAA/AAAA-DD quando válido"},"alfanumerico":{"type":"boolean","description":"true se a raiz ou a ordem têm letras"},"erro":{"type":["string","null"],"description":"Motivo quando inválido"}}},"Status":{"type":"object","required":["status","dataset_month","rows","version","time"],"properties":{"status":{"type":"string","enum":["OK","DEGRADED"],"description":"DEGRADED: base indisponível (a consulta responde 503)"},"dataset_month":{"type":["string","null"],"description":"Mês do lote da Receita Federal (AAAA-MM)"},"dataset_generated_at":{"type":["string","null"],"description":"Quando a base foi gerada (ISO 8601)","format":"date-time"},"rows":{"type":["integer","null"],"description":"Quantidade de CNPJs na base"},"version":{"type":"string","description":"Versão da API"},"time":{"type":"string","description":"Hora do servidor (ISO 8601)","format":"date-time"}}},"Planos":{"type":"object","properties":{"tos_version":{"type":"string","description":"Versão vigente dos termos de uso"},"currency":{"type":"string","description":"Moeda dos preços"},"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador"},"name":{"type":"string","description":"Nome"},"price":{"type":"number","description":"Preço mensal"},"rpm":{"type":"integer","description":"Consultas por minuto"},"monthly_quota":{"type":"integer","description":"Consultas por mês"},"description":{"type":["string","null"],"description":"Descrição"}}}},"billing":{"type":"object","properties":{"provider":{"type":"string","description":"Processador de pagamento"},"test_mode":{"type":"boolean"},"available":{"type":"boolean","description":"Assinaturas abertas"},"requires_document":{"type":"boolean","description":"Checkout pede CPF/CNPJ"}}}}}},"responses":{"CnpjInvalido":{"description":"CNPJ inválido (`invalid_cnpj`) ou parâmetro fora do contrato (`validation_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroCnpjInvalido":{"$ref":"#/components/examples/ErroCnpjInvalido"},"ErroFormatoInvalido":{"$ref":"#/components/examples/ErroFormatoInvalido"}}}}},"NaoAutorizado":{"description":"Sem chave de API, ou chave inválida ou revogada (`unauthorized`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroSemChave":{"$ref":"#/components/examples/ErroSemChave"},"ErroChaveInvalida":{"$ref":"#/components/examples/ErroChaveInvalida"}}}}},"NaoEncontrado":{"description":"CNPJ válido, mas ausente da base da Receita Federal (`not_found`)","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroNaoEncontrado":{"$ref":"#/components/examples/ErroNaoEncontrado"}}}}},"LimiteConsulta":{"description":"Limite por minuto (`rate_limited`, com `Retry-After`) ou cota mensal (`quota_exceeded`, com `upgrade_url`) excedidos","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroLimitePorMinuto":{"$ref":"#/components/examples/ErroLimitePorMinuto"},"ErroCotaEsgotada":{"$ref":"#/components/examples/ErroCotaEsgotada"}}}}},"LimiteIp":{"description":"Limite de requisições por minuto por IP excedido (`rate_limited`)","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroLimiteIp":{"$ref":"#/components/examples/ErroLimiteIp"}}}}},"BaseIndisponivel":{"description":"Base de CNPJ indisponível no momento (`dataset_unavailable`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroBaseIndisponivel":{"$ref":"#/components/examples/ErroBaseIndisponivel"}}}}},"BuscaInvalida":{"description":"Filtro ausente ou inválido (`validation_error`) ou cursor de outra busca, de outro mês da base ou malformado (`cursor_invalido`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroBuscaSemFiltro":{"$ref":"#/components/examples/ErroBuscaSemFiltro"},"ErroCursorInvalido":{"$ref":"#/components/examples/ErroCursorInvalido"}}}}},"LimiteBusca":{"description":"Limite por minuto (`rate_limited`, com `Retry-After`) ou cota mensal (`quota_exceeded`, com `upgrade_url`) zerados","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroLimitePorMinuto":{"$ref":"#/components/examples/ErroLimitePorMinuto"},"ErroBuscaCotaEsgotada":{"$ref":"#/components/examples/ErroBuscaCotaEsgotada"}}}}},"BuscaIndisponivel":{"description":"Índice da busca indisponível (`busca_indisponivel`) ou busca ainda não vigente (`busca_em_breve`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"examples":{"ErroBuscaIndisponivel":{"$ref":"#/components/examples/ErroBuscaIndisponivel"},"ErroBuscaEmBreve":{"$ref":"#/components/examples/ErroBuscaEmBreve"}}}}}},"headers":{"X-RateLimit-Limit":{"description":"Consultas permitidas por minuto (por chave)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Quantas ainda cabem neste minuto","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Segundos até o limite por minuto zerar","schema":{"type":"integer"}},"X-Quota-Limit":{"description":"Cota mensal da conta","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Quanto resta da cota","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"Epoch Unix (segundos) em que a cota zera: início do próximo mês, horário de Brasília","schema":{"type":"integer"}},"Retry-After":{"description":"Segundos a esperar antes de tentar de novo","schema":{"type":"integer"}}},"examples":{"DocumentoCompleto":{"summary":"Formato completo (padrão)","value":{"cnpj":"11378117000120","cnpj_formatado":"11.378.117/0001-20","razao_social":"LEADS2B S/A","nome_fantasia":"LEADS2B.COM","matriz_filial":"MATRIZ","situacao_cadastral":{"codigo":"02","descricao":"ATIVA","data":"2009-11-24","motivo":{"codigo":"00","descricao":"SEM MOTIVO"}},"situacao_especial":{"descricao":null,"data":null},"data_inicio_atividade":"2009-11-24","natureza_juridica":{"codigo":"2054","descricao":"Sociedade Anônima Fechada"},"qualificacao_responsavel":{"codigo":"10","descricao":"Diretor"},"porte":{"codigo":"05","descricao":"DEMAIS"},"capital_social":218878,"cnae_principal":{"codigo":"6311900","descricao":"Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"},"cnaes_secundarios":[{"codigo":"8599604","descricao":"Treinamento em desenvolvimento profissional e gerencial"},{"codigo":"6201501","descricao":"Desenvolvimento de programas de computador sob encomenda"}],"endereco":{"tipo_logradouro":"RUA","logradouro":"PADRE ANCHIETA","numero":"2285","complemento":"CONJ 1603 ANDAR 16 COND MADISON BUSINESS","bairro":"BIGORRILHO","cep":"80730001","municipio":{"codigo_rfb":"7535","codigo_ibge":"4106902","nome":"CURITIBA"},"uf":"PR","pais":null,"cidade_exterior":null},"telefones":[{"ddd":"41","numero":"30287828"},{"ddd":"41","numero":"988048211"}],"fax":null,"email":"contabilidade@leads2b.com","ente_federativo_responsavel":null,"simples":{"optante":false,"data_opcao":"2009-11-24","data_exclusao":"2019-12-31"},"mei":{"optante":false,"data_opcao":null,"data_exclusao":null},"socios":[{"nome":"FULANO DE TAL","tipo":"PESSOA FISICA","cpf_cnpj":"***123456**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2009-11-24","faixa_etaria":"41 a 50 anos","pais":null,"representante_legal":null},{"nome":"BELTRANA DA SILVA","tipo":"PESSOA FISICA","cpf_cnpj":"***654321**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2015-03-02","faixa_etaria":"31 a 40 anos","pais":null,"representante_legal":null}],"atualizado_em":"2026-09"}},"DocumentoSimplificado":{"summary":"Formato simplificado (formato=simplificado)","value":{"abertura":"24/11/2009","situacao":"ATIVA","tipo":"MATRIZ","nome":"LEADS2B S/A","fantasia":"LEADS2B.COM","porte":"DEMAIS","natureza_juridica":"205-4 - Sociedade Anônima Fechada","atividade_principal":[{"code":"63.11-9-00","text":"Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"}],"atividades_secundarias":[{"code":"85.99-6-04","text":"Treinamento em desenvolvimento profissional e gerencial"},{"code":"62.01-5-01","text":"Desenvolvimento de programas de computador sob encomenda"}],"qsa":[{"nome":"FULANO DE TAL","qual":"10-Diretor","pais_origem":"","nome_rep_legal":"","qual_rep_legal":""},{"nome":"BELTRANA DA SILVA","qual":"10-Diretor","pais_origem":"","nome_rep_legal":"","qual_rep_legal":""}],"logradouro":"RUA PADRE ANCHIETA","numero":"2285","complemento":"CONJ 1603 ANDAR 16 COND MADISON BUSINESS","municipio":"CURITIBA","bairro":"BIGORRILHO","uf":"PR","cep":"80.730-001","email":"contabilidade@leads2b.com","telefone":"(41) 3028-7828 / (41) 98804-8211","data_situacao":"24/11/2009","cnpj":"11.378.117/0001-20","ultima_atualizacao":"2026-10-01T00:00:00.000Z","status":"OK","efr":"","motivo_situacao":"","situacao_especial":"","data_situacao_especial":"","capital_social":"218878.00","simples":{"optante":false,"data_opcao":"24/11/2009","data_exclusao":"31/12/2019","ultima_atualizacao":"2026-10-01T00:00:00.000Z"},"simei":{"optante":false,"data_opcao":null,"data_exclusao":null,"ultima_atualizacao":"2026-10-01T00:00:00.000Z"},"extra":{},"billing":{"free":true,"database":true}}},"ValidacaoOk":{"summary":"CNPJ válido","value":{"cnpj":"11378117000120","valido":true,"formatado":"11.378.117/0001-20","alfanumerico":false,"erro":null}},"ValidacaoAlfanumerico":{"summary":"CNPJ alfanumérico válido","value":{"cnpj":"12ABC34501DE35","valido":true,"formatado":"12.ABC.345/01DE-35","alfanumerico":true,"erro":null}},"ValidacaoInvalido":{"summary":"Dígitos verificadores errados","value":{"cnpj":"11378117000121","valido":false,"formatado":null,"alfanumerico":false,"erro":"Dígitos verificadores inválidos"}},"Status":{"summary":"Serviço no ar","value":{"status":"OK","dataset_month":"2026-09","dataset_generated_at":"2026-10-09T20:31:43.201Z","rows":73366147,"version":"0.1.0","time":"2026-10-13T12:00:00.000Z"}},"Planos":{"summary":"Planos públicos","value":{"tos_version":"2026-10-10","currency":"BRL","plans":[{"id":"free","name":"Gratuito","price":0,"rpm":10,"monthly_quota":50000,"description":"Chave gratuita: 10 consultas por minuto e 50.000 por mês."},{"id":"dev","name":"Dev","price":12.9,"rpm":30,"monthly_quota":200000,"description":"30 consultas por minuto e 200.000 por mês."},{"id":"pro","name":"Pro","price":59.9,"rpm":200,"monthly_quota":600000,"description":"200 consultas por minuto e 600.000 por mês."}],"billing":{"provider":"stripe","test_mode":false,"available":true,"requires_document":false}}},"ErroCnpjInvalido":{"summary":"CNPJ inválido","value":{"status":"ERROR","message":"Dígitos verificadores inválidos","code":"invalid_cnpj","cnpj":"11378117000121"}},"ErroFormatoInvalido":{"summary":"Valor de formato fora da lista","value":{"status":"ERROR","message":"Dados inválidos: formato deve ser um de: completo, simplificado","code":"validation_error","details":[{"campo":"formato","erro":"deve ser um de: completo, simplificado"}]}},"ErroSemChave":{"summary":"Sem chave de API","value":{"status":"ERROR","message":"Crie uma conta grátis para consultar","code":"unauthorized"}},"ErroChaveInvalida":{"summary":"Chave inválida ou revogada","value":{"status":"ERROR","message":"Chave de API inválida ou revogada","code":"unauthorized"}},"ErroNaoEncontrado":{"summary":"CNPJ válido, ausente da base","value":{"status":"ERROR","message":"CNPJ não encontrado","code":"not_found"}},"ErroLimitePorMinuto":{"summary":"Limite por minuto do plano excedido","value":{"status":"ERROR","message":"Limite de consultas por minuto excedido","code":"rate_limited","retry_after":4}},"ErroCotaEsgotada":{"summary":"Cota mensal esgotada","value":{"status":"ERROR","message":"Cota mensal esgotada","code":"quota_exceeded","upgrade_url":"https://apipj.com.br/precos","reset":1793502000}},"ErroLimiteIp":{"summary":"Limite por IP excedido","value":{"status":"ERROR","message":"Limite de requisições por minuto excedido","code":"rate_limited","retry_after":1}},"ErroBaseIndisponivel":{"summary":"Base indisponível","value":{"status":"ERROR","message":"Base de CNPJ indisponível no momento","code":"dataset_unavailable"}},"BuscaResultado":{"summary":"Busca por município (municipio=9701), página única","value":{"dataset_month":"2026-09","total":2,"resultados":[{"cnpj":"34028316000103","cnpj_formatado":"34.028.316/0001-03","razao_social":"EMPRESA BRASILEIRA DE CORREIOS E TELEGRAFOS","nome_fantasia":"CORREIOS","matriz_filial":"MATRIZ","situacao_cadastral":{"codigo":"02","descricao":"ATIVA","data":"2005-11-03","motivo":{"codigo":"00","descricao":"SEM MOTIVO"}},"situacao_especial":{"descricao":null,"data":null},"data_inicio_atividade":"1969-03-20","natureza_juridica":{"codigo":"2011","descricao":"Empresa Pública"},"qualificacao_responsavel":{"codigo":"16","descricao":"Presidente"},"porte":{"codigo":"05","descricao":"DEMAIS"},"capital_social":3399000000,"cnae_principal":{"codigo":"5310501","descricao":"Atividades do Correio Nacional"},"cnaes_secundarios":[{"codigo":"5320201","descricao":"Serviços de malote não realizados pelo Correio Nacional"}],"endereco":{"tipo_logradouro":"SETOR","logradouro":"SBN QUADRA 1 BLOCO A","numero":"S/N","complemento":"EDIFICIO SEDE","bairro":"ASA NORTE","cep":"70002900","municipio":{"codigo_rfb":"9701","codigo_ibge":"5300108","nome":"BRASILIA"},"uf":"DF","pais":null,"cidade_exterior":null},"telefones":[{"ddd":"61","numero":"34264000"}],"fax":null,"email":null,"ente_federativo_responsavel":"UNIAO","simples":{"optante":false,"data_opcao":null,"data_exclusao":null},"mei":{"optante":false,"data_opcao":null,"data_exclusao":null},"atualizado_em":"2026-09"},{"cnpj":"00000000000191","cnpj_formatado":"00.000.000/0001-91","razao_social":"BANCO DO BRASIL SA","nome_fantasia":"DIRECAO GERAL","matriz_filial":"MATRIZ","situacao_cadastral":{"codigo":"02","descricao":"ATIVA","data":"2005-11-03","motivo":{"codigo":"00","descricao":"SEM MOTIVO"}},"situacao_especial":{"descricao":null,"data":null},"data_inicio_atividade":"1966-08-01","natureza_juridica":{"codigo":"2038","descricao":"Sociedade de Economia Mista"},"qualificacao_responsavel":{"codigo":"10","descricao":"Diretor"},"porte":{"codigo":"05","descricao":"DEMAIS"},"capital_social":120000000000,"cnae_principal":{"codigo":"6421200","descricao":"Bancos comerciais"},"cnaes_secundarios":[],"endereco":{"tipo_logradouro":"QUADRA","logradouro":"SAUN QUADRA 5 LOTE B TORRES I, II E III","numero":"S/N","complemento":"ANDAR 1 A 16 SALA 101 A 1601","bairro":"ASA NORTE","cep":"70040912","municipio":{"codigo_rfb":"9701","codigo_ibge":"5300108","nome":"BRASILIA"},"uf":"DF","pais":null,"cidade_exterior":null},"telefones":[{"ddd":"61","numero":"34939002"}],"fax":null,"email":"secretaria.executiva@bb.com.br","ente_federativo_responsavel":null,"simples":{"optante":false,"data_opcao":null,"data_exclusao":null},"mei":{"optante":false,"data_opcao":null,"data_exclusao":null},"atualizado_em":"2026-09"}],"proximo_cursor":null}},"ErroBuscaSemFiltro":{"summary":"Nenhum filtro informado","value":{"status":"ERROR","message":"Dados inválidos: cnae ou municipio: informe pelo menos um dos filtros","code":"validation_error","details":[{"campo":"cnae","erro":"ou municipio: informe pelo menos um dos filtros"}]}},"ErroCursorInvalido":{"summary":"Cursor de outra busca","value":{"status":"ERROR","message":"Cursor de outra busca: os filtros (cnae e municipio) precisam ser os mesmos da página anterior","code":"cursor_invalido"}},"ErroBuscaCotaEsgotada":{"summary":"Cota mensal esgotada (com checkout do próximo plano)","value":{"status":"ERROR","message":"Cota mensal esgotada","code":"quota_exceeded","upgrade_url":"https://apipj.com.br/painel?assinar=dev","reset":1793502000}},"ErroBuscaIndisponivel":{"summary":"Índice da busca em atualização","value":{"status":"ERROR","message":"Busca por atividade e município indisponível no momento (índice em atualização); tente novamente mais tarde. A consulta de CNPJ individual continua funcionando.","code":"busca_indisponivel"}},"ErroBuscaEmBreve":{"summary":"Antes do início da busca","value":{"status":"ERROR","message":"Busca por atividade e município disponível a partir de 28/10/2026","code":"busca_em_breve","disponivel_a_partir_de":"2026-10-28"}}}}}