---
title: "Uma entrega de ITR: versões, demonstrações disponíveis, revisão e capital"
method: GET
path: "/v1/cvm/itrs/{id_doc}"
tags: ["CVM"]
---

# Uma entrega de ITR: versões, demonstrações disponíveis, revisão e capital

`GET /v1/cvm/itrs/{id_doc}`

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

## Path parameters

- `id_doc` string, required

## Response `200`

A entrega identificada pelo ID_DOC da CVM.

- EnvelopeEntrega
  - `dados` EntregaDados, required
    - `entrega` Entrega, required
      - `id_doc` string, required
      - `exercicio` integer, required
      - `data_referencia` string, required
      - `versao` integer, required
      - `link_documento` string, 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
      - `reapresentacao` boolean, required
      - `recebida_em` string, nullable, required
      - `link_cvm` string, nullable, required
      - `escala_publicada` string, nullable, required
      - `moeda` string, nullable, required
      - `visoes` string[], required
      - `demonstracoes_disponiveis` DemonstracoesDisponiveis, required
        - `consolidado` string[]
        - `individual` string[]
      - `parecer` string, nullable, required
      - `capital_social` CapitalSocial, required
        - `exercicio` integer, required
        - `versao` integer, required
        - `integralizado` CapitalAcoes, required
          - `ordinarias` union, required
            - integer
            - number
          - `preferenciais` union, required
            - integer
            - number
          - `total` union, required
            - integer
            - number
        - `tesouraria` CapitalAcoes, required
          - `ordinarias` union, required
            - integer
            - number
          - `preferenciais` union, required
            - integer
            - number
          - `total` union, required
            - integer
            - number
      - `versoes` Versao[], required
        - `id_doc` string, required
        - `versao` integer, required
        - `reapresentacao` boolean, required
        - `recebida_em` string, nullable, required
        - `parecer` string, nullable, required
        - `link_cvm` string, nullable, required
        - `link_documento` string, required
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `parametro_invalido` (visão ou demonstração) ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `404`: `entrega_nao_encontrada` (ID_DOC sem entrega DFP) ou `demonstracao_nao_encontrada` (demonstração ou visão que a entrega não tem).
- `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)
