HomeChatAlertsCalendarScreenerWatchlistsFiles
DocsSettings
Sign upJoinLog in

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

GETFinancial StatementsGETRevenue SegmentationGETAllocation Breakdown

WebSocket

Live Quotes (Per Second)Live Quotes (Per Minute)Live NewsLive SEC FilingsTrading Halts

Revenue Segmentation

GET/v1/revenue-segmentation/{ticker}
View as markdown

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

ParameterTypeDescription
ticker(*)stringTicker.
dimensionstringproduct | geographic (default product).
periodstringannual | quarterly (default annual).

Output parameters

FieldTypeDescription
tickerstringTicker.
dimensionstringproduct or geographic.
periodstringannual or quarterly.
resultsarraySegmentation periods, most recent first.
results[].fiscalYearintegerFiscal year.
results[].periodstringFiscal period label (e.g. FY or Q1).
results[].datestringPeriod end date (YYYY-MM-DD).
results[].reportedCurrencystringReporting currency.
results[].dataobjectSegment label → revenue amount map.
countintegerNumber of periods returned.
syncedAtstringSegmentation 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)
{
  "ticker": "AAPL",
  "dimension": "product",
  "period": "annual",
  "results": [
    {
      "ticker": "AAPL",
      "fiscalYear": 2025,
      "period": "FY",
      "date": "2025-09-27",
      "reportedCurrency": "USD",
      "data": {
        "iPhone": 209580000000,
        "Services": 96169000000,
        "Mac": 29984000000,
        "Wearables, Home and Accessories": 35686000000,
        "iPad": 28023000000
      }
    }
  ],
  "count": 1,
  "syncedAt": "2026-06-05T22:02:50-04:00"
}
Financial Statements
Allocation Breakdown