--- title: "API CNPJ" description: "API CNPJ - Dados completos da empresa em segundos" lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab markdown: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab.md source: apibrasil-documentation --- # API CNPJ > API CNPJ - Dados completos da empresa em segundos - **Categoria:** Consulta CNPJ - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 0,04 por consulta - **Limite:** 990.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v2 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção. ## Endpoints (7 endpoints) **Sumário** 1. `POST /dados/cnpj/credits` 2. `POST /dados/cnpj/credits` 3. `POST /dados/cnpj/credits` 4. `POST /dados/cnpj/credits` 5. `POST /dados/cnpj/credits` 6. `POST /dados/cnpj/credits` 7. `POST /dados/cnpj/credits` ### 1. POST /dados/cnpj/credits API CNPJ - Encontre CNPJs por CNAE de forma rápida e fácil Com a API CNPJ, você localiza rapidamente uma lista de números de CNPJ associados a um código CNAE específico, impulsionando a eficiência e a inteligência do seu sistema. A integração é simples via método POST no endpoint cnae/credits, proporcionando retorno preciso e estruturado para alimentar sua base de dados, enriquecer cadastros ou automações comerciais. Gere oportunidades de negócio, facilite análise de risco e amplie sua prospecção com confiança, tudo sem complicações técnicas. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "cnae", "cnae": "6201-5/01", "quantidade": 2, "uf": "MG", "paginate": true, "municipio": "BELO HORIZONTE", "homolog": true, "page": 2 } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"cnae","cnae":"6201-5/01","quantidade":2,"uf":"MG","paginate":true,"municipio":"BELO HORIZONTE","homolog":true,"page":2}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "899,230", "balance_before": "899,230", "tax": "0,000", "status_code": 200, "error": false, "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.", "valor_consulta": 0, "api_limit_for": "homolog", "homolog": true, "data": { "data": { "cnae": [ { "cnpj_basico": "07433060", "cnpj_ordem": "0001", "cnpj_dv": "47", "matriz_filial": "1", "nome_fantasia": "", "situacao_cadastral": "08", "data_situacao_cadastral": "20141003", "motivo_situacao_cadastral": "10", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20050610", "cnae_fiscal": "6201501", "cnae_fiscal_secundaria": "6204000", "tipo_logradouro": "RUA", "logradouro": "TAMOIOS", "numero": "666", "complemento": "11 ANDAR SALA 1104", "bairro": "CENTRO", "cep": "30120050", "uf": "MG", "municipio": { "codigo": "4123", "descricao": "BELO HORIZONTE" }, "ddd1": "31", "telefone1": "32131715", "ddd2": "31", "telefone2": "32872442", "ddd_fax": "31", "fax": "32131715", "correio_eletronico": "", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "07433060000147", "cnae": [ { "codigo": "6201501", "descricao": "Desenvolvimento de programas de computador sob encomenda" } ], "socios": [ { "cnpj": "07433060000147", "cnpj_basico": "07433060", "identificador_de_socio": "2", "nome_socio": "SOCIO TESTE BRAVO", "cnpj_cpf_socio": "***044117**", "qualificacao_socio": "49", "data_entrada_sociedade": "20050610", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "6", "qualificacao": { "codigo": "49", "descricao": "Socio-Administrador" } }, { "cnpj": "07433060000147", "cnpj_basico": "07433060", "identificador_de_socio": "2", "nome_socio": "SOCIO TESTE CHARLIE", "cnpj_cpf_socio": "***462016**", "qualificacao_socio": "49", "data_entrada_sociedade": "20050610", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "7", "qualificacao": { "codigo": "49", "descricao": "Socio-Administrador" } } ], "empresa": { "cnpj_basico": "07433060", "razao_social": "EMPRESA ALFA LTDA", "natureza_juridica": "2240", "qualificacao_responsavel": "49", "capital_social_str": "0,00", "porte_empresa": "01", "ente_federativo_responsavel": "", "capital_social": 0 }, "simples": null, "motivo_situacao": { "codigo": "10", "descricao": "EXTINCAO PELO ENCERRAMENTO DA LIQUIDACAO JUDICIAL" } }, { "cnpj_basico": "07803139", "cnpj_ordem": "0001", "cnpj_dv": "12", "matriz_filial": "1", "nome_fantasia": "SISTEMAS DEMO", "situacao_cadastral": "04", "data_situacao_cadastral": "20201029", "motivo_situacao_cadastral": "63", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20060119", "cnae_fiscal": "6201501", "cnae_fiscal_secundaria": "6204000", "tipo_logradouro": "RUA", "logradouro": "ABILIO ESTRELA", "numero": "170", "complemento": "", "bairro": "JARDIM GUANABARA", "cep": "31742135", "uf": "MG", "municipio": { "codigo": "4123", "descricao": "BELO HORIZONTE" }, "ddd1": "31", "telefone1": "34956976", "ddd2": "", "telefone2": "", "ddd_fax": "31", "fax": "34956976", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "07803139000112", "cnae": [ { "codigo": "6201501", "descricao": "Desenvolvimento de programas de computador sob encomenda" } ], "socios": [ { "cnpj": "07803139000112", "cnpj_basico": "07803139", "identificador_de_socio": "2", "nome_socio": "SOCIO TESTE DELTA", "cnpj_cpf_socio": "***322406**", "qualificacao_socio": "22", "data_entrada_sociedade": "20060119", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "9", "qualificacao": { "codigo": "22", "descricao": "Socio" } }, { "cnpj": "07803139000112", "cnpj_basico": "07803139", "identificador_de_socio": "2", "nome_socio": "SOCIO TESTE ECHO", "cnpj_cpf_socio": "***932376**", "qualificacao_socio": "49", "data_entrada_sociedade": "20060119", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "5", "qualificacao": { "codigo": "49", "descricao": "Socio-Administrador" } } ], "empresa": { "cnpj_basico": "07803139", "razao_social": "EMPRESA BETA LTDA", "natureza_juridica": "2240", "qualificacao_responsavel": "49", "capital_social_str": "1000,00", "porte_empresa": "01", "ente_federativo_responsavel": "", "capital_social": 1000 }, "simples": null, "motivo_situacao": { "codigo": "63", "descricao": "OMISSAO DE DECLARACOES" } } ] } } } ``` ### 2. POST /dados/cnpj/credits API CNPJ- Dados rápidos e confiáveis pelo CNPJ Com a API CNPJ, você acessa instantaneamente dados completos de empresas apenas informando o número do CNPJ pelo endpoint cnpj/credits via método POST. A integração é rápida e descomplicada, permitindo que seu sistema consulte e valide informações essenciais sobre qualquer empresa em questão de segundos. Ganhe agilidade nos seus processos de cadastro, análise de risco ou validação comercial, aumentando a eficiência operacional e a segurança nas suas transações. Amplie as possibilidades do seu negócio, oferecendo consultas precisas e automatizadas para melhor tomada de decisão. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "cnpj", "cnpj": "44.959.669/0001-80" } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"cnpj","cnpj":"44.959.669/0001-80"}' ``` **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "107,620", "balance_before": "107,660", "tax": "0,040", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 0,04.", "valor_consulta": 0.04, "api_limit_for": "credit", "homolog": false, "data": { "error": false, "cnpj": { "cnpj_basico": "44959669", "cnpj_ordem": "0001", "cnpj_dv": "80", "matriz_filial": "1", "nome_fantasia": "APIBRASIL SITES E SOFTWARE", "situacao_cadastral": "02", "data_situacao_cadastral": "20220121", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20220121", "cnae_fiscal": "6311900", "cnae_fiscal_secundaria": "6201501,6204000,6319400,6399200", "tipo_logradouro": "RUA", "logradouro": "ACUCENA", "numero": "134", "complemento": "", "bairro": "PARQUE XANGRI-LA", "cep": "32187090", "uf": "MG", "municipio": { "codigo": "4371", "descricao": "CONTAGEM" }, "ddd1": "31", "telefone1": "94359434", "ddd2": "", "telefone2": "", "ddd_fax": "31", "fax": "37123399", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "44959669000180", "cnae": [ { "codigo": "6311900", "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet" } ], "socios": [ { "cnpj": "44959669000180", "cnpj_basico": "44959669", "identificador_de_socio": "2", "nome_socio": "JONATHAN HENRIQUE DA SILVA MOTTA", "cnpj_cpf_socio": "***067476**", "qualificacao_socio": "49", "data_entrada_sociedade": "20220121", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "4", "qualificacao": { "codigo": "49", "descricao": "Sócio-Administrador" } } ], "empresa": { "cnpj_basico": "44959669", "razao_social": "APIBRASIL SITES E SOFTWARES LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": 10000 }, "simples": { "cnpj_basico": "44959669", "opcao_simples": "S", "data_opcao_simples": "20220121", "data_exclusao_simples": "00000000", "opcao_mei": "N", "data_opcao_mei": "00000000", "data_exclusao_mei": "00000000" }, "motivo_situacao": { "codigo": "00", "descricao": "SEM MOTIVO" } }, "status": true, "consulta": { "id": null, "debitado": true, "valor": 0 }, "msg": "Foi encontrado informações!", "dados": { "cnpj_basico": "44959669", "cnpj_ordem": "0001", "cnpj_dv": "80", "matriz_filial": "1", "nome_fantasia": "APIBRASIL SITES E SOFTWARE", "situacao_cadastral": "02", "data_situacao_cadastral": "20220121", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20220121", "cnae_fiscal": "6311900", "cnae_fiscal_secundaria": "6201501,6204000,6319400,6399200", "tipo_logradouro": "RUA", "logradouro": "ACUCENA", "numero": "134", "complemento": "", "bairro": "PARQUE XANGRI-LA", "cep": "32187090", "uf": "MG", "municipio": { "codigo": "4371", "descricao": "CONTAGEM" }, "ddd1": "31", "telefone1": "94359434", "ddd2": "", "telefone2": "", "ddd_fax": "31", "fax": "37123399", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "44959669000180", "cnae": [ { "codigo": "6311900", "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet" } ], "socios": [ { "cnpj": "44959669000180", "cnpj_basico": "44959669", "identificador_de_socio": "2", "nome_socio": "JONATHAN HENRIQUE DA SILVA MOTTA", "cnpj_cpf_socio": "***067476**", "qualificacao_socio": "49", "data_entrada_sociedade": "20220121", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "4", "qualificacao": { "codigo": "49", "descricao": "Sócio-Administrador" } } ], "empresa": { "cnpj_basico": "44959669", "razao_social": "APIBRASIL SITES E SOFTWARES LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": 10000 }, "simples": { "cnpj_basico": "44959669", "opcao_simples": "S", "data_opcao_simples": "20220121", "data_exclusao_simples": "00000000", "opcao_mei": "N", "data_opcao_mei": "00000000", "data_exclusao_mei": "00000000" }, "motivo_situacao": { "codigo": "00", "descricao": "SEM MOTIVO" } } } } ``` ### 3. POST /dados/cnpj/credits API CNPJ - Encontre CNPJs por Estado com Rapidez A API CNPJ permite que você obtenha listas de números de CNPJ registrados em qualquer unidade federativa do Brasil de forma ágil e automatizada. Com integração simples via método POST, sua empresa pode acessar informações atualizadas diretamente do endpoint cnpj/credits, acelerando processos de consulta, enriquecimento de bancos de dados e análise de mercado. O retorno estruturado da API proporciona praticidade para incorporação imediata ao seu sistema, tornando mais eficiente a geração de leads, validação de parceiros e monitoramento do setor empresarial no estado desejado. Aproveite uma solução robusta que entrega mais produtividade e valor para o seu negócio. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "uf", "uf": "SP", "quantidade": 2 } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"uf","uf":"SP","quantidade":2}' ``` **Resposta de exemplo, do catálogo** ```json { "error": false, "message": "Requisição processada com sucesso", "response": { "erro": false, "cnae": [ { "cnpj_basico": "27460122", "razao_social": "DISTRIBUIDORA DE GAS UNIAO DE CUBATAO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "01", "ente_federativo_responsavel": "", "capital_social": "100000.0", "cnpj_ordem": "0001", "cnpj_dv": "17", "matriz_filial": "1", "nome_fantasia": "DISTRIBUIDORA DE GAS UNIAO", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "4784900", "cnae_fiscal_secundaria": "4723700,4729699,4789099", "tipo_logradouro": "RUA", "logradouro": "ARMANDO DE SALLES OLIVEIRA", "numero": "507", "complemento": "", "bairro": "VILA COUTO", "cep": "11500010", "uf": "SP", "municipio": "6371", "ddd1": "13", "telefone1": "33641572", "ddd2": "", "telefone2": "", "ddd_fax": "", "fax": "", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460122000117", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "CUBATAO", "cnae_descricao": "Comércio varejista de gás liqüefeito de petróleo (GLP)", "motivo_descricao": "SEM MOTIVO" }, { "cnpj_basico": "27460589", "razao_social": "VIEIRA & SILVA MARKETING DIRETO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": "1000.0", "cnpj_ordem": "0001", "cnpj_dv": "67", "matriz_filial": "1", "nome_fantasia": "VIEIRA & SILVA MARKETING GROUP LTDA", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "7319003", "cnae_fiscal_secundaria": "", "tipo_logradouro": "RUA", "logradouro": "DA CONSOLACAO", "numero": "439", "complemento": "ANDAR 3 CXPST 2016229", "bairro": "CONSOLACAO", "cep": "01301000", "uf": "SP", "municipio": "7107", "ddd1": "11", "telefone1": "88888888", "ddd2": "11", "telefone2": "99999999", "ddd_fax": "", "fax": "", "correio_eletronico": "", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460589000167", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "SAO PAULO", "cnae_descricao": "Marketing direto", "motivo_descricao": "SEM MOTIVO" } ] }, "api_limit": 1000, "api_limit_for": "request", "api_limit_used": 40 } ``` ### 4. POST /dados/cnpj/credits API CNPJ - Encontre CNPJs pelo Capital Social com agilidade Com a API CNPJ, você obtém rapidamente uma lista de CNPJs a partir do valor do Capital Social informado, agilizando buscas estratégicas para análise de mercado, prospecção ou compliance. Nossa integração via POST no endpoint cnpj/credits é simples e eficiente, trazendo respostas rápidas e estruturadas para você incorporar facilmente no seu sistema. Amplie o valor do seu negócio automatizando processos que antes eram manuais, com dados confiáveis direto da fonte e capacidade de atender demandas de diferentes segmentos. Conquiste resultados superiores com tecnologia descomplicada e potencial ilimitado para customização conforme suas necessidades. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "capital-social", "capital_social_inicio": "10000.0", "capital_social_fim": "10000.0", "quantidade": 2, "cnae": "6201-5/01", "uf": "MG" } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"capital-social","capital_social_inicio":"10000.0","capital_social_fim":"10000.0","quantidade":2,"cnae":"6201-5/01","uf":"MG"}' ``` **Resposta de exemplo, do catálogo** ```json { "error": false, "message": "Requisição processada com sucesso", "response": { "erro": false, "cnae": [ { "cnpj_basico": "27460122", "razao_social": "DISTRIBUIDORA DE GAS UNIAO DE CUBATAO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "01", "ente_federativo_responsavel": "", "capital_social": "100000.0", "cnpj_ordem": "0001", "cnpj_dv": "17", "matriz_filial": "1", "nome_fantasia": "DISTRIBUIDORA DE GAS UNIAO", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "4784900", "cnae_fiscal_secundaria": "4723700,4729699,4789099", "tipo_logradouro": "RUA", "logradouro": "ARMANDO DE SALLES OLIVEIRA", "numero": "507", "complemento": "", "bairro": "VILA COUTO", "cep": "11500010", "uf": "SP", "municipio": "6371", "ddd1": "13", "telefone1": "33641572", "ddd2": "", "telefone2": "", "ddd_fax": "", "fax": "", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460122000117", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "CUBATAO", "cnae_descricao": "Comércio varejista de gás liqüefeito de petróleo (GLP)", "motivo_descricao": "SEM MOTIVO" }, { "cnpj_basico": "27460589", "razao_social": "VIEIRA & SILVA MARKETING DIRETO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": "1000.0", "cnpj_ordem": "0001", "cnpj_dv": "67", "matriz_filial": "1", "nome_fantasia": "VIEIRA & SILVA MARKETING GROUP LTDA", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "7319003", "cnae_fiscal_secundaria": "", "tipo_logradouro": "RUA", "logradouro": "DA CONSOLACAO", "numero": "439", "complemento": "ANDAR 3 CXPST 2016229", "bairro": "CONSOLACAO", "cep": "01301000", "uf": "SP", "municipio": "7107", "ddd1": "11", "telefone1": "88888888", "ddd2": "11", "telefone2": "99999999", "ddd_fax": "", "fax": "", "correio_eletronico": "", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460589000167", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "SAO PAULO", "cnae_descricao": "Marketing direto", "motivo_descricao": "SEM MOTIVO" } ] }, "api_limit": 1000, "api_limit_for": "request", "api_limit_used": 40 } ``` ### 5. POST /dados/cnpj/credits API CNPJ - Descubra Sócios de Empresas em Segundos Ganhe agilidade e precisão ao consultar informações de sócios de qualquer CNPJ em sua aplicação. A API CNPJ permite integração rápida via método POST para obter a lista completa de sócios, facilitando processos de análise cadastral, compliance e tomada de decisão com dados atualizados direto da fonte oficial. Transforme seu sistema em uma ferramenta ainda mais poderosa para onboarding, crédito, avaliação de riscos ou prospecção, potencializando resultados e eliminando burocracia. Faça consultas automáticas, receba os dados prontos para uso e otimize seu fluxo de negócios com total segurança e praticidade. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "lista-socios", "cnpj": "44.959.669/0001-80" } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"lista-socios","cnpj":"44.959.669/0001-80"}' ``` **Resposta de exemplo, do catálogo** ```json { "error": false, "message": "Requisição processada com sucesso", "response": { "erro": false, "socios": [ { "cnpj": "44959669000180", "cnpj_basico": "44959669", "identificador_de_socio": "2", "nome_socio": "JONATHAN HENRIQUE DA SILVA MOTTA", "cnpj_cpf_socio": "***067476**", "qualificacao_socio": "49", "data_entrada_sociedade": "20220121", "pais": "", "representante_legal": "***000000**", "nome_representante": "", "qualificacao_representante_legal": "00", "faixa_etaria": "4", "empresa": [ { "cnpj_basico": "44959669", "razao_social": "APIBRASIL SITES E SOFTWARES LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": "10000.0" } ] } ] }, "api_limit": 10000, "api_limit_for": "request", "api_limit_used": 27 } ``` ### 6. POST /dados/cnpj/credits API CNPJ - Encontrando Empresas pelo CEP em Segundos A API CNPJ permite que você descubra rapidamente números de CNPJ utilizando apenas o CEP informado, otimizando buscas empresariais e ganhando agilidade em processos internos. Por meio de uma integração rápida com o endpoint POST cnpj/credits, seu sistema recebe uma lista precisa de empresas relacionadas ao CEP consultado, ampliando o valor do seu negócio com dados confiáveis em tempo real. Utilize essa solução para enriquecer cadastros, automatizar validações, potencializar vendas B2B e aprimorar análises de mercado diretamente nas suas aplicações, tudo com praticidade e segurança. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "cep", "cep": "32146057", "quantidade": 2 } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"cep","cep":"32146057","quantidade":2}' ``` **Resposta de exemplo, do catálogo** ```json { "error": false, "message": "Requisição processada com sucesso", "response": { "erro": false, "cnae": [ { "cnpj_basico": "27460122", "razao_social": "DISTRIBUIDORA DE GAS UNIAO DE CUBATAO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "01", "ente_federativo_responsavel": "", "capital_social": "100000.0", "cnpj_ordem": "0001", "cnpj_dv": "17", "matriz_filial": "1", "nome_fantasia": "DISTRIBUIDORA DE GAS UNIAO", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "4784900", "cnae_fiscal_secundaria": "4723700,4729699,4789099", "tipo_logradouro": "RUA", "logradouro": "ARMANDO DE SALLES OLIVEIRA", "numero": "507", "complemento": "", "bairro": "VILA COUTO", "cep": "11500010", "uf": "SP", "municipio": "6371", "ddd1": "13", "telefone1": "33641572", "ddd2": "", "telefone2": "", "ddd_fax": "", "fax": "", "correio_eletronico": "[omitido]", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460122000117", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "CUBATAO", "cnae_descricao": "Comércio varejista de gás liqüefeito de petróleo (GLP)", "motivo_descricao": "SEM MOTIVO" }, { "cnpj_basico": "27460589", "razao_social": "VIEIRA & SILVA MARKETING DIRETO LTDA", "natureza_juridica": "2062", "qualificacao_responsavel": "49", "porte_empresa": "03", "ente_federativo_responsavel": "", "capital_social": "1000.0", "cnpj_ordem": "0001", "cnpj_dv": "67", "matriz_filial": "1", "nome_fantasia": "VIEIRA & SILVA MARKETING GROUP LTDA", "situacao_cadastral": "02", "data_situacao_cadastral": "20170404", "motivo_situacao_cadastral": "00", "nome_cidade_exterior": "", "pais": "", "data_inicio_atividades": "20170404", "cnae_fiscal": "7319003", "cnae_fiscal_secundaria": "", "tipo_logradouro": "RUA", "logradouro": "DA CONSOLACAO", "numero": "439", "complemento": "ANDAR 3 CXPST 2016229", "bairro": "CONSOLACAO", "cep": "01301000", "uf": "SP", "municipio": "7107", "ddd1": "11", "telefone1": "88888888", "ddd2": "11", "telefone2": "99999999", "ddd_fax": "", "fax": "", "correio_eletronico": "", "situacao_especial": "", "data_situacao_especial": "", "cnpj": "27460589000167", "qualificacao_socio_descricao": "Sócio-Administrador", "municipio_descricao": "SAO PAULO", "cnae_descricao": "Marketing direto", "motivo_descricao": "SEM MOTIVO" } ] }, "api_limit": 1000, "api_limit_for": "request", "api_limit_used": 40 } ``` ### 7. POST /dados/cnpj/credits Lista todos os cnaes - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "lista-cnaes" } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/dados/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"lista-cnaes"}' ``` **Resposta de exemplo, do catálogo** ```json { "tipo": "lista-cnaes" } ``` Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab