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

# Analyze financial statements

> Retrieve normalized US income, balance-sheet, and cash-flow statements.

Request annual income statements:

```bash theme={"dark"}
curl "https://corpus-api.onera.app/us/financials/income-statements?ticker=AAPL&limit=4" \
  --header "X-API-KEY: $CORPUS_API_KEY"
```

The response uses stable canonical fields such as `revenue`, `gross_profit`, `operating_income`, and `net_income`. Each statement retains its report period, accession, filing URL, filing date, and acceptance time.

Use these companion endpoints when needed:

* `/us/financials` returns all three normalized statement types.
* `/us/financials/as-reported` preserves issuer labels and presentation hierarchy.
* `/us/fundamentals/ledger` returns raw XBRL facts, including unmapped concepts and amendments.

Pin `as_of` when comparing records through time, and store `normalization_version` with derived analysis.