Bases de dados

Registros de uma base

Linhas das bases da CVM por entidade: carteiras de fundos (cda), informes de FII e FIDC, demonstrações (dfp, itr), formulário de referência (fre) e cadastro de companhias (fca).

GEThttps://api.fintay.com.br/v1/datasets/{dataset}/records

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

datasetstringobrigatório

cda, fii, fidc, dfp, itr, fre ou fca.

Valores aceitos:cdafiifidcdfpitrfrefca

Parâmetros de consulta

entitystringobrigatório

CNPJ da companhia ou do fundo.

reference_datestring · date

Data de referência.

sectionstring

Seção da base.

all_versionsbooleanpadrão: false

Inclui versões reapresentadas.

limitintegerpadrão: 100mín. 1 · máx. 1000

Máximo de linhas.

offsetintegerpadrão: 0mín. 0

Linhas a pular.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

archive_idstring

Exemplo: 05c307b6-bc2a-46ed-9d3d-35269fc775b1

sectionstring

Exemplo: fre_cia_aberta_2026.csv

row_numberinteger

Exemplo: 1166

entity_identifierstring

Exemplo: 33000167000101

reference_datestring

Exemplo: 2026-12-31

document_versioninteger

Exemplo: 12

document_idstring

Exemplo: 161309

payloadobject

source_urlstring

Exemplo: https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/FRE/DADOS/fre_

retrieved_atstring

Exemplo: 2026-09-22T00:03:53.555627+00:00

latest_versioninteger

Exemplo: 12

GETRegistros de uma base

curl "https://api.fintay.com.br/v1/datasets/fre/records?entity=33000167000101&limit=1" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "archive_id": "05c307b6-bc2a-46ed-9d3d-35269fc775b1",
        "section": "fre_cia_aberta_2026.csv",
        "row_number": 1166,
        "entity_identifier": "33000167000101",
        "reference_date": "2026-12-31",
        "document_version": 12,
        "document_id": "161309",
        "payload": {
          "CD_CVM": "009512",
          "ID_DOC": "161309",
          "VERSAO": "12",
          "CNPJ_CIA": "33.000.167/0001-01",
          "DT_RECEB": "2026-09-11",
          "DT_REFER": "2026-12-31",
          "LINK_DOC": "http://www.rad.cvm.gov.br/ENETCONSULTA/frmDownloadDocumento.aspx?CodigoInstituicao=1&NumeroSequencialDocumento=161309",
          "CATEG_DOC": "FRE WEB",
          "DENOM_CIA": "PETROLEO BRASILEIRO S.A. PETROBRAS"
        },
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/FRE/DADOS/fre_cia_aberta_2026.zip",
        "retrieved_at": "2026-09-22T00:03:53.555627+00:00",
        "latest_version": 12
      }
    ],
    "has_more": true,
    "offset": 0,
    "quality": {
      "quarantined_rows_in_dataset": 2,
      "partial": true
    },
    "note": "Cobertura parcial: 2 registros da base em quarentena.",
    "version_policy": "latest_in_current_archive"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}