---
title: "Catálogo de companhias abertas com DFP na CVM"
method: GET
path: "/v1/cvm/companhias"
tags: ["CVM"]
---

# Catálogo de companhias abertas com DFP na CVM

`GET /v1/cvm/companhias`

## 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/cvm/companhias`
- Auth: HTTP bearer

## Query parameters

- `q` string: Trecho da denominação ou prefixo de CNPJ; opcional.
- `limite` integer: Companhias por página, de 1 a 100.
- `cursor` string: Cursor devolvido pela página anterior; opcional.

## Response `200`

Companhias da página e o cursor da próxima.

- AppsApiCvmModelosEnvelopeCatalogo
  - `dados` AppsApiCvmModelosCatalogo, required
    - `companhias` CompanhiaResumo[], required
      - `cnpj` string, required
      - `cd_cvm` string, nullable, required
      - `denominacao` string, nullable, required
      - `empresa` EmpresaResumo, required: `{razao_social, slug, link}` — o ponteiro leve usado dentro de balanços, DREs e documentos.
        - `razao_social` string, required
        - `slug` string, required
        - `link` string, required
    - `proximo_cursor` string, nullable, required
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `parametro_invalido` (limite fora de 1–100, cursor inválido) ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `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)