---
title: "Equity Segment Financials"
method: GET
path: "/gateway/v1/equity/segments"
tags: ["Equity"]
---

# Equity Segment Financials

`GET /gateway/v1/equity/segments`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/equity/segments`
- Auth: HTTP bearer

Returns provider-reported product and operating/geographic segment facts for a US-listed equity. Provider labels and missing-value status are preserved; segment values are not added across incompatible dimensions.

## Query parameters

- `symbol` string, required: US equity ticker symbol
- `period` 'quarterly' | 'annual': Financial period
- `statement_type` 'income' | 'balance_sheet' | 'cash_flow': Optional statement family
- `metric_code` string: Optional normalized metric code
- `dimension_type` string: Optional provider dimension key
- `label` string: Optional provider segment label
- `start_date` string: Inclusive period start
- `end_date` string: Inclusive period end
- `limit` integer: Maximum facts to return
- `offset` integer: Number of facts to skip

## Response `200`

OK

- DataResponseEquitySegmentFinancial
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` EquitySegmentFinancial[], nullable, required
    - `calculated_at` integer
    - `currency` string
    - `dimension_type` 'product' | 'segment', required
    - `fiscal_quarter` integer
    - `fiscal_year` integer
    - `label` string, required
    - `label_key` string, required
    - `materialized_at` integer
    - `metric_code` string, required
    - `period` 'quarterly' | 'annual', required
    - `presentation_period` 'single_quarter' | 'annual', required
    - `reason_code` string
    - `report_period` string, required
    - `source_accessions` string[], nullable
    - `source_observed_at` integer
    - `source_provider_tickers` string[], nullable
    - `statement_type` 'income' | 'balance_sheet' | 'cash_flow', required
    - `status` 'reported' | 'source_null' | 'source_missing', required
    - `symbol` string, required
    - `unit` string
    - `value` number, double, nullable, required
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

## Changes

- **2026-09-30** `4a9654317fc5`: 3 breaking
  - removed the enum value `product` from the `query` request parameter `dimension_type`
  - removed the enum value `segment` from the `query` request parameter `dimension_type`
  - added the pattern `^[a-z][a-z0-9_]*$` to the `query` request parameter `dimension_type`
- **2026-09-22** `0034a432f8be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/changes/gateway/v1/equity/segments/get.md)

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)