latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

Financials

As-reported financials

Returns raw XBRL financial facts exactly as filed with the SEC, without any normalization or mapping. Includes both standard US-GAAP taxonomy facts and company-specific custom extension facts. Useful for accessing the full set of reported line items.

get/api/financials/as-reported

Query parameters

symbolstring

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

period'annual' | 'quarter'

Base reporting period: annual or quarter (the periods companies actually report, without the derived ttm rollup).

The period to query data for (annual or quarter).

limitinteger

Maximum number of periods to return (may be clamped by subscription tier).

Response

Raw financial data as originally reported in SEC filings

periodstring

The fiscal period end date

fiscalYearinteger

The company's fiscal year (handles non-December year-ends — AAPL FY ends Sep, COST FY ends Aug).

fiscalPeriod'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'TTM'

Fiscal period of a reported value: FY (annual), Q1-Q4 (quarterly), or TTM (trailing twelve months).

factsobject

Flat key-value pairs of financial metrics. Keys are namespace-prefixed XBRL concept names (e.g. us-gaap:NetIncomeLoss, aapl:MachineryEquipmentAndInternalUseSoftwareNet). Includes both standard US-GAAP and company-specific custom extensions. Values are exactly as filed — for foreign private issuers they may be in the issuer's own reporting currency, and a single filing can carry more than one currency, so do not assume USD here. Use the curated income-statement / balance-sheet / cash-flow-statement endpoints for USD-normalized values.

sourcesFactSources

Map of SEC accession number to the filing's metadata and the list of curated fact names that filing supplied to this period. Combines provenance (which filing supplied each value) with the audit trail of restatements. Facts synthesized from other facts in the same period (e.g. grossProfit = revenue - costOfRevenue) are absent from this map and instead listed under derived. Q4 values reconstructed from cumulative period facts use a self-documenting synthetic key — Q4-Recon-FY-9M, Q4-Recon-FY-H1-Q3, or Q4-Recon-FY-Q1-Q2-Q3 — with type: "Q4-Recon" and no dateFiled (the matching 10-K's dateFiled is on the period entry's top-level dateFiled field). Pruning rules: non-amendment filings that supplied no surviving fact value are dropped (their existence is already conveyed by the period's top-level dateFiled). Amendment filings (/A) are always included even when their facts were all superseded by a later amendment — their facts may be empty, but their existence is itself the audit signal needed to reconstruct point-in-time data between filing dates. Combine sources[accession].facts (which values came from this filing) with sources[accession].dateFiled (when each became public) to reconstruct point-in-time data and detect restatements.

Example response

[
  {
    "period": "2023-09-30",
    "fiscalYear": 2025,
    "fiscalPeriod": "FY",
    "facts": {
      "us-gaap:NetIncomeLoss": 112010000000,
      "us-gaap:EarningsPerShareDiluted": 7.46,
      "us-gaap:GeneralAndAdministrativeExpense": 8077000000
    },
    "sources": {
      "0000320193-22-000108": {
        "type": "10-K",
        "dateFiled": "2022-10-28",
        "amendment": false,
        "facts": {
          "revenue": {},
          "costOfRevenue": {},
          "netIncome": {},
          "eps": {}
        }
      },
      "0000320193-23-000063": {
        "type": "10-K",
        "dateFiled": "2023-02-15",
        "amendment": true,
        "facts": {
          "interestExpense": {
            "before": 2931000000
          }
        }
      }
    }
  }
]