Revenue Segmentation
GET/v1/revenue-segmentation/{ticker}
Retrieve revenue broken down by business segment for equity tickers. Choose dimension product or geographic and period annual or quarterly. Each period includes segment labels and reported revenue amounts in the issuer’s reporting currency - the same data shown in company profile revenue segmentation charts.
Use cases
- Product-line and geographic revenue mix analysis
- Segment trend charts on equity research pages
- Comparing segment growth across fiscal periods
- Feeding segment breakdowns into models and screeners
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| dimension | string | product | geographic (default product). |
| period | string | annual | quarterly (default annual). |
Output parameters
| Field | Type | Description |
|---|---|---|
| ticker | string | Ticker. |
| dimension | string | product or geographic. |
| period | string | annual or quarterly. |
| results | array | Segmentation periods, most recent first. |
| results[].fiscalYr | integer | Fiscal year. |
| results[].period | string | Fiscal period label (e.g. FY or Q1). |
| results[].date | string | Period end date (YYYY-MM-DD). |
| results[].currency | string | Reporting currency. |
| results[].data | object | Segment label → revenue amount map. |
| count | integer | Number of periods returned. |
| updatedAt | string | Segmentation sync timestamp (ISO 8601). |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_revenue_segmentation("AAPL", dimension="product", period="annual")
print(result)Official SDKs (Python, JavaScript, Go, Java, Ruby): github.com/vantafin/vantafin
{
"ticker": "AAPL",
"dimension": "product",
"period": "annual",
"results": [
{
"ticker": "AAPL",
"fiscalYr": 2025,
"period": "FY",
"date": "2025-09-27",
"currency": "USD",
"data": {
"iPhone": 209580000000,
"Services": 96169000000,
"Mac": 29984000000,
"Wearables, Home and Accessories": 35686000000,
"iPad": 28023000000
}
}
],
"count": 1,
"updatedAt": "2026-06-05T22:02:50-04:00"
}