---
title: "Ficha cadastral e panorama de dados da empresa"
method: GET
path: "/v1/empresas/{chave}"
tags: ["Empresas"]
---

# Ficha cadastral e panorama de dados da empresa

`GET /v1/empresas/{chave}`

## Request

- Base URL: `https://api.balancos.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.balancos.ai/v1/empresas/{chave}`
- Auth: HTTP bearer

## Path parameters

- `chave` string, required

## Response `200`

Ficha da empresa.

- AppsApiModelosEnvelopeFicha
  - `dados` AppsApiModelosFicha, required
    - `empresa` Empresa, required: Ficha cadastral completa (`GET /empresas/{chave}`).
      - `razao_social` string, required
      - `nome_fantasia` string, nullable, required
      - `cnpj` string, nullable, required
      - `slug` string, required
      - `setor` string, nullable, required
      - `porte` string, nullable, required
      - `uf` string, nullable, required
      - `municipio` string, nullable, required
      - `cnae_principal` string, nullable, required
      - `cnae_descricao` string, nullable, required
      - `natureza_juridica` string, nullable, required
      - `situacao_cadastral` string, nullable, required
      - `capital_social` union, required
        - integer
        - number
      - `publicacoes_total` integer, nullable, required
      - `publicacoes_financeiras` integer, nullable, required
      - `ultima_publicacao` string, nullable, required
      - `anos_com_balanco` integer[], required
      - `anos_com_dre` integer[], required
      - `link` string, required
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `chave_empresa_invalida` (nem slug nem CNPJ), `parametro_invalido` ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `404`: `empresa_nao_encontrada` — chave válida, empresa fora do gold.
- `429`: `limite_excedido` (cota da conta) ou `limite_ip` (piso por IP).
- `503`: `indisponivel` — gold ou Supabase fora, ou falha ao concluir a medição.

---

[API](https://skmtc.dev/balancos/apis/balancos-ai-api-publica.md) · [All operations](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/llms.txt) · [OpenAPI document](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/revisions/389d7f383cb5?raw)