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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`period_type`	string (default `annual`)	`quarterly` or `annual`
`include_segments`	boolean (default `true`)	Include dimensional breakdowns

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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`period_type`	string (default `annual`)	`quarterly` or `annual`
`include_segments`	boolean (default `true`)	Include dimensional breakdowns

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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`period_type`	string (default `annual`)	`quarterly` or `annual`
`include_segments`	boolean (default `true`)	Include dimensional breakdowns

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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`period_type`	string (default `annual`)	`quarterly` or `annual`
`include_segments`	boolean (default `true`)	Include dimensional breakdowns

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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`period_type`	string (default `annual`)	`quarterly` or `annual`

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.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK
`statement`	string	Filter to one statement: `income_statement`, `balance_sheet`, or `cash_flow`. Omit for all three.

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": [...] }
  }
}

GET /v1/companies/{identifier}/ratios#

Tier: Professional

Financial ratios derived from the latest annual statements, grouped into profitability, returns, liquidity, and leverage.

Parameter	Type	Description
`identifier`	string (path)	Company ticker or CIK

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

{
  "company": { "cik": "0000320193", "ticker": "AAPL", "name": "APPLE INC" },
  "ratios": {
    "profitability": { "gross_margin": 0.442, "operating_margin": 0.298, "ebitda_margin": 0.331, "net_margin": 0.253, "fcf_margin": 0.279 },
    "returns": { "roe": 1.472, "roa": 0.223 },
    "liquidity": { "current_ratio": 0.988, "quick_ratio": 0.831 },
    "leverage": { "debt_to_equity": 4.95, "debt_to_assets": 0.826, "net_debt_to_ebitda": 0.512 }
  },
  "metadata": { "data_source": "r2-parquet", "processed_at": "2026-07-13T00:00:00.000Z" }
}

Ratios are decimals, not percentages — a gross_margin of 0.442 is 44.2%. Any individual ratio is null when the underlying concept is missing or its denominator is zero.

Returns 404 with { "error": "Company not found", "identifier": ... } for an unknown company, or { "error": "No annual financial statements found", "cik": ... } when the company has no annual data to derive ratios from.