Consulta CNPJ — Dados Básicos
Last updated
Retorna cadastro da empresa, estabelecimento, sócios, atividades econômicas, contatos e informações tributárias disponíveis.
| Propriedade | Valor |
|---|---|
| Dataset | cnpj_dados_basicos |
| Método e caminho | POST /datasets/cnpj_dados_basicos/queries |
Versão do schema de dados (schema_version) |
1.0.0 |
| Entrada | CNPJ |
| Consultas em lote | Suportadas, conforme disponibilidade no catálogo |
Requisição
<API_KEY> representa uma chave válida da conta:
curl --request POST 'https://api.verifica-online.com.br/datasets/cnpj_dados_basicos/queries' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: cnpj-basicos-exemplo-001' \
--data '{"cnpj":"11222333000181"}'
{
"cnpj": "11222333000181"
}
O CNPJ é didático. Nomes, endereço, contatos e registros no exemplo são ilustrativos e fictícios, sem vínculo declarado com o documento.
Entrada
| Campo | Tipo | Obrigatório | Regra |
|---|---|---|---|
cnpj |
string | Sim | Exatamente 14 caracteres, sem pontuação ou espaços: 12 posições de A–Z ou 0–9, seguidas de dois dígitos verificadores. Letras devem estar em maiúsculas; os dígitos verificadores são conferidos. |
O corpo aceita somente cnpj; números e campos adicionais são rejeitados. Preserve zeros iniciais. A chave de idempotência, quando enviada, aceita de 8 a 128 caracteres de A–Z, a–z, 0–9, _, ., :, -; consulte requisições e cobrança.
Dados de resposta
Exemplo completo do campo data:
{
"cnpj": "11222333000181",
"company": {
"root": "11222333",
"legal_name": "Empresa Exemplo Ltda.",
"share_capital_cents": 10000000,
"federal_entity": null,
"size": { "code": "03", "description": "Empresa de Pequeno Porte" },
"legal_nature": { "code": "2062", "description": "Sociedade Empresária Limitada" },
"responsible_qualification": { "code": "49", "description": "Sócio-Administrador" },
"updated_at": "2025-06-01T12:00:00.000Z"
},
"partners": [
{
"document": "***111222**",
"name": "Pessoa de Exemplo",
"type": "Pessoa física",
"joined_at": "2018-05-20",
"age_range": "De 31 a 40 anos",
"qualification": { "code": "49", "description": "Sócio-Administrador" },
"country": { "code": "1058", "iso2": "BR", "iso3": "BRA", "name": "Brasil" },
"representative": {
"document": null,
"name": null,
"qualification": null
},
"updated_at": "2025-06-01T12:00:00.000Z"
}
],
"simplified_tax": {
"opted_in": true,
"opted_in_at": "2019-01-01",
"excluded_at": null,
"microentrepreneur": false,
"microentrepreneur_since": null,
"microentrepreneur_excluded_at": null,
"updated_at": "2025-06-01T12:00:00.000Z"
},
"establishment": {
"type": "Matriz",
"trade_name": "Empresa Exemplo",
"registration_status": "Ativa",
"registration_status_date": "2018-05-20",
"registration_status_reason": null,
"started_at": "2018-05-20",
"special_status": null,
"special_status_date": null,
"primary_activity": {
"code": "6201501",
"section": "J",
"division": "62",
"group": "620",
"class": "62015",
"subclass": "6201501",
"description": "Desenvolvimento de programas de computador sob encomenda"
},
"secondary_activities": [],
"address": {
"street_type": "Rua",
"street": "de Exemplo",
"number": "100",
"complement": "Sala 1",
"district": "Bairro Exemplo",
"postal_code": "00000000",
"city": { "name": "Cidade Exemplo", "ibge_code": "" },
"state": { "name": "São Paulo", "abbreviation": "SP", "ibge_code": "35" },
"country": { "code": "1058", "iso2": "BR", "iso3": "BRA", "name": "Brasil" },
"foreign_city": null
},
"phones": [{ "area_code": "11", "number": "00000000" }],
"fax": null,
"email": "contato@example.com",
"state_registrations": [{ "number": "ISENTO", "active": true, "state": "SP", "updated_at": "2025-06-01T12:00:00.000Z" }],
"regional_registrations": [],
"tax_regimes": [{ "year": 2025, "regime": "Simples Nacional", "taxation": "", "updated_at": "2025-06-01T12:00:00.000Z" }],
"updated_at": "2025-06-01T12:00:00.000Z"
}
}
Todos os campos do contrato são presentes nos objetos correspondentes. Objetos e valores marcados como nulos podem retornar null. Campos textuais não nulos podem retornar ""; documentos de sócios podem estar mascarados. As listas possuem no máximo 1.000 itens. Datas são YYYY-MM-DD; horários de atualização são ISO 8601 em UTC. Códigos, CEPs e telefones são strings, preservando zeros iniciais.
Empresa e sócios
Campo em data |
Tipo | Nulo | Descrição |
|---|---|---|---|
cnpj |
string | Não | CNPJ consultado. |
company |
object | Não | Cadastro da empresa. |
company.root |
string | Não | Raiz do CNPJ. |
company.legal_name |
string | Não | Razão social. |
company.share_capital_cents |
integer | Sim | Capital social em centavos de BRL. |
company.federal_entity |
string | Sim | Ente federativo responsável, quando informado. |
company.size |
object | Sim | Porte, com code e description. |
company.legal_nature |
object | Sim | Natureza jurídica, com code e description. |
company.responsible_qualification |
object | Sim | Qualificação do responsável, com code e description. |
company.updated_at |
string | Sim | Horário de atualização cadastral em UTC. |
partners |
array de object | Não | Sócios disponíveis, até 1.000. |
partners[].document |
string | Não | Documento como informado, inclusive mascaramento. |
partners[].name |
string | Não | Nome ou razão social do sócio. |
partners[].type |
string | Não | Tipo do sócio. |
partners[].joined_at |
string | Sim | Data de entrada na sociedade. |
partners[].age_range |
string | Não | Faixa etária informada. |
partners[].qualification |
object | Sim | Qualificação, com code e description. |
partners[].country |
object | Sim | País, com code, iso2, iso3 e name. |
partners[].representative |
object | Não | Representante legal; seus campos podem ser nulos. |
partners[].representative.document |
string | Sim | Documento do representante como informado. |
partners[].representative.name |
string | Sim | Nome do representante. |
partners[].representative.qualification |
object | Sim | Qualificação, com code e description. |
partners[].updated_at |
string | Sim | Horário de atualização do sócio em UTC. |
Os objetos de classificação em company.size, company.legal_nature, company.responsible_qualification, partners[].qualification, partners[].representative.qualification e establishment.registration_status_reason possuem estes campos quando presentes:
| Campo da classificação | Tipo | Nulo | Descrição |
|---|---|---|---|
code |
string | Não | Código da classificação. |
description |
string | Não | Descrição da classificação. |
Informações tributárias
Campo em data |
Tipo | Nulo | Descrição |
|---|---|---|---|
simplified_tax |
object | Sim | Informações do Simples Nacional e MEI. |
simplified_tax.opted_in |
boolean | Sim | Opção pelo Simples Nacional conhecida. |
simplified_tax.opted_in_at |
string | Sim | Data de opção pelo Simples. |
simplified_tax.excluded_at |
string | Sim | Data de exclusão do Simples. |
simplified_tax.microentrepreneur |
boolean | Sim | Indicação conhecida de MEI. |
simplified_tax.microentrepreneur_since |
string | Sim | Data de opção pelo MEI. |
simplified_tax.microentrepreneur_excluded_at |
string | Sim | Data de exclusão do MEI. |
simplified_tax.updated_at |
string | Sim | Horário de atualização em UTC. |
Estabelecimento
Campo em data |
Tipo | Nulo | Descrição |
|---|---|---|---|
establishment |
object | Não | Estabelecimento correspondente ao CNPJ. |
establishment.type |
string | Não | Tipo de estabelecimento, como matriz ou filial. |
establishment.trade_name |
string | Sim | Nome fantasia. |
establishment.registration_status |
string | Não | Situação cadastral. |
establishment.registration_status_date |
string | Sim | Data da situação cadastral. |
establishment.registration_status_reason |
object | Sim | Motivo da situação; estrutura de classificação acima. |
establishment.started_at |
string | Sim | Data de início das atividades. |
establishment.special_status |
string | Sim | Situação especial. |
establishment.special_status_date |
string | Sim | Data da situação especial. |
establishment.primary_activity |
object | Sim | Atividade principal; estrutura de atividade abaixo. |
establishment.secondary_activities |
array de object/null | Não | Atividades secundárias, até 1.000; cada posição pode ser nula. |
establishment.address |
object | Não | Endereço. |
establishment.address.street_type |
string | Não | Tipo de logradouro. |
establishment.address.street |
string | Não | Logradouro. |
establishment.address.number |
string | Não | Número como texto. |
establishment.address.complement |
string | Não | Complemento. |
establishment.address.district |
string | Não | Bairro. |
establishment.address.postal_code |
string | Não | CEP somente com dígitos, quando informado. |
establishment.address.city |
object | Não | Município. |
establishment.address.city.name |
string | Não | Nome do município. |
establishment.address.city.ibge_code |
string | Não | Código IBGE do município. |
establishment.address.state |
object | Não | Unidade federativa. |
establishment.address.state.name |
string | Não | Nome da UF. |
establishment.address.state.abbreviation |
string | Não | Sigla da UF. |
establishment.address.state.ibge_code |
string | Não | Código IBGE da UF. |
establishment.address.country |
object | Sim | País; estrutura abaixo. |
establishment.address.foreign_city |
string | Sim | Cidade no exterior. |
establishment.phones |
array de object | Não | Até dois telefones com DDD e número disponíveis. |
establishment.phones[].area_code |
string | Não | DDD somente com dígitos. |
establishment.phones[].number |
string | Não | Número somente com dígitos. |
establishment.fax |
object | Sim | Fax disponível. |
establishment.fax.area_code |
string | Não | DDD somente com dígitos. |
establishment.fax.number |
string | Não | Número somente com dígitos. |
establishment.email |
string | Não | E-mail em minúsculas. |
establishment.state_registrations |
array de object | Não | Inscrições estaduais, até 1.000. |
establishment.state_registrations[].number |
string | Não | Número da inscrição. |
establishment.state_registrations[].active |
boolean | Sim | Situação ativa conhecida. |
establishment.state_registrations[].state |
string | Não | UF da inscrição. |
establishment.state_registrations[].updated_at |
string | Sim | Atualização em UTC. |
establishment.regional_registrations |
array de object | Não | Inscrições regionais SUFRAMA, até 1.000. |
establishment.regional_registrations[].number |
string | Não | Número da inscrição. |
establishment.regional_registrations[].active |
boolean | Sim | Situação ativa conhecida. |
establishment.regional_registrations[].updated_at |
string | Sim | Atualização em UTC. |
establishment.tax_regimes |
array de object | Não | Regimes tributários disponíveis, até 1.000. |
establishment.tax_regimes[].year |
integer | Sim | Ano de referência. |
establishment.tax_regimes[].regime |
string | Não | Regime tributário. |
establishment.tax_regimes[].taxation |
string | Não | Forma de tributação. |
establishment.tax_regimes[].updated_at |
string | Sim | Atualização em UTC. |
establishment.updated_at |
string | Sim | Atualização do estabelecimento em UTC. |
Cada atividade presente em establishment.primary_activity ou establishment.secondary_activities[] possui os campos abaixo. O objeto da atividade pode ser null.
| Campo da atividade | Tipo | Nulo | Descrição |
|---|---|---|---|
code |
string | Não | Código completo da atividade. |
section |
string | Não | Seção. |
division |
string | Não | Divisão. |
group |
string | Não | Grupo. |
class |
string | Não | Classe. |
subclass |
string | Não | Subclasse. |
description |
string | Não | Descrição da atividade. |
Cada país presente em partners[].country ou establishment.address.country possui:
| Campo do país | Tipo | Nulo | Descrição |
|---|---|---|---|
code |
string | Não | Código do país. |
iso2 |
string | Não | Código ISO de duas letras, quando disponível. |
iso3 |
string | Não | Código ISO de três letras, quando disponível. |
name |
string | Não | Nome do país. |
Ausência de dados, falhas e cobrança
Um cadastro não encontrado retorna status: "no_data" e data: null, sem cobrança. Campos desconhecidos dentro de um cadastro válido não transformam a consulta em ausência de dados. Uma resposta inválida, inclusive com documento divergente, ou falha de execução não é apresentada como cadastro inexistente.
Consultas com dados válidos retornam status: "succeeded" e são cobradas pelo preço efetivo da conta. Consulte GET /datasets para verificar preço e disponibilidade.
Este dataset suporta consultas em lote quando batch.enabled está habilitado no catálogo da conta. Cada entrada utiliza este mesmo contrato de dados.
Consulte também autenticação, envelope e recuperação dos resultados e erros.