A API de Consulta CNPJ permite que desenvolvedores recuperem facilmente informações de empresas registradas no Brasil usando seu número de CNPJ (Cadastro Nacional da Pessoa Jurídica) . Ela fornece acesso instantâneo a dados corporativos como nome da empresa, nome fantasia, status de registro, endereço, data de abertura, atividade econômica e muito mais
Ideal para processos de integração, prevenção de fraudes, serviços B2B ou enriquecimento de bancos de dados empresariais, esta API ajuda você a verificar empresas brasileiras de forma rápida e eficiente
Basta enviar um número de CNPJ e receber de volta dados JSON estruturados com registros públicos confiáveis e atualizados
Os casos de uso incluem:
- Validação de negócios durante o cadastro
- KYC corporativo (Conheça seu Cliente)
- Automação de integração financeira
- Enriquecimento de banco de dados CRM
{
"api": {
"success": true,
"tempo": "233ms",
"tipo": "real_time"
},
"data": {
"uf": "SP",
"cep": "06454070",
"qsa": [
{
"pais": null,
"nome_socio": "DORIVAL PEREIRA DE OLIVEIRA JUNIOR",
"codigo_pais": null,
"faixa_etaria": "Entre 61 a 70 anos",
"cnpj_cpf_do_socio": "***768478**",
"qualificacao_socio": "Diretor",
"codigo_faixa_etaria": 7,
"data_entrada_sociedade": "2020-11-23",
"identificador_de_socio": 2,
"cpf_representante_legal": "***000000**",
"nome_representante_legal": "",
"codigo_qualificacao_socio": 10,
"qualificacao_representante_legal": "Não informada",
"codigo_qualificacao_representante_legal": 0
},
{
"pais": null,
"nome_socio": "ROGERIO DE MORAES BARREIRA",
"codigo_pais": null,
"faixa_etaria": "Entre 51 a 60 anos",
"cnpj_cpf_do_socio": "***175578**",
"qualificacao_socio": "Presidente",
"codigo_faixa_etaria": 6,
"data_entrada_sociedade": "2021-05-03",
"identificador_de_socio": 2,
"cpf_representante_legal": "***000000**",
"nome_representante_legal": "",
"codigo_qualificacao_socio": 16,
"qualificacao_representante_legal": "Não informada",
"codigo_qualificacao_representante_legal": 0
}
],
"cnpj": "42591651000143",
"pais": null,
"email": null,
"porte": "DEMAIS",
"bairro": "ALPHAVILLE INDUSTRIAL",
"numero": "253",
"ddd_fax": "1141969800",
"municipio": "BARUERI",
"logradouro": "AMAZONAS",
"cnae_fiscal": 5611203,
"codigo_pais": null,
"complemento": "",
"codigo_porte": 5,
"razao_social": "ARCOS DOURADOS COMERCIO DE ALIMENTOS SA",
"nome_fantasia": "",
"capital_social": 442788930,
"ddd_telefone_1": "1141969800",
"ddd_telefone_2": "",
"opcao_pelo_mei": null,
"codigo_municipio": 6213,
"cnaes_secundarios": [
{
"codigo": 4763601,
"descricao": "Comércio varejista de brinquedos e artigos recreativos"
},
{
"codigo": 5611201,
"descricao": "Restaurantes e similares"
},
{
"codigo": 7740300,
"descricao": "Gestão de ativos intangíveis não-financeiros"
},
{
"codigo": 8211300,
"descricao": "Serviços combinados de escritório e apoio administrativo"
}
],
"natureza_juridica": "Sociedade Anônima Fechada",
"regime_tributario": [
{
"ano": 2015,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2016,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2017,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2018,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2019,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2020,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2021,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2022,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
},
{
"ano": 2023,
"cnpj_da_scp": null,
"forma_de_tributacao": "LUCRO REAL",
"quantidade_de_escrituracoes": 1
}
],
"situacao_especial": "",
"opcao_pelo_simples": null,
"situacao_cadastral": 2,
"data_opcao_pelo_mei": null,
"data_exclusao_do_mei": null,
"cnae_fiscal_descricao": "Lanchonetes, casas de chá, de sucos e similares",
"codigo_municipio_ibge": 3505708,
"data_inicio_atividade": "1977-01-17",
"data_situacao_especial": null,
"data_opcao_pelo_simples": null,
"data_situacao_cadastral": "2005-11-03",
"nome_cidade_no_exterior": "",
"codigo_natureza_juridica": 2054,
"data_exclusao_do_simples": null,
"motivo_situacao_cadastral": 0,
"ente_federativo_responsavel": "",
"identificador_matriz_filial": 1,
"qualificacao_do_responsavel": 16,
"descricao_situacao_cadastral": "ATIVA",
"descricao_tipo_de_logradouro": "ALAMEDA",
"descricao_motivo_situacao_cadastral": "SEM MOTIVO",
"descricao_identificador_matriz_filial": "MATRIZ"
}
}
curl --location --request GET 'https://zylalabs.com/api/8386/cnpj+api/14654/cnpj?cnpj=42591651000143' --header 'Authorization: Bearer YOUR_API_KEY'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
A API do CNPJ retorna informações detalhadas sobre a empresa, incluindo o nome da empresa, nome fantasia, status de registro, endereço, data de abertura, atividade econômica e detalhes dos sócios. Esses dados estão estruturados em formato JSON para fácil integração
Os campos principais na resposta incluem "uf" (estado), "cep" (código postal), "qsa" (informações sobre os sócios) e status de "success" (sucesso) Cada entrada de sócio contém detalhes como nome, faixa etária e status de qualificação
A resposta está estruturada em um formato JSON com um objeto de nível superior "api" indicando sucesso e tempo de resposta seguido por um objeto "data" contendo detalhes da empresa e um array de parceiros (qsa)
A API fornece informações sobre registro de empresas, incluindo status legal, endereço, atividades comerciais e detalhes sobre sócios e representantes, tornando-a adequada para KYC e validação de negócios
A API CNPJ obtém seus dados de registros públicos oficiais brasileiros garantindo alta precisão Atualizações e verificações regulares são realizadas para manter a integridade e a confiabilidade dos dados
Casos de uso típicos incluem verificar a legitimidade da empresa durante o processo de integração realizar verificações KYC automatizar processos financeiros de integração e enriquecer bancos de dados de CRM com informações precisas sobre a empresa
Os usuários podem personalizar solicitações enviando um número de CNPJ, com ou sem pontuação. A API é projetada para lidar com ambos os formatos, mas recomenda-se o uso apenas de dígitos para resultados otimizados
Se os resultados forem parciais ou vazios os usuários devem verificar o número do CNPJ quanto à precisão Além disso eles podem verificar se a empresa está recém-registrada ou se há problemas temporários de dados nos registros públicos
A API do CNPJ permite que você recupere várias informações da empresa, incluindo a razão social, nome fantasia, situação cadastral, endereço, data de abertura, atividades econômicas e informações sobre sócios e representantes, como seus nomes e qualificações
Sim a API do CNPJ abrange dados de empresas em todos os estados brasileiros (UFs) Cada resposta inclui as informações do estado permitindo que você identifique a localização da empresa registrada
O tempo de resposta da API CNPJ é normalmente indicado no campo "tempo" da resposta Este valor reflete o tempo levado para processar a solicitação e retornar os dados geralmente em milissegundos
Para garantir a precisão, sempre forneça um número de CNPJ válido sem pontuação Isso ajuda a API a processar sua solicitação de forma eficaz e reduz a probabilidade de receber resultados parciais ou vazios
O campo "qsa" contém um array de informações dos parceiros, detalhando o nome de cada parceiro, faixa etária, status de qualificação e data de entrada na empresa Isso é crucial para entender a estrutura de propriedade
A API do CNPJ retorna dados no formato JSON que é amplamente utilizado para respostas de APIs Este formato estruturado facilita a análise e a integração dos dados em aplicações
Se você encontrar um erro verifique o número do CNPJ quanto à precisão e garanta que ele esteja formatado corretamente Se o problema persistir consulte a documentação da API para dicas de resolução de problemas ou entre em contato com o suporte para assistência
As informações do parceiro podem ser usadas para diversos fins, como realizar a devida diligência, verificar a propriedade e avaliar a credibilidade de um negócio durante processos de KYC ou avaliações financeiras
Nível de serviço:
100%
Tempo de resposta:
173ms
Nível de serviço:
100%
Tempo de resposta:
2.429ms
Nível de serviço:
100%
Tempo de resposta:
17ms
Nível de serviço:
100%
Tempo de resposta:
105ms
Nível de serviço:
100%
Tempo de resposta:
3.869ms
Nível de serviço:
100%
Tempo de resposta:
299ms
Nível de serviço:
100%
Tempo de resposta:
219ms
Nível de serviço:
100%
Tempo de resposta:
935ms
Nível de serviço:
100%
Tempo de resposta:
546ms
Nível de serviço:
100%
Tempo de resposta:
83ms