Financial Data

XBRL-derived financial statements, key metrics, and trailing-twelve-months (TTM) endpoints. All endpoints live under https://api.edgar.tools/v1 and require Professional tier.

Data is read from R2 Parquet (no Railway dependency).

GET /v1/companies/{identifier}/financial-data

Tier: Professional

All-in-one endpoint returning income statement, balance sheet, and cash flow in a single response. Use individual endpoints when you only need one statement to reduce payload size.

curl "https://api.edgar.tools/v1/companies/AAPL/financial-data?period_type=annual" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "period_type": "annual",
  "income_statement": { "revenue": [...], "net_income": [...] },
  "balance_sheet": { "total_assets": [...], "total_liabilities": [...] },
  "cash_flow": { "operating": [...], "investing": [...], "financing": [...] }
}

GET /v1/companies/{identifier}/income-statement

Tier: Professional

Income statement data for a company.

curl "https://api.edgar.tools/v1/companies/AAPL/income-statement" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "period_type": "annual",
  "income_statement": {
    "revenue": [{ "period": "2024", "value": 383285000000, "unit": "USD" }],
    "net_income": [{ "period": "2024", "value": 93736000000, "unit": "USD" }]
  }
}

GET /v1/companies/{identifier}/balance-sheet

Tier: Professional

Balance sheet data for a company.

curl "https://api.edgar.tools/v1/companies/AAPL/balance-sheet" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "period_type": "annual",
  "balance_sheet": {
    "total_assets": [{ "period": "2024", "value": 352583000000, "unit": "USD" }],
    "total_liabilities": [{ "period": "2024", "value": 290437000000, "unit": "USD" }]
  }
}

GET /v1/companies/{identifier}/cash-flow

Tier: Professional

Cash flow statement data for a company.

curl "https://api.edgar.tools/v1/companies/AAPL/cash-flow" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "period_type": "annual",
  "cash_flow": {
    "operating": [{ "period": "2024", "value": 118254000000, "unit": "USD" }],
    "investing": [{ "period": "2024", "value": -7077000000, "unit": "USD" }],
    "financing": [{ "period": "2024", "value": -108807000000, "unit": "USD" }]
  }
}

GET /v1/companies/{identifier}/metrics

Tier: Professional

Key financial metrics with calculated ratios.

curl "https://api.edgar.tools/v1/companies/AAPL/metrics" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "metrics": {
    "revenue": 383285000000,
    "net_income": 93736000000,
    "total_assets": 352583000000,
    "profit_margin": 0.2445,
    "return_on_assets": 0.2659
  },
  "period_type": "annual"
}

GET /v1/companies/{identifier}/financials/ttm

Tier: Professional

Trailing-twelve-months (TTM) financial data. Aggregates the most recent four quarters for an up-to-date annual view.

How TTM works. Income statement and cash flow values are computed as the rolling sum of the latest four quarters. Balance sheet returns the latest quarter's snapshot.

curl "https://api.edgar.tools/v1/companies/AAPL/financials/ttm" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "company": { "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc." },
  "period": "TTM",
  "statements": {
    "income_statement": {
      "title": "Consolidated Statements of Income",
      "line_items": [
        { "label": "Revenue", "tag": "Revenues", "value": 391035000000, "units": "USD", "level": 0, "is_total": false },
        { "label": "Net Income", "tag": "NetIncome", "value": 96995000000, "units": "USD", "level": 0, "is_total": true }
      ]
    },
    "balance_sheet": { "title": "...", "line_items": [...] },
    "cash_flow": { "title": "...", "line_items": [...] }
  }
}