Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Recupera dados cadastrais completos de pessoas jurídicas consultando o CNPJ. O endpoint integra informações de registro oficial com análises estatísticas para fornecer visão abrangente sobre a empresa, incluindo estrutura organizacional, atividades econômicas, força de trabalho estimada e perspectivas de faturamento.
Indicado para processos de qualificação e onboarding de fornecedores, avaliação de risco de crédito, due diligence regulatória e enriquecimento de bases de dados B2B.
{
"type": "object",
"properties": {
"cnpj": {
"type": [
"string",
"null"
],
"description": "CNPJ da empresa."
},
"ramo": {
"type": [
"string",
"null"
],
"description": "Ramo de atividade da empresa."
},
"porte": {
"type": [
"string",
"null"
],
"description": "Porte ou tamanho da empresa (ex.: `MICRO`, `PEQUENA`, `GRANDE`, `MEI`, `ME`, `EPP`)."
},
"emails": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"enderecoEmail": {
"type": [
"string",
"null"
],
"description": "Endereço de e-mail."
}
}
},
"description": "Lista de endereços de e-mail da empresa."
},
"matriz": {
"type": [
"boolean",
"null"
],
"description": "Indica se a empresa é matriz."
},
"socios": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"nome": {
"type": [
"string",
"null"
],
"description": "Nome do sócio."
},
"cargo": {
"type": [
"string",
"null"
],
"description": "Cargo ou função do sócio na empresa."
},
"documento": {
"type": [
"string",
"null"
],
"description": "Documento (CPF ou CNPJ) do sócio."
},
"dataEntrada": {
"type": [
"string",
"null"
],
"description": "Data de entrada do sócio na empresa no formato dd/MM/yyyy HH:mm:ss."
},
"percentualParticipacao": {
"type": [
"string",
"null"
],
"description": "Percentual de participação do sócio na empresa."
}
}
},
"description": "Lista de sócios da empresa."
},
"enderecos": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"uf": {
"type": [
"string",
"null"
],
"description": "Unidade federativa (estado)."
},
"cep": {
"type": [
"string",
"null"
],
"description": "Código de Endereçamento Postal."
},
"bairro": {
"type": [
"string",
"null"
],
"description": "Bairro do endereço."
},
"cidade": {
"type": [
"string",
"null"
],
"description": "Cidade do endereço."
},
"numero": {
"type": [
"string",
"null"
],
"description": "Número do imóvel."
},
"logradouro": {
"type": [
"string",
"null"
],
"description": "Nome da rua, avenida ou logradouro."
},
"complemento": {
"type": [
"string",
"null"
],
"description": "Complemento do endereço."
}
}
},
"description": "Lista de endereços da empresa."
},
"telefones": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"whatsApp": {
"type": [
"boolean",
"null"
],
"description": "Indica se o telefone está vinculado ao WhatsApp."
},
"operadora": {
"type": [
"string",
"null"
],
"description": "Operadora de telefonia."
},
"tipoTelefone": {
"type": [
"string",
"null"
],
"description": "Tipo de telefone (fixo, celular, etc.)."
},
"telefoneComDDD": {
"type": [
"string",
"null"
],
"description": "Número de telefone com DDD."
},
"telemarketingBloqueado": {
"type": [
"boolean",
"null"
],
"description": "Indica se o telefone está bloqueado para telemarketing."
}
}
},
"description": "Lista de telefones da empresa."
},
"cnaeCodigo": {
"type": [
"number",
"null"
],
"description": "Código da Classificação Nacional das Atividades Econômicas principal."
},
"razaoSocial": {
"type": [
"string",
"null"
],
"description": "Razão social da empresa."
},
"tipoEmpresa": {
"type": [
"string",
"null"
],
"description": "Tipo de constituição da empresa."
},
"dataFundacao": {
"type": [
"string",
"null"
],
"description": "Data de fundação da empresa no formato dd/MM/yyyy HH:mm:ss."
},
"nomeFantasia": {
"type": [
"string",
"null"
],
"description": "Nome fantasia da empresa."
},
"orgaoPublico": {
"type": [
"string",
"null"
],
"description": "Órgão público relacionado à empresa, se aplicável."
},
"cnaeDescricao": {
"type": [
"string",
"null"
],
"description": "Descrição da atividade econômica principal."
},
"cnaEsSecundarios": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"cnaeCodigoSecundario": {
"type": [
"number",
"null"
],
"description": "Código da atividade econômica secundária."
},
"cnaeDescricaoSecundario": {
"type": [
"string",
"null"
],
"description": "Descrição da atividade econômica secundária."
}
}
},
"description": "Lista de atividades econômicas secundárias."
},
"faixaFaturamento": {
"type": [
"string",
"null"
],
"description": "Faixa estimada de faturamento anual."
},
"faixaFuncionarios": {
"type": [
"string",
"null"
],
"description": "Faixa estimada de quantidade de funcionários."
},
"situacaoCadastral": {
"type": [
"string",
"null"
],
"description": "Situação cadastral da empresa."
},
"ultimaAtualizacaoPJ": {
"type": [
"string",
"null"
],
"description": "Data da última atualização dos dados cadastrais."
},
"naturezaJuridicaTipo": {
"type": [
"string",
"null"
],
"description": "Tipo de natureza jurídica da empresa."
},
"naturezaJuridicaCodigo": {
"type": [
"number",
"null"
],
"description": "Código da natureza jurídica da empresa."
},
"quantidadeFuncionarios": {
"type": [
"number",
"null"
],
"description": "Quantidade de funcionários da empresa."
},
"naturezaJuridicaDescricao": {
"type": [
"string",
"null"
],
"description": "Descrição da natureza jurídica da empresa."
}
}
}
Códigos de erro
Código
Mensagem
Quando acontece
400
Requisição Inválida
a requisição está incorreta ou os parâmetros são inválidos.
401
Não Autenticado
o usuário não forneceu as credenciais corretas para acessar o recurso.
403
Não Autorizado
o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404
Não Encontrado
o servidor não encontrou uma representação atual do recurso solicitado.
408
Tempo Esgotado
o servidor não conseguiu retornar a requisição no prazo estabelecido.
500
Falha ao Realizar Consulta
o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503
Consulta em Manutenção
a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.
Observações
A estimativa de faturamento é calculada através de análise multivariada considerando: segmentação econômica, regime jurídico, tamanho operacional, volume de pessoal, estrutura acionária e demonstrações de capital. Este modelo permite categorizar empresas por potencial de receita para subsidiar decisões de crédito, análises de conformidade e benchmarking setorial.
Listas de sócios, telefones, endereços e e-mails podem conter múltiplas registros. Campos booleanos (matriz, telemarketingBloqueado, whatsApp) informam presença de atributos específicos.
Os dados retornados estão estruturados para integração imediata em sistemas de gestão, KYC/KYB e avaliação de risco, com respostas geradas em tempo real.
Integrar
OpenAPI (JSON) ↗ — importe a URL
no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar
pelo chat: conecte via MCP. Esta página em Markdown.