> ## Documentation Index
> Fetch the complete documentation index at: https://doc.prometheus.services/llms.txt
> Use this file to discover all available pages before exploring further.

# Data semantics

> What the numbers mean — vintages, derived quarters, gaps, and provenance.

## Vintages

`/financials` returns the **latest restated** values by default, because that is what a
later filing says the period was. Pass `reporting_basis=as_reported` to get what the
company originally filed.

Macro series are **bitemporal**: the value for a date is what was known *on that date*.
A backtest against this API never sees a revision before it happened.

## Missing is not zero

A null line means the serving gate withheld it or the company never reported it. Treat it
as unavailable — never as 0, and never fill it with an estimate presented as data.

## Derived Q4

Most US filers do not file a Q4 10-Q; the fourth quarter is derived (annual total minus
the first three quarters) and marked as derived in the payload.

## Provenance

Company financials come from SEC EDGAR XBRL, reconciled against the SEC companyfacts API,
and pass per-company invariant batteries before being served. Macro data is FRED/ALFRED
with full revision vintages. Transcripts come from licensed providers.

For any figure you plan to quote, call `/companies/{id}/fact-source` — it returns the XBRL
concept, the filing accession number, and the calculation tree behind the line. Put the
accession next to the number.

<Note>
  Nothing served by this API is investment advice. See the
  [disclosures](https://www.prometheus.services/terms#not-advice).
</Note>