{ "info": { "name": "cnpj.ia.br API", "description": "Dados de empresas brasileiras por CNPJ: cadastro, contatos, sócios e regime tributário, com a data da base em toda resposta.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{api_key}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "https://api.cnpj.ia.br", "type": "string" }, { "key": "api_key", "value": "", "type": "string", "description": "Chave da conta, criada em app.cnpj.ia.br. Só no header Authorization; nunca em query string." } ], "item": [ { "name": "Consulta", "description": "Tudo sobre um CNPJ conhecido.", "item": [ { "name": "Consultar um CNPJ", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cnpjs/:cnpj?profile=basic", "host": [ "{{base_url}}" ], "path": [ "v1", "cnpjs", ":cnpj" ], "query": [ { "key": "profile", "value": "basic", "description": "`basic`: cadastro. `full`: cadastro + telefones, e-mails, site, sócios (sem CPF), regime tributário, faixa de funcionários e faixa de faturamento.", "disabled": true } ], "variable": [ { "key": "cnpj", "value": "00000000000191", "description": "CNPJ numérico ou alfanumérico, com ou sem pontuação." } ] }, "description": "Retorna o perfil `basic` (1 crédito) ou `full` (6 créditos) de uma empresa. Aceita CNPJ numérico ou alfanumérico, com ou sem pontuação." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"cnpj\": \"00000000000191\",\n \"raiz_cnpj\": \"00000000\",\n \"razao_social\": \"BANCO DO BRASIL SA\",\n \"nome_fantasia\": \"DIRECAO GERAL\",\n \"matriz_filial\": {\n \"codigo\": \"1\",\n \"descricao\": \"Matriz\"\n },\n \"n_filiais\": 4000,\n \"data_inicio_atividade\": \"1966-08-01\",\n \"situacao_cadastral\": {\n \"codigo\": \"02\",\n \"descricao\": \"Ativa\"\n },\n \"data_situacao_cadastral\": \"2005-11-03\",\n \"motivo_situacao_cadastral\": {\n \"codigo\": \"00\",\n \"descricao\": \"Sem motivo\"\n },\n \"situacao_especial\": null,\n \"data_situacao_especial\": null,\n \"natureza_juridica\": {\n \"codigo\": \"2038\",\n \"descricao\": \"Sociedade de Economia Mista\"\n },\n \"porte\": {\n \"codigo\": \"05\",\n \"descricao\": \"Demais\"\n },\n \"capital_social\": 120000000000,\n \"cnae_fiscal\": {\n \"codigo\": \"6422100\",\n \"descricao\": \"Bancos múltiplos, com carteira comercial\"\n },\n \"cnaes_secundarios\": [],\n \"endereco\": {\n \"tipo_logradouro\": \"Quadra\",\n \"logradouro\": \"SAUN QUADRA 5 LOTE B\",\n \"numero\": \"S/N\",\n \"complemento\": \"TORRES I, II E III\",\n \"bairro\": \"ASA NORTE\",\n \"cep\": \"70040912\",\n \"municipio\": \"Brasília\",\n \"codigo_municipio_ibge\": \"5300108\",\n \"codigo_municipio_siafi\": \"9701\",\n \"uf\": \"DF\"\n },\n \"simples\": {\n \"optante\": false,\n \"data_opcao\": null,\n \"data_exclusao\": null\n },\n \"mei\": {\n \"optante\": false,\n \"data_opcao\": null,\n \"data_exclusao\": null\n },\n \"has_email\": true,\n \"has_website\": true,\n \"has_phone\": true,\n \"has_mobile_phone\": false,\n \"telefones\": [\n {\n \"ddd\": \"61\",\n \"numero\": \"34939002\"\n }\n ],\n \"email\": \"exemplo@bb.com.br\",\n \"site\": \"https://www.bb.com.br\",\n \"contatos_extras\": [],\n \"socios\": [\n {\n \"nome\": \"NOME DO DIRIGENTE\",\n \"tipo\": {\n \"codigo\": \"2\",\n \"descricao\": \"Pessoa Física\"\n },\n \"qualificacao\": {\n \"codigo\": \"10\",\n \"descricao\": \"Diretor\"\n },\n \"data_entrada\": \"2025-01-01\",\n \"pais\": {\n \"codigo\": \"105\",\n \"descricao\": \"Brasil\"\n },\n \"faixa_etaria\": {\n \"codigo\": \"6\",\n \"descricao\": \"51 a 60 anos\"\n },\n \"representante\": null\n }\n ],\n \"faixa_faturamento\": {\n \"faixa\": \"Superior a R$4.800.000,00\",\n \"origem\": \"porte\"\n },\n \"faixa_funcionarios\": null,\n \"regime_tributario\": {\n \"regime\": \"Lucro Real\",\n \"ano\": 2025,\n \"escrituracoes\": [\n \"ECD\",\n \"ECF\"\n ]\n }\n },\n \"meta\": {\n \"request_id\": \"req_01J8ZK3Q9X\",\n \"profile\": \"full\",\n \"source\": \"rfb_open_data+oportunidados\",\n \"data_as_of\": \"2026-08-01\",\n \"suppressed\": false,\n \"credits_charged\": 6,\n \"credits_remaining\": 99994,\n \"credits_reset_at\": \"2026-10-01T00:00:00-03:00\"\n }\n}", "_postman_previewlanguage": "json" }, { "name": "400 Requisição inválida", "status": "Requisição inválida", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "401 Não autorizado", "status": "Não autorizado", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "402 Pagamento necessário", "status": "Pagamento necessário", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "403 Proibido", "status": "Proibido", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "404 Não encontrado", "status": "Não encontrado", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "429 Excesso de requisições", "status": "Excesso de requisições", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "503 Serviço indisponível", "status": "Serviço indisponível", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "504 Tempo esgotado", "status": "Tempo esgotado", "code": 504, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] } ] }, { "name": "Busca", "description": "Encontrar empresas por filtros.", "item": [ { "name": "Buscar empresas por filtros", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cnpjs?uf=&municipio=&cnae=&porte=ME&situacao=ATIVA&simples=&mei=&natureza=&capital_min=&capital_max=&abertura_de=&abertura_ate=&cursor=", "host": [ "{{base_url}}" ], "path": [ "v1", "cnpjs" ], "query": [ { "key": "uf", "value": "", "description": "Sigla da UF.", "disabled": true }, { "key": "municipio", "value": "", "description": "Código IBGE do município (7 dígitos).", "disabled": true }, { "key": "cnae", "value": "", "description": "CNAE fiscal, 7 dígitos ou prefixo (classe, grupo, divisão).", "disabled": true }, { "key": "porte", "value": "ME", "disabled": true }, { "key": "situacao", "value": "ATIVA", "disabled": true }, { "key": "simples", "value": "", "disabled": true }, { "key": "mei", "value": "", "disabled": true }, { "key": "natureza", "value": "", "description": "Código da natureza jurídica.", "disabled": true }, { "key": "capital_min", "value": "", "disabled": true }, { "key": "capital_max", "value": "", "disabled": true }, { "key": "abertura_de", "value": "", "disabled": true }, { "key": "abertura_ate", "value": "", "disabled": true }, { "key": "cursor", "value": "", "description": "Cursor opaco da página anterior (`meta.next_cursor`).", "disabled": true } ] }, "description": "Página de até 20 empresas com campos `basic`, ordenação fixa por CNPJ, paginação por cursor. Custa 1 crédito por empresa retornada; página vazia não custa. Não disponível no plano Free." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "400 Requisição inválida", "status": "Requisição inválida", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "401 Não autorizado", "status": "Não autorizado", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "402 Pagamento necessário", "status": "Pagamento necessário", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "403 Proibido", "status": "Proibido", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "429 Excesso de requisições", "status": "Excesso de requisições", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "503 Serviço indisponível", "status": "Serviço indisponível", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "504 Tempo esgotado", "status": "Tempo esgotado", "code": 504, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] }, { "name": "Gerar filtros de busca a partir de linguagem natural", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/filters/generate", "host": [ "{{base_url}}" ], "path": [ "v1", "filters", "generate" ] }, "body": { "mode": "raw", "raw": "{\n \"descricao\": \"fabricantes de embalagens em Joinville com mais de 50 funcionários\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Converte uma descrição em português nos filtros aceitos por `searchCnpjs`. Custa 1 crédito. Tem limite próprio de uso por conta." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "400 Requisição inválida", "status": "Requisição inválida", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "401 Não autorizado", "status": "Não autorizado", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "402 Pagamento necessário", "status": "Pagamento necessário", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "429 Excesso de requisições", "status": "Excesso de requisições", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] } ] }, { "name": "Conta", "description": "Uso e franquia da conta.", "item": [ { "name": "Uso e franquia da conta", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/usage", "host": [ "{{base_url}}" ], "path": [ "v1", "usage" ] } }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "401 Não autorizado", "status": "Não autorizado", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] } ] }, { "name": "Público", "description": "Sem chave: status da base e demonstração.", "item": [ { "name": "Data da base e estado da API", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/status", "host": [ "{{base_url}}" ], "path": [ "v1", "status" ] }, "auth": { "type": "noauth" } }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] }, { "name": "Demonstração sem chave", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/demo?cnpj=00000000000191", "host": [ "{{base_url}}" ], "path": [ "v1", "demo" ], "query": [ { "key": "cnpj", "value": "00000000000191", "description": "CNPJ da allowlist. Fora dela responde 404.", "disabled": true } ] }, "description": "Perfil `full` de instituições públicas de uma allowlist, sem o array `socios` (devolve `socios_count`). Cache de 1 hora, 10 requisições por minuto por IP. Serve o \"Testar agora\" do site.", "auth": { "type": "noauth" } }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "404 Não encontrado", "status": "Não encontrado", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" }, { "name": "429 Excesso de requisições", "status": "Excesso de requisições", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "_postman_previewlanguage": "json" } ] } ] } ] }