A API CNPJ Brasil fornece acesso programático aos dados de registro completos de entidades legais brasileiras, obtidos diretamente do banco de dados oficial da Receita Federal do Brasil. Com uma única solicitação GET, você recupera todas as informações publicamente disponíveis para qualquer CNPJ: status de registro e data de abertura, nome da empresa e nome fantasia, endereço completo, telefone e e-mail, códigos de atividade CNAE primários e secundários, natureza jurídica, porte da empresa, capital social e a lista completa de sócios e administradores. Projetada para ambientes de produção, com documentação OpenAPI completa e respostas JSON tipadas e previsíveis de forma consistente. Ideal para fintechs, marketplaces, sistemas ERP, plataformas de crédito e qualquer aplicação que precise validar ou enriquecer dados de negócios brasileiros
A interface "Dados da Empresa por ID Fiscal" foi projetada para recuperar informações detalhadas sobre uma empresa utilizando seu número de identificação fiscal único (NIF). Esta interface serve como uma ferramenta crucial para empresas, instituições financeiras e órgãos reguladores que buscam verificar a identidade, o status legal e os detalhes operacionais de uma empresa com base em seu ID fiscal atribuído. Após uma invocação bem-sucedida, retorna uma resposta JSON estruturada contendo campos de dados essenciais, como o nome da empresa, endereço, status de registro, classificação da indústria e informações de contato. Casos de uso potenciais incluem verificações de conformidade durante fusões e aquisições, detecção de fraudes, relatórios fiscais e garantia de registros precisos de clientes para faturamento e transações financeiras.
{"cnpj":"33000167000101","identificador_matriz_filial":"Matriz","razao_social":"PETROLEO BRASILEIRO S A PETROBRAS","nome_fantasia":"PETROBRAS - EDISE","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"data_situacao_cadastral":"2005-11-03","motivo_situacao_cadastral":{"codigo":"00","descricao":"SEM MOTIVO"},"data_inicio_atividade":"1966-09-28","natureza_juridica":{"codigo":"2038","descricao":"Sociedade de Economia Mista"},"qualificacao_responsavel":{"codigo":"10","descricao":"Diretor"},"capital_social":205431960490.52,"porte":{"codigo":"05","descricao":"Demais"},"ente_federativo":null,"cnae_fiscal_principal":{"codigo":"0600001","descricao":"Extração de petróleo e gás natural"},"cnaes_fiscais_secundarios":[{"codigo":"1921700","descricao":"Fabricação de produtos do refino de petróleo"},{"codigo":"3520401","descricao":"Produção de gás; processamento de gás natural"},{"codigo":"3520402","descricao":"Distribuição de combustíveis gasosos por redes urbanas"},{"codigo":"4681801","descricao":"Comércio atacadista de álcool carburante, biodiesel, gasolina e demais derivados de petróleo, exceto lubrificantes, não realizado por transportador re"},{"codigo":"8630599","descricao":"Atividades de atenção ambulatorial não especificadas anteriormente"}],"endereco":{"tipo_logradouro":"AVENIDA","logradouro":"REPUBLICA DO CHILE","numero":"65","complemento":null,"bairro":"CENTRO","cep":"20031170","uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},"nome_cidade_exterior":null,"pais":null,"telefones":[{"ddd":"21","numero":"21660000"}],"fax":{"ddd":"21","numero":"3224"},"correio_eletronico":"[email protected]","situacao_especial":null,"data_situacao_especial":null,"simples_nacional":null,"mei":null,"socios":[{"tipo":"Pessoa Física","nome":"CLAUDIO ROMEO SCHLOSSER","cpf_cnpj":"***077120**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"WILLIAM FRANCA DA SILVA","cpf_cnpj":"***487787**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"CLARICE COPPETTI","cpf_cnpj":"***995240**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"MAGDA MARIA DE REGINA CHAMBRIARD","cpf_cnpj":"***612937**","qualificacao":{"codigo":"16","descricao":"Presidente"},"data_entrada":"2024-06-07","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"FERNANDO SABBI MELGAREJO","cpf_cnpj":"***650110**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"SYLVIA MARIA COUTO DOS ANJOS","cpf_cnpj":"***701217**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"RENATA FARIA RODRIGUES BARUZZI LOPES","cpf_cnpj":"***944618**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"RICARDO WAGNER DE ARAUJO","cpf_cnpj":"***017831**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-04-25","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"ANGELICA GARCIA COBAS LAUREANO","cpf_cnpj":"***912137**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-07-29","pais":null,"faixa_etaria":"61 a 70 anos","representante":null}],"has_branches":true}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23444/company+data+by+tax+id&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY'
O endpoint "Listar Escritórios Filiais" foi projetado para recuperar uma lista abrangente de todos os escritórios filiais associados a uma organização ou rede específica. Este endpoint serve para permitir que os usuários acessem detalhes importantes, como nomes de escritórios, locais, informações de contato e status operacional, facilitando a gestão e supervisão eficiente da presença organizacional em várias regiões. Casos de uso típicos para este endpoint incluem a geração de relatórios para planejamento estratégico, possibilitando consultas de clientes relacionadas aos serviços de filiais e aprimorando a entrega de serviços ao garantir que as equipes tenham informações atualizadas sobre todas as filiais operacionais. Se este endpoint retornar uma lista vazia, isso significa que a empresa não possui filiais. Por favor, consulte o campo has_branches no endpoint "Dados da empresa por ID fiscal" para evitar gastar chamadas de API desnecessárias.
Listar Escritórios Filiais - Recursos do endpoint
| Objeto | Descrição |
|---|---|
page |
[Obrigatório] The page you wish to retrieve |
cnpj |
[Obrigatório] |
{
"cnpj_matriz": "33000167000101",
"total_filiais": 3,
"page": 1,
"total_pages": 1,
"filiais": [
{
"cnpj": "33000167000292",
"nome_fantasia": "PETROBRAS",
"situacao_cadastral": {
"codigo": "02",
"descricao": "Ativa"
},
"uf": "RJ",
"municipio": {
"codigo": "6001",
"descricao": "RIO DE JANEIRO"
}
},
{
"cnpj": "33000167000373",
"nome_fantasia": "PETROBRAS",
"situacao_cadastral": {
"codigo": "02",
"descricao": "Ativa"
},
"uf": "RN",
"municipio": {
"codigo": "1687",
"descricao": "GUAMARE"
}
},
{
"cnpj": "33000167000454",
"nome_fantasia": "PETROBRAS",
"situacao_cadastral": {
"codigo": "02",
"descricao": "Ativa"
},
"uf": "ES",
"municipio": {
"codigo": "5705",
"descricao": "VITORIA"
}
}
]
}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23462/list+branch+offices?page=Required&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Chame este endpoint para verificar se a API está ativa e funcionando
{"status":"ok","last_import":{"batch":"2026-04","status":"success","started_at":"2026-04-19T19:12:29.446800","finished_at":"2026-04-19T21:04:42.147052"}}
curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23445/status+check' --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. O teste gratuito inclui até 50 requisições.
Cada ponto final retorna informações detalhadas sobre entidades legais brasileiras O ponto final "Dados da Empresa por CPF" fornece status de registro nome da empresa endereço detalhes de contato e classificação da indústria O ponto final "Listar Filiais" retorna detalhes sobre filiais incluindo nomes locais e status operacional
Os campos principais incluem CNPJ, nome da empresa (razao_social), nome fantasia (nome_fantasia), situação cadastral (situacao_cadastral), data de abertura (data_inicio_atividade), natureza jurídica (natureza_juridica) e informações de contato. Para filiais, os campos incluem CNPJ da filial, nome e situação
Os dados de resposta estão estruturados em formato JSON com pares de chave-valor para cada campo Por exemplo a resposta de "Dados da empresa por ID fiscal" inclui objetos aninhados para o estado de registro e a natureza jurídica o que facilita a análise e a utilização de informação específica
O endpoint "Dados da Empresa por ID Fiscal" fornece detalhes abrangentes sobre o registro, status e atividades de uma empresa O endpoint "Listar Filiais" oferece informações sobre todas as filiais associadas, incluindo seu status operacional e localizações
Os dados são obtidos diretamente da Receita Federal do Brasil, garantindo alta precisão e confiabilidade Atualizações regulares e verificações de qualidade são realizadas para manter a integridade das informações fornecidas pela API
Casos de uso típicos incluem verificações de conformidade para fusões e aquisições detecção de fraudes relatórios fiscais e validação de registros de clientes para faturamento As empresas também podem usar dados de filiais para planejamento estratégico e consultas de clientes
Os usuários podem personalizar as solicitações especificando o CNPJ para o endpoint "Dados da empresa por ID fiscal" ou filtrando os resultados de acordo com critérios específicos ao recuperar dados de filiais Isso permite uma recuperação de informação direcionada
Os usuários podem esperar respostas JSON consistentes com dados estruturados Por exemplo o campo "situacao_cadastral" sempre indicará o status de registro enquanto "cnae_fiscal_principal" fornecerá a classificação da indústria principal facilitando a interpretação fácil dos dados
Este endpoint proporciona informações detalhadas sobre uma empresa, incluindo seu CNPJ, razão social, nome fantasia, estado de registro, data de início de atividades, natureza jurídica, capital social e classificação da indústria (CNAE) Isso permite aos usuários verificar a identidade e o estado legal da entidade
Este endpoint devolve uma lista de filiais associadas a uma empresa, incluindo o CNPJ de cada filial, nome comercial, estado de registro, localização (UF e município) e o total de filiais. Isto é útil para gerir a presença regional de uma organização
As respostas da API estão em formato JSON, organizadas em pares chave-valor. Por exemplo, em "Dados da Empresa por ID Fiscal", os dados de estado de registro e natureza jurídica estão aninhados, o que facilita a interpretação e o uso da informação
Os usuários podem especificar o CNPJ como parâmetro no endpoint "Dados da Empresa por ID Fiscal" Para "Listar Escritórios Filiais" pode-se filtrar pelo CNPJ da matriz para obter informações específicas sobre suas filiais
Os dados são obtidos diretamente da Receita Federal do Brasil garantindo sua precisão Além disso são implementados controles de qualidade e atualizações regulares para manter a integridade da informação
Os códigos nestes campos representam categorias específicas Por exemplo o código "02" em "situacao_cadastral" indica que a empresa está ativa enquanto o código "2062" em "natureza_juridica" refere-se a uma "Sociedade Empresária Limitada" Isso permite uma classificação padronizada
Se uma solicitação não retornar resultados, os usuários devem verificar a validade do CNPJ fornecido. Em caso de resultados parciais, recomenda-se rever os parâmetros de busca ou considerar a possibilidade de que a empresa não tenha filiais registradas
Os dados são comumente utilizados para verificações de conformidade em fusões e aquisições detecção de fraudes relatórios fiscais e validação de registros de clientes Também são úteis para o planejamento estratégico e a gestão de filiais em diversas regiões
O endpoint "Listar Escritórios de Filiais" fornece uma lista abrangente de escritórios de filiais associados a uma empresa, incluindo o CNPJ de cada filial, nome fantasia, status de registro, localização (estado e município) e o número total de filiais. Esses dados são essenciais para entender a presença regional de uma organização
Você pode verificar a situação operacional de uma empresa usando o endpoint "Dados da Empresa por CNPJ", que inclui o campo "situacao_cadastral". Este campo indica se a empresa está ativa ou inativa, fornecendo informações cruciais para processos de conformidade e verificação
O campo "qualificacao_responsavel" indica a qualificação da pessoa responsável pela empresa como "Sócio-Administrador" Isso ajuda a identificar o pessoal chave envolvido na gestão e tomada de decisões da empresa
Sim, ao usar o endpoint "List Branch Offices" você pode filtrar os resultados com base no CNPJ da empresa matriz Isso permite que você recupere informações sobre filiais específicas de uma organização particular, aumentando a relevância dos dados para suas necessidades
O campo "capital_social" representa o capital social da empresa, que é crucial para entender sua base financeira. Essas informações podem ser usadas para avaliações financeiras, decisões de investimento e para avaliar o tamanho e a estabilidade da empresa
O campo "data_inicio_atividade" indica quando a empresa começou suas operações Essa informação é útil para avaliar a experiência da empresa no mercado avaliar seu potencial de crescimento e realizar análises históricas para fins de conformidade ou investimento
O campo "motivo_situacao_cadastral" fornece um código e descrição explicando a razão para a situação cadastral da empresa Por exemplo um código de "00" indica "SEM MOTIVO" que pode ajudar os usuários a entender o contexto da situação atual da empresa
Para garantir valores válidos de CNPJ verifica se o formato do CNPJ está correto (14 dígitos) e corresponde a uma entidade existente Se uma solicitação não retorna resultados verifica novamente o CNPJ para maior precisão ou considera que a entidade pode não estar registrada na base de dados da Receita Federal
O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]
Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Nível de serviço:
100%
Tempo de resposta:
203ms
Nível de serviço:
100%
Tempo de resposta:
787ms
Nível de serviço:
100%
Tempo de resposta:
965ms
Nível de serviço:
100%
Tempo de resposta:
9.458ms
Nível de serviço:
100%
Tempo de resposta:
2.363ms
Nível de serviço:
100%
Tempo de resposta:
42ms
Nível de serviço:
100%
Tempo de resposta:
1.785ms
Nível de serviço:
100%
Tempo de resposta:
1.748ms
Nível de serviço:
100%
Tempo de resposta:
45ms
Nível de serviço:
100%
Tempo de resposta:
384ms
Nível de serviço:
100%
Tempo de resposta:
274ms
Nível de serviço:
100%
Tempo de resposta:
434ms
Nível de serviço:
100%
Tempo de resposta:
107ms
Nível de serviço:
100%
Tempo de resposta:
114ms
Nível de serviço:
100%
Tempo de resposta:
2.848ms
Nível de serviço:
100%
Tempo de resposta:
510ms
Nível de serviço:
100%
Tempo de resposta:
2.288ms
Nível de serviço:
100%
Tempo de resposta:
725ms
Nível de serviço:
100%
Tempo de resposta:
1.535ms