Financial statements endpoint

Endpoint

GET https://tgmcharts.com/api/v1/statements/{symbol}/{statement} serves raw, as-filed statement rows from SEC EDGAR XBRL company facts — public-domain lineage end to end. {statement} is one of income-statement, balance-sheet, cash-flow. Keyless and CORS-open.

curl -s "https://tgmcharts.com/api/v1/statements/AAPL/income-statement?years=5"

curl -s "https://tgmcharts.com/api/v1/statements/KO/cash-flow?period=quarterly&years=3&format=csv" -o ko-cash-flow-quarterly.csv

Response shape

A type sketch. Rows are newest first; every catalogue concept appears on every row, with null where the filer tagged nothing for that period — never a zero.

{
  "symbol": "AAPL",
  "entityName": string | null,
  "cik": string | null,
  "statement": "income-statement" | "balance-sheet" | "cash-flow",
  "period": "annual" | "quarterly",
  "currency": "USD",
  "source": "SEC EDGAR XBRL company facts (public domain)",
  "asOf": ISO date-time | null,        // last EDGAR ingestion for this symbol
  "methodology": string,
  "status": "preparing" | "unavailable",   // ABSENT when rows are served
  "reason": string,                    // with status: unavailable
  "note": string,                      // honest-state explanation
  "concepts": [ { "key": string, "label": string, "unit": "USD" | "USD/shares" | "shares", "tags": string[] }, … ],
  "rows": [                            // newest first; null while status is set
    {
      "fiscalYear": integer,
      "fiscalPeriod": "FY" | "Q1" | "Q2" | "Q3" | "Q4",
      "periodStart": "YYYY-MM-DD" | null,   // null for balance-sheet instants
      "periodEnd": "YYYY-MM-DD",
      "form": "10-K" | "10-Q" | … | null,   // the most recently filed fact on the row
      "filed": "YYYY-MM-DD" | null,
      "metrics": { "<concept key>": number | null, … },
      "provenance": {
        "<concept key>": { "tag": string, "accn": string, "form": string, "filed": "YYYY-MM-DD",
                           "derived": "ytd-differencing", "inputs": [accn, accn] }   // derived/inputs on derived quarters only
      }
    }
  ],
  "links": { "page": string, "docs": string, "openapi": string }
}

Per-value provenance

• provenance[key].tag — the us-gaap tag that produced the value (one winning tag per concept per symbol; the priority lists are below).
• provenance[key].accn, form, filed — the accession number, form type and filing date of the filing the value was taken from. Latest-filed wins per period, so a restated figure supersedes the original.
• provenance[key].derived: "ytd-differencing" with inputs: [accn, accn] — a quarter the filer did not tag discretely (Q4 generally; Q2–Q3 for cash-flow items, which 10-Qs tag year-to-date) was derived by differencing two same-tag, same-fiscal-year facts, and both source accessions are disclosed. Derivation is withheld when a surrounding filing restates prior periods.
• Per-share values and share counts are never derived, and per-share values are as filed — not adjusted for later stock splits.

Preparing and unavailable states

• status: "preparing" (HTTP 200, rows: null, short s-maxage=120 cache) — the symbol is covered by the site but its SEC EDGAR data has not been ingested yet. No value is substituted from any other source in the meantime.
• status: "unavailable" with a reason (HTTP 200, daily cache) — the security has no usable us-gaap/USD company facts: typically an ETF or trust, or a filer reporting under IFRS or in a non-USD currency. This is a stable, periodically re-checked state, not a pending one.
• 404 — the symbol is not covered at all (onboarding hint), or the statement slug is unknown (the body lists the three valid ones).
• rows: [] with a note — ingested, but no XBRL fact mapped to this statement's concepts.

Methodology (served verbatim on every response)

Values as filed with the SEC (XBRL company facts, public domain), selected latest-filed per period; the winning us-gaap tag, accession number, and filing date are recorded per value in provenance. Quarters not filed discretely (Q4 generally; Q2-Q3 for cash-flow items, which 10-Qs tag year-to-date only) are derived solely by differencing two same-tag, same-fiscal-year facts and are marked derived with both source accessions; derivation is withheld when a surrounding filing restates prior periods. Per-share values are as filed and NOT adjusted for subsequent stock splits. Missing data is null — never zero-filled, never backfilled from any other source.

Income statement concepts

The metrics keys served for income-statement, with the us-gaap tags tried in priority order. Generated from the concept catalogue the ingestion lane uses. For revenue the priority is applied per period (Revenues first, then the ASC 606 tags), so filers that tag both never have the narrower contract-revenue subset served as total revenue.

Balance sheet concepts

The metrics keys served for balance-sheet, with the us-gaap tags tried in priority order. Generated from the concept catalogue the ingestion lane uses.

Cash-flow statement concepts

The metrics keys served for cash-flow, with the us-gaap tags tried in priority order. Generated from the concept catalogue the ingestion lane uses.

CSV format

Empty cells are nulls. A # status: comment line appears on preparing/unavailable bodies so a downloaded file is never mistaken for data.

# TGMCharts — AAPL income-statement (annual, SEC EDGAR XBRL)
# source: SEC EDGAR XBRL company facts (public domain)
# as of: <ISO date-time>
# methodology: <the methodology above>
# terms: https://tgmcharts.com/terms — attribution required (data by TGMCharts, tgmcharts.com; underlying facts: SEC EDGAR, public domain)
fiscalYear,fiscalPeriod,periodEnd,form,filed,revenue,costOfRevenue,grossProfit,…
<FY>,FY,<YYYY-MM-DD>,10-K,<YYYY-MM-DD>,<number or empty>,…