FocusAlphaDocs
Get key
API Reference

Combined Segments

The all-in-one route of the segmented-financials family. Returns one row per reporting period with the segment payloads nested under each statement — so you can fetch a company's full segment picture in a single call.

GET/v1/financials/segments?ticker={ticker}

Returns a segmented_financials array, newest period first. Each row carries the same seven identifying scalars as the per-statement routes, plus three statement keys. Only income_statement is populated; balance_sheet and cash_flow_statement are always null (segments are disclosed on the income statement) but the keys are always present.

Same data, nested shape
The income_statement object is the identical metric→axis→member payload documented on Income segments — here it’s nested under a statement key rather than spread onto the row. Query parameters and the error contract are identical across all four segmented routes.

Row shape#

ticker · report_period · fiscal_period · period · currency · accession_number · filing_urlscalarsoptional
The same seven identifying fields as the per-statement routes — see Income segments.
income_statementobject | nulloptional
The metric→axis→member segment payload (e.g. revenue.product[]). Populated when the company discloses segments.
balance_sheetnulloptional
Always null (parity).
cash_flow_statementnulloptional
Always null (parity).

Example request#

curlbash
curl "https://api.focusalpha.ai/v1/financials/segments?ticker=AAPL&period=annual&limit=1" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

Example response#

segmented-financials.jsonjson
{
  "segmented_financials": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-27",
      "fiscal_period": "FY2025",
      "period": "annual",
      "currency": "USD",
      "accession_number": "0000320193-25-000079",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
      "income_statement": {
        "revenue": {
          "product": [
            { "label": "iPhone", "value": 209586000000 },
            { "label": "Services", "value": 96169000000 }
          ],
          "segment": [
            { "label": "Americas", "value": 178353000000 },
            { "label": "Europe", "value": 111032000000 }
          ]
        }
      },
      "balance_sheet": null,
      "cash_flow_statement": null
    }
  ]
}

Errors#

Same contract as the rest of the family: 400 / 401 / 402 / 404 / 503, with the bare { error, message } envelope — see Errors.