MarkedDocs Financial statements

API reference / Financial statements

Financial statements

Retrieve normalized income statement, balance sheet and cash-flow facts.

GET/v1/financialsOpenAPI ↗

Overview

Financials returns canonical observations extracted from company filings. Each fact carries its concept, reporting period, basis and source context so agents can compare companies without losing the underlying filing.

Coverage

RecordsSourcesUpdated
2.5M+ financial factsNSE and BSE XBRL and filingsNew filings ingested continuously

Parameters

ParameterTypeDescription
tickerrequiredstringCompany ticker or accepted reference
periodstringquarterly, annual or any
basisstringconsolidated or standalone
conceptstringComma-separated canonical concept IDs
as_ofdatetimeOnly facts knowable by this time
limitinteger1–2000; default 500

Getting started

Issue a key

Sign in, choose a plan and create an API key from your workspace dashboard.

Send the request

Call /v1/financials with X-API-Key or an Authorization bearer token.

Read data and metadata

Use data for records and meta for timestamps, counts and request context.

Implementation notes

  • Use as_of for backtests and historical research to avoid look-ahead bias.
  • Some filings do not expose enough period metadata to classify a fact as annual or quarterly; period=any includes those observations.

Marked provides market data, not financial advice. Verify material decisions against the authoritative source.