--- title: "API CNPJ" description: "API CNPJ - Dados completos da empresa em segundos" lang: en 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 - **Category:** Company Lookup (CNPJ) - **Billing:** per query, with the Bearer Token only - **Price:** R$0.04 per query - **Limit:** 990,000 per month - **Registration:** requires a CNPJ - **Version:** v2 - **Published by:** APIBrasil - **OpenAPI specification:** https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab/openapi.json ## How to call **Base address:** `https://gateway.apibrasil.io/api/v2` Authentication: the `Authorization: Bearer ` header. Nothing else. With `homolog: true` in the body, the gateway answers from a fixed base, with the real shape of the response, and does not charge. The CPF 00000000000 belongs to that base and to nobody: use it in tests, never in production. ## Endpoints (7 endpoints) **Contents** 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 dados/cnpj/credits, com tipo=cnae, 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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "cnae", "cnae": "6201-5/01", "quantidade": 2, "uf": "MG", "paginate": true, "municipio": "BELO HORIZONTE", "homolog": true, "page": 2 } ``` **In 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}' ``` This endpoint accepts `homolog: true` in the body: the response comes back with valid data, `api_limit_for` equal to `homolog` and no charge. **Sample response, from the catalog** ```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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "cnpj", "cnpj": "44.959.669/0001-80" } ``` **In 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"}' ``` **Sample response, from the catalog** ```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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "uf", "uf": "SP", "quantidade": 2 } ``` **In 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}' ``` **Sample response, from the catalog** ```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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "capital-social", "capital_social_inicio": "10000.0", "capital_social_fim": "10000.0", "quantidade": 2, "cnae": "6201-5/01", "uf": "MG" } ``` **In 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"}' ``` **Sample response, from the catalog** ```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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "lista-socios", "cnpj": "44.959.669/0001-80" } ``` **In 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"}' ``` **Sample response, from the catalog** ```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. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "cep", "cep": "32146057", "quantidade": 2 } ``` **In 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}' ``` **Sample response, from the catalog** ```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 - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/dados/cnpj/credits` - **Route version:** v2 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "lista-cnaes" } ``` **In 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"}' ``` **Sample response, from the catalog** ```json { "tipo": "lista-cnaes" } ``` In the sample responses, the fields of the account that generated the sample (`user.first_name`, `user.email`, `user.cellphone`) come out as `[omitido]`. The rest is what the catalog publishes. ## Pitfalls: what an integration gets wrong without warning Established from the responses the catalog itself publishes. In every one of them the code works on the happy path and fails silently everywhere else: 1. **The error arrives in the BODY, with HTTP 200.** The response carries a boolean `error` field and a `message`. Checking only `response.ok` or the HTTP status lets a failure through as a success. ALWAYS check `error === false` before reading `data`. 2. **`balance`, `tax` and `extra_charges.total` are STRINGS in Brazilian format — and the format varies between APIs.** Values seen in the catalog: `"154,380"`, `"497,84"`, `"0,000"` and `"0.19"`. Comma in some, dot in another; three decimal places in some, two in another. In JavaScript, `parseFloat("154,380")` returns `154` and drops the cents with no error at all, and `Number("154,380")` returns `NaN`. Write a converter that handles both separators, and never use these fields in a financial decision without converting them. 3. **Every call costs money.** Blind retries multiply the bill. Never automatically repeat a 4xx: a bad parameter repeated is still bad, and still charged. Retry only timeouts and 5xx, with exponential backoff and a small attempt ceiling. 4. **HTTP 402 means insufficient balance, and retrying does not fix it.** It is the one status that needs a human — a top-up. Treat it as a terminal error with its own message, and do not lump it in with generic 4xx. 5. **`extra_charges` bills on top of the lookup price.** When the body asks for add-on services, the response lists each one with its price plus a `total` that is NOT included in the base amount. If you show cost to an end user, add both. ## See also - OpenAPI specification: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab/openapi.json - API catalog: [API catalog](https://doc.apibrasil.io/apis.md) - Official SDKs: [Official SDKs](https://doc.apibrasil.io/sdks.md) - Documentation index: https://doc.apibrasil.io/llms.txt - HTML version of this page: https://doc.apibrasil.io/apis/creditos/116132f2-77cb-47e9-b818-1ef5c3222ab