---
title: "Série trimestral da companhia: BP, trimestre, acumulado e 12 meses"
method: GET
path: "/v1/cvm/companhias/{chave}/trimestres"
tags: ["CVM"]
---

# Série trimestral da companhia: BP, trimestre, acumulado e 12 meses

`GET /v1/cvm/companhias/{chave}/trimestres`

## 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/{chave}/trimestres`
- Auth: HTTP bearer

## Path parameters

- `chave` string, required

## Query parameters

- `desde` string: Data de referência `AAAA-MM-DD` inicial; opcional.
- `ate` string: Data de referência `AAAA-MM-DD` final; opcional.
- `visao` string: `consolidado` ou `individual`. Padrão: consolidado, ou individual quando a companhia não consolida.

## Response `200`

Um ponto por data de referência (decrescente), última versão de cada entrega, em reais. `trimestre` é o publicado; o último do exercício é derivado (DFP menos o acumulado de nove meses, `derivado = true`). `doze_meses` = acumulado corrente + DFP anterior − acumulado do mesmo ponto um ano antes; no fechamento é a DFP.

- EnvelopeTrimestresCVM
  - `dados` TrimestresCVM, required
    - `companhia` 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
    - `visao` string, required
    - `visao_solicitada` string, nullable, required
    - `trimestres` PontoTrimestral[], required
      - `data_referencia` string, required
      - `inicio_exercicio` string, nullable, required
      - `trimestre_exercicio` integer, nullable, required
      - `origem` string, nullable, required
      - `familia` string, nullable, required
      - `link_documento` string, nullable, required
      - `balanco_em_reais` ValoresBalanco, required
        - `ativo_total` union, required
          - integer
          - number
        - `ativo_circulante` union, required
          - integer
          - number
        - `ativo_nao_circulante` union, required
          - integer
          - number
        - `passivo_circulante` union, required
          - integer
          - number
        - `passivo_nao_circulante` union, required
          - integer
          - number
        - `passivo_total` union, required
          - integer
          - number
        - `patrimonio_liquido` union, required
          - integer
          - number
        - `passivo_e_pl_total` union, required
          - integer
          - number
      - `resultado` ResultadosDoPonto, required
        - `trimestre` ResultadoPeriodo, required: Uma DRE da série. `derivado`: o último trimestre do exercício não é publicado (é a DFP menos o acumulado de nove meses). `consistente = false`: na fonte, os trimestres isolados daquele exercício não fecham com o acumulado. `ranqueavel` só existe no `12m`.
          - `valores_em_reais` ValoresDRE, required
            - `receita_bruta` union, required
              - …
            - `receita_liquida` union, required
              - …
            - `custo` union, required
              - …
            - `lucro_bruto` union, required
              - …
            - `lucro_operacional` union, required
              - …
            - `lucro_liquido` union, required
              - …
          - `derivado` boolean, required
          - `consistente` boolean, required
          - `ranqueavel` boolean, nullable, required
          - `documentos_origem` string[], required
        - `acumulado` ResultadoPeriodo, required: Uma DRE da série. `derivado`: o último trimestre do exercício não é publicado (é a DFP menos o acumulado de nove meses). `consistente = false`: na fonte, os trimestres isolados daquele exercício não fecham com o acumulado. `ranqueavel` só existe no `12m`.
          - `valores_em_reais` ValoresDRE, required
            - `receita_bruta` union, required
              - …
            - `receita_liquida` union, required
              - …
            - `custo` union, required
              - …
            - `lucro_bruto` union, required
              - …
            - `lucro_operacional` union, required
              - …
            - `lucro_liquido` union, required
              - …
          - `derivado` boolean, required
          - `consistente` boolean, required
          - `ranqueavel` boolean, nullable, required
          - `documentos_origem` string[], required
        - `doze_meses` ResultadoPeriodo, required: Uma DRE da série. `derivado`: o último trimestre do exercício não é publicado (é a DFP menos o acumulado de nove meses). `consistente = false`: na fonte, os trimestres isolados daquele exercício não fecham com o acumulado. `ranqueavel` só existe no `12m`.
          - `valores_em_reais` ValoresDRE, required
            - `receita_bruta` union, required
              - …
            - `receita_liquida` union, required
              - …
            - `custo` union, required
              - …
            - `lucro_bruto` union, required
              - …
            - `lucro_operacional` union, required
              - …
            - `lucro_liquido` union, required
              - …
          - `derivado` boolean, required
          - `consistente` boolean, required
          - `ranqueavel` boolean, nullable, required
          - `documentos_origem` string[], required
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `chave_companhia_invalida` (nem CNPJ nem código CVM), `parametro_invalido` (visão, período ou data de referência) ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `404`: `companhia_nao_encontrada` — chave válida, sem entrega na CVM.
- `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)