Reported Financial Statements (SEC)

The income statement, balance sheet and cash flow a company has reported to the SEC — historical facts.

GET/api/v1/financials/{ticker}

Insider InfoIncluded in every plan · one key.

Overview

Historical financial results the company has already reported to the SEC — not forecasts. Returns normalized annual or quarterly income-statement, balance-sheet and cash-flow observations from official SEC Company Facts, while preserving the original XBRL tag, accession, form, filing date, period and unit. A canonical view resolves comparable metrics such as revenue, net income, assets, operating cash flow and free cash flow; the raw view exposes every supported source tag. Coverage is lazy: an uncached ticker returns HTTP 202 while one free SEC Company Facts JSON is processed in the background. The raw JSON is held only in memory; the server retains a compact compressed profile shared by later users.

Use it toRetrieve revenue, earnings, balance-sheet and cash-flow figures the company has already filed.

This endpoint contains reported historical facts. It is the correct endpoint for Apple revenue or earnings already announced. A first uncached request can return HTTP 202 with `Retry-After: 5`; repeat it after that interval. Company Facts access is free and does not use an LLM. Canonical normalization currently targets US-GAAP; foreign issuers using another taxonomy can expose fewer or no canonical metrics, and the API reports that honestly instead of fabricating values.

Coverage

Universe

US SEC filers

History

Reported periods (historical)

Updates

As filed

Source

SEC EDGAR (official)

Call it

Send your ra_live_… key in the x-api-key header. Pick your language:

curl "https://raspberrytrades.com/api/v1/financials/AAPL?period=annual&metric=revenue&limit=1" \
  -H "x-api-key: ra_live_your_key_here"

Parameters

Parameter	Type	Description
`ticker`	path	Mapped company ticker, e.g. AAPL (required)
`period`	string	annual \| quarterly \| all (optional; default annual)
`view`	string	canonical \| raw (optional; default canonical)
`metric`	string	Comma-separated metric IDs such as revenue, net_income or free_cash_flow (optional)
`statement`	string	income \| balance \| cash_flow (optional)
`limit`	number	Maximum observations per metric (optional, integer 1–50; default 8)
`x-api-key`	header	Any valid Raspberry Trades API key (required)

Example response

200 OK · application/json

{
  "requestedTicker": "AAPL",
  "mappingStatus": "exact",
  "issuer": {
    "cik": "0000320193",
    "entityName": "Apple Inc."
  },
  "query": {
    "period": "annual",
    "view": "canonical",
    "metrics": ["revenue"],
    "statements": [],
    "limitPerMetric": 1
  },
  "count": 1,
  "observations": [
    {
      "metric": "revenue",
      "statement": "income",
      "taxonomy": "us-gaap",
      "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
      "unit": "USD",
      "value": 416161000000,
      "start": "2024-09-29",
      "end": "2025-09-27",
      "accession": "0000320193-25-000079",
      "fiscalYear": 2025,
      "fiscalPeriod": "FY",
      "form": "10-K",
      "filedAt": "2025-10-31",
      "derived": false
    }
  ],
  "source": {
    "source": "sec_company_facts",
    "sourceUrl": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json"
  }
}

Insider Info — related datasets

News SentimentWhether the financial-news headlines on a stock are positive or negative — AI-scored, with links.Market NewsThe latest news driving a whole market — US, gold, BTC, oil… — AI-scored, with links.Insider Trading (SEC)Who's buying or selling their own stock — recent insider trades from official SEC filings.Company Guidance — Future Outlook (SEC)Management's own forecasts for future periods, when the company files them with the SEC.

Get your API key

Create a free account, copy your ra_live_… key and make your first call to https://raspberrytrades.com/api/v1/financials/{ticker}.

Keep your key on your server — never ship it in front-end code.