Sign In

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.