Reporting periods, revisions and as-of dates
Interpret instant and duration metrics, direct quarters, filing dates and revisions without confusing them with a point-in-time market feed.
Instant versus duration
Balance-sheet metrics such as total assets are instant values measured on a date. Revenue, net income and cash-flow metrics are duration values measured over a period with a start and end. Two values ending on the same date can describe different kinds of period.
Annual and quarterly selection uses the implemented period filters. Fiscal calendars vary, and annual instant values are selected from annual filings; comparable observations may appear in more than one filing.
Directly reported quarters
Quarterly duration results include values directly reported for periods of approximately 70–110 days. FinData does not derive a missing fourth quarter by subtracting other quarters from an annual figure. A missing quarter is not zero.
Latest, history and as_of
The default latest view selects one available observation per period using the latest filing and mapping priority. view=history retains observations by filing accession and period, including later comparative disclosures. A change in a reported value is not necessarily a formal restatement.
as_of=2024-12-31 restricts results to filings dated on or before that day. It is a filing-date cutoff, not an intraday timestamp or a complete historical snapshot of every SEC API response. Mapping version 1.0 is applied to as-of queries; SEC corrections and removals are not fully reconciled.
Ambiguity
Conflicting values for the same selected tag, period and filing are omitted instead of guessed. The aligned-series endpoint can also report ambiguous_metrics for different periods ending on the same date; its null means no unique value is available, not zero.