Guides

Analyze financial statements

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

Request annual income statements:

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.