Empresas

Demonstrativo em colunas

Uma demonstração em formato de planilha: contas nas linhas e períodos nas colunas, pronta para análise horizontal.

GEThttps://api.fintay.com.br/v1/companies/{cnpj}/statements/comparison

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de rota

cnpjstringobrigatório

CNPJ da companhia.

Parâmetros de consulta

statementstringpadrão: BPA

Demonstração: balanço, resultado ou fluxo de caixa.

scopestringpadrão: consolidated

Consolidado ou individual.

Valores aceitos:consolidatedindividual

periodsintegerpadrão: 6mín. 2 · máx. 200

Quantidade de períodos.

startstring · date

endstring · date

frequencystringpadrão: quarter

Anual ou trimestral.

Valores aceitos:quarteryear

qstring

Filtra contas pelo nome.

limitintegerpadrão: 60mín. 1 · máx. 250

offsetintegerpadrão: 0mín. 0

Resposta

Envelope { success, data, meta }. Campos de data:

cnpjstring

Exemplo: 33000167000101

scopestring

Exemplo: consolidated

statementstring

Exemplo: BPA

frequencystring

Exemplo: quarter

columnsobject[]

rowsobject[]

has_moreboolean

Exemplo: true

offsetinteger

Exemplo: 0

total_rowsinteger

Exemplo: 68

availableobject[]

flow_statementboolean

Exemplo: false

notestring

Exemplo: Valores normalizados para unidade monetária. Em fluxos, trim

GETDemonstrativo em colunas

curl "https://api.fintay.com.br/v1/companies/33000167000101/statements/comparison?periods=3&limit=5" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "cnpj": "33000167000101",
    "scope": "consolidated",
    "statement": "BPA",
    "frequency": "quarter",
    "columns": [
      {
        "key": "2025-12-31",
        "reference_date": "2025-12-31",
        "dataset": "dfp",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/DFP/DADOS/dfp_cia_aberta_2025.zip"
      },
      {
        "key": "2026-03-31",
        "reference_date": "2026-03-31",
        "dataset": "itr",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/DADOS/itr_cia_aberta_2026.zip"
      },
      {
        "key": "2026-06-30",
        "reference_date": "2026-06-30",
        "dataset": "itr",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/DADOS/itr_cia_aberta_2026.zip"
      }
    ],
    "rows": [
      {
        "account_code": "1",
        "account_name": "Ativo Total",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 1223389000000,
            "quarter_value": 1223389000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 1246068000000,
            "quarter_value": 1246068000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 1279019000000,
            "quarter_value": 1279019000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      },
      {
        "account_code": "1.01",
        "account_name": "Ativo Circulante",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 140026000000,
            "quarter_value": 140026000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 140533000000,
            "quarter_value": 140533000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 154971000000,
            "quarter_value": 154971000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      },
      {
        "account_code": "1.01.01",
        "account_name": "Caixa e Equivalentes de Caixa",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 35608000000,
            "quarter_value": 35608000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 34294000000,
            "quarter_value": 34294000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 33560000000,
            "quarter_value": 33560000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      }
    ],
    "has_more": true,
    "offset": 0,
    "total_rows": 68,
    "available": [
      {
        "scope": "consolidated",
        "statement": "BPA",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      },
      {
        "scope": "consolidated",
        "statement": "BPP",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      },
      {
        "scope": "consolidated",
        "statement": "DFC_MI",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      }
    ],
    "flow_statement": false,
    "note": "Valores normalizados para unidade monetária. Em fluxos, trimestre isolado é a diferença entre acumulados adjacentes; permanece vazio quando não há base comparável. Saldos patrimoniais são posições na data."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}