GateData.AI

Business segments

Query operating data by business segment.

GET/api/v1/fundamentals/business-segments
Domain
Fundamentals
Level
Public-company entity
MCP tool
fundamentals_query (task=segments)

Available data

Returns
Revenue and share by product or geographic segment for one public company
Market coverage
US and Hong Kong equities
Query granularity
One company per query; segments follow that company’s own reporting lines

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company positioning

Provide query, symbol, or ticker when possible; an empty request returns no_data.

querystringqueryExampleAAPLoptional

Search text used to identify the object you want.

symbolstringqueryExampleAAPLoptional

Company symbol; compatibility alias of query.

tickerstringqueryExampleAAPLoptional

Company ticker.

Query options

All optional.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
segments[]object[]

Segment rows: segment_type, segment_name, segment_revenue, share_pct

segment_typestringExampleproduct

Segment type

segment_namestringExampleMac ®

Segment name

segment_revenuenumber | nullExample8399000100

Segment revenue

share_pctnumber | nullExample0.075541

Revenue share percent

period_keystringExampleFY2026Q2

Period key

entity_idstringExampleentity_sec_cik_0000320193

Company entity id

currencystringExampleUSD

Currency

unitstring | nullExampleactual

Unit

data_statusDataStatusExampleok

Per-row readiness

empty_reasonstring | null

Per-row empty reason

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

empty_reasonstring | null

Empty / partial reason code when applicable

errorobject | null

Error object (code / message); null on success

metadataobject
actual_taskstringExamplesegments

Routed task: profile / statements / metrics / …

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

limitations[]string[]Exampleserving_mvp

Coverage / MVP limitation tags

route_reasonstringExampleexplicit_task

Route reason (e.g. explicit_task)

updated_atdatetime | stringExample2026-08-17T08:25:07Z

Envelope update time (UTC)

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleentity

Object reference type

idstringExampleentity_sec_cik_0000320193

Canonical object identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

external_refs[]object[]

External refs (e.g. SEC EDGAR filings)

lineage_refs[]object[]

Lineage refs (usually [] on the public body)

source_refs[]object[]

Upstream source refs (usually [] on the public body)

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.