Skip to main content
GET
/
financials
/
cash-flow-statements
/
segments
Get cash flow statement segments
curl --request GET \
  --url https://api.financialdatasets.ai/financials/cash-flow-statements/segments \
  --header 'X-API-KEY: <api-key>'
{
  "segmented_financials": [
    {
      "ticker": "<string>",
      "report_period": "2023-12-25",
      "fiscal_period": "<string>",
      "currency": "<string>",
      "accession_number": "<string>",
      "filing_url": "<string>",
      "capital_expenditure": {
        "product": [
          {
            "label": "<string>",
            "value": 123
          }
        ],
        "segment": [
          {
            "label": "<string>",
            "value": 123
          }
        ]
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.financialdatasets.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The cash flow statement segments API provides as-reported segment breakdowns from SEC filings (10-Ks and 10-Qs) for a given stock ticker. This includes segment data for metrics like:
  • Capital Expenditure — by business segment
Capital expenditure breakdowns by segment help analysts understand where a company is investing for growth. The API returns this data in a clean, structured format: 
{
  "segmented_financials": [
    {
      "ticker": "AAPL",
      "report_period": "2025-12-27",
      "period": "quarterly",
      "capital_expenditure": {
        "segment": [
          {"label": "Americas", "value": 3000000000.0},
          {"label": "Europe", "value": 2000000000.0},
          {"label": "Greater China", "value": 1500000000.0}
        ]
      }
    }
  ]
}
To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

​
Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/financials/cash-flow-statements/segments/tickers/

​
Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add query params like ticker, period and limit to filter the data.
  3. Execute the API request.

​
Filtering the Data

You can filter the data by ticker, period, limit, and report_period. Note: ticker and period are required. Alternatively, you can use cik instead of ticker as a company identifier in your request. By default, period is annual, limit is 4, and report_period is null. The period parameter can be set to annual or quarterly. The limit parameter is used to specify the number of periods to return. The report_period parameter is used to specify the date of the statement. For example, you can include filters like report_period_lte=2024-09-30 and report_period_gte=2024-01-01 to get statements between January 1, 2024 and September 30, 2024. The available report_period operations are:
  • report_period_lte
  • report_period_lt
  • report_period_gte
  • report_period_gt
  • report_period

​
Example

Cash Flow Statement Segments
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'       # stock ticker
period = 'annual'     # possible values are 'annual' or 'quarterly'
limit = 5             # number of periods to return

# create the URL
url = (
    f'https://api.financialdatasets.ai/financials/cash-flow-statements/segments'
    f'?ticker={ticker}'
    f'&period={period}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse segmented_financials from the response
segmented_financials = response.json().get('segmented_financials')

​
Example (with report_period)

Cash Flow Statement Segments
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'
period = 'annual'
limit = 100
report_period_lte = '2024-01-01' # end date
report_period_gte = '2020-01-01' # start date

# create the URL
url = (
    f'https://api.financialdatasets.ai/financials/cash-flow-statements/segments'
    f'?ticker={ticker}'
    f'&period={period}'
    f'&limit={limit}'
    f'&report_period_lte={report_period_lte}'
    f'&report_period_gte={report_period_gte}'
)

# make API request
response = requests.get(url, headers=headers)

# parse segmented_financials from the response
segmented_financials = response.json().get('segmented_financials')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string

The ticker symbol. Required if cik is not provided.

​
period
enum<string>
required

The time period of the data.

Available options:
annual,
quarterly
​
limit
integer<int32>

The maximum number of periods to return.

​
cik
string

The Central Index Key (CIK) of the company.

​
report_period
string<date>

Filter by exact report period date in YYYY-MM-DD format.

​
report_period_gte
string<date>

Filter by report period greater than or equal to date in YYYY-MM-DD format.

​
report_period_lte
string<date>

Filter by report period less than or equal to date in YYYY-MM-DD format.

​
report_period_gt
string<date>

Filter by report period greater than date in YYYY-MM-DD format.

​
report_period_lt
string<date>

Filter by report period less than date in YYYY-MM-DD format.

Response

Cash flow statement segments response

​
segmented_financials
object[]