As-reported financials

GET/api/financials/as-reported

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 key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

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

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8
period string (enum) optional

The period to query data for (annual or quarter).
limit integer optional min 1 · max 80 · default 4

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

Example request

curl 'https://api.stockfit.io/v1/api/financials/as-reported?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Raw financial data as originally reported in SEC filings

Response schema

array of:

period string
The fiscal period end date
fiscalYear integer
The company's fiscal year (handles non-December year-ends — AAPL FY ends Sep, COST FY ends Aug).
fiscalPeriod string (enum)
Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).
Allowed values: FY, Q1, Q2, Q3, Q4, TTM
facts map of string to number
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.
- * (additional properties) number
sources map of string to object
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.
- * (additional properties) object
  - type string
    SEC form type: `10-K`, `10-K/A`, `10-Q`, `10-Q/A`, `20-F`, `20-F/A`, `40-F`, `40-F/A`, or `Q4-Recon` for a synthetic Q4 reconstruction.
  - dateFiled string (date)
    SEC acceptance date of this filing (YYYY-MM-DD). Absent for `Q4-Recon` entries — they're synthetic, not real filings.
  - amendment boolean
    True for /A amendment filings; false for originals and Q4-Recon synthetic entries.
  - facts map of string to object
    Map of curated fact name to metadata about this filing's contribution. Empty object `{}` means this filing supplied the value first (or didn't change it from the prior filing). `{ "before": <number> }` means this filing changed the value — `before` is what the immediately-prior filing in the chain had for this fact. Walk the chronological filings forward to reconstruct the value at any point in time, or follow `before` backward to recover any historical value. Re-tagging with an identical value is omitted (no entry added). May be empty (`{}`) for amendment (`/A`) filings whose values were all unchanged or superseded by a later amendment — the source entry is preserved so the amendment timeline remains visible.
    * (additional properties) object
    before number
    Value of this fact in the immediately-prior filing that supplied it. Present only when this filing CHANGED the value. Absent when this filing was the first to supply it (no prior).

Example response

[
  {
    "period": "2023-09-30",
    "fiscalYear": 2025,
    "fiscalPeriod": {},
    "facts": {
      "us-gaap:NetIncomeLoss": 112010000000,
      "us-gaap:EarningsPerShareDiluted": 7.46,
      "us-gaap:GeneralAndAdministrativeExpense": 8077000000
    },
    "sources": {}
  }
]

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}