---
title: "Obter dados da empresa"
method: GET
path: "/api/v1/brazilian_companies/{cnpj}/company"
tags: ["Empresas Brasileiras"]
---

# Obter dados da empresa

`GET /api/v1/brazilian_companies/{cnpj}/company`

## Request

- Base URL: `https://app.oportunidados.com.br`
- URL: `https://app.oportunidados.com.br/api/v1/brazilian_companies/{cnpj}/company`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_token`

Ficha cadastral de uma empresa brasileira pelo CNPJ: `company` (48 chaves; `numero_funcionarios` só quando EmployeeCountFeature.available_for_company?), `socios`, `contatos_extras` e `contexto`.

Autenticação: `Authorization: Bearer <token_digest>` (preferida) ou query `api_token` (legado). Recusas 401/403/404/429 usam o JSON literal dos concerns. Quota mensal e limite por minuto vêm do plano da conta.

`contexto.obras` só entra quando o total de CNO é maior que zero. Subconsultas de contexto podem devolver null.

## Query parameters

- `api_token` string

## Response `200`

sucesso

- object
  - `company` Company, required
    - `cnpj` string, required: CNPJ da empresa, 14 posições, zero-padded
    - `razao_social` string, nullable, required: Razão social
    - `nome_fantasia` string, nullable, required: Nome fantasia
    - `cnae_fiscal` string, nullable, required: CNAE fiscal principal
    - `cnaes_secundarios` string[], nullable, required: CNAEs secundários (jsonb)
    - `data_inicio_atividade` string, date, nullable, required: Data de início de atividade
    - `situacao_cadastral` string, nullable, required: Situação cadastral
    - `data_situacao` string, date, nullable, required: Data da situação cadastral
    - `motivo_situacao` string, nullable, required: Motivo da situação cadastral (traduzido)
    - `natureza_juridica` string, nullable, required: Natureza jurídica (traduzida)
    - `cod_nat_juridica` string, nullable, required: Código da natureza jurídica
    - `capital_social` number, float, nullable, required: Capital social
    - `porte` string, nullable, required: Porte da empresa
    - `faturamento` string, required: Faixa de faturamento (`DataMaps::CnpjRevenueRanges[porte]`, ou "Não disponível")
    - `opc_simples` string, nullable, required: Optante pelo Simples Nacional
    - `data_opc_simples` string, date, nullable, required: Data de opção pelo Simples
    - `data_exc_simples` string, date, nullable, required: Data de exclusão do Simples
    - `opc_mei` string, nullable, required: Optante pelo MEI
    - `data_opc_mei` string, date, nullable, required: Data de opção pelo MEI
    - `data_exc_mei` string, date, nullable, required: Data de exclusão do MEI
    - `situacao_especial` integer, nullable, required: Código de situação especial
    - `data_sit_especial` string, date, nullable, required: Data da situação especial
    - `matriz_filial` string, nullable, required: Tipo de estabelecimento
    - `tipo_logradouro` string, nullable, required: Tipo de logradouro
    - `logradouro` string, nullable, required: Nome do logradouro
    - `numero` string, nullable, required: Número
    - `complemento` string, nullable, required: Complemento
    - `bairro` string, nullable, required: Bairro
    - `cep` string, nullable, required: CEP
    - `uf` string, nullable, required: UF
    - `cod_municipio` string, nullable, required: Código SIAFI do município
    - `municipio` string, required: Nome do município
    - `ddd_1` string, nullable, required: DDD do telefone 1
    - `telefone_1` string, nullable, required: Telefone 1
    - `ddd_2` string, nullable, required: DDD do telefone 2
    - `telefone_2` string, nullable, required: Telefone 2
    - `ddd_3` string, nullable, required: DDD do telefone 3
    - `telefone_3` string, nullable, required: Telefone 3
    - `email` string, nullable, required: Email
    - `has_email` boolean, nullable, required: Possui email cadastrado
    - `has_website` boolean, nullable, required: Possui website cadastrado
    - `qualif_resp` integer, nullable, required: Código de qualificação do responsável
    - `cod_pais` integer, nullable, required: Código do país
    - `nm_cidade_exterior` string, nullable, required: Nome da cidade no exterior
    - `raiz_cnpj` string, required: Raiz do CNPJ (8 primeiros caracteres, zero-padded)
    - `regime_tributario` union, required: Regime tributário traduzido (`DataMaps::CnpjFiscalRegimes`); nil se vazio; código desconhecido devolve o Integer original (fallback)
      - string, nullable
      - integer
    - `ano_regime_tributario` integer, nullable, required: Ano do regime tributário
    - `escrituracoes_regime_tributario` integer, nullable, required: Quantidade de escrituracões do regime tributário
    - `numero_funcionarios` string: Texto de `employees_count_info`. Chave presente só quando EmployeeCountFeature.available_for_company? é verdadeiro.
  - `socios` Socio[], required
    - `nome_socio` string, nullable, required: Nome do sócio
    - `cnpj_cpf_socio` string, nullable, required: Documento do sócio. Pessoa física: CPF mascarado no formato da Receita (`***456789**`) ou null; o CPF completo nunca sai. Pessoa jurídica: CNPJ completo
    - `cod_qualificacao` string, nullable, required: Código de qualificação
    - `qualificacao_socio` string, nullable, required: Qualificação do sócio (traduzida)
    - `tipo_socio` string, nullable, required: Tipo de sócio (código)
    - `tipo_socio_descricao` string, nullable, required: Tipo de sócio (descrição)
    - `data_entrada` string, date, nullable, required: Data de entrada na sociedade
    - `cod_pais_ext` string, nullable, required: Código do país (se estrangeiro)
    - `pais_exterior` string, nullable, required: Nome do país (traduzido)
    - `nome_repres` string, nullable, required: Nome do representante legal
    - `cpf_repres` string, nullable, required: CPF do representante legal, mascarado no formato da Receita (`***456789**`) ou null; o CPF completo nunca sai
    - `cod_qualif_repres` string, nullable, required: Código de qualificação do representante
    - `qualificacao_representante` string, nullable, required: Qualificação do representante (traduzida)
    - `faixa_etaria` string, nullable, required: Faixa etária
  - `contatos_extras` ContatoExtra[], required
    - `cnpj` string, nullable, required: CNPJ de origem do contato: a consulta traz os contatos de todos os estabelecimentos da raiz e os que a sua empresa cadastrou
    - `tipo_contato` string, nullable, required: Tipo de contato: `email`, `phone` ou `url` (`field_name`)
    - `tipo_website` string, nullable, required: Para `url`: `website` ou o nome da rede (ex.: `facebook`, `instagram`, `linkedin`); null para e-mail e telefone (`url_type`)
    - `contato` string, nullable, required: Valor do contato (`value`)
  - `contexto` Contexto, required
    - `empresas_mesmo_cnae_cidade` integer, nullable, required: Quantidade de empresas ativas no mesmo CNAE e município; null se a subconsulta falhar ou faltar agrupamento
    - `ranking_capital_cidade_cnae` object, nullable, required
      - `posicao` integer, required
      - `total` integer, required
    - `similares` object[], nullable, required
      - `cnpj` string, required
      - `razao_social` string, nullable, required
      - `nome_fantasia` string, nullable, required
    - `obras` object
      - `total` integer, required
      - `ativas` integer, required

## Other responses

- `401`: não autorizado
- `403`: proibido
- `404`: não encontrado
- `429`: muitas requisições

---

[API](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1.md) · [All operations](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/revisions/0af33d72cdb4?raw)