List yield-analysis ratios

Return cash-flow, free-cash-flow, shareholder-return, enterprise-value, and capital-yield values for one company across financial periods.

GET/v3.0.0/fundamental/ratios/yield-analysis/{identifier}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 years

Individual

$29/mo

5 years

Professional

$89/mo

40+ years

Request
curl "https://api.roic.ai/v3.0.0/fundamental/ratios/yield-analysis/NASDAQ:AAPL?apikey=YOUR_API_KEY&period_type=annual&fiscal_year.gte=2025&fiscal_year.lte=2025"
Response
200 OK
{
  "data": [
    {
      "id": "fnd_N7wh3Ukmc6CRKm",
      "symbol": "NASDAQ:AAPL",
      "period_type": "annual",
      "period_end_date": "2025-09-30",
      "fiscal_year": 2025,
      "period_label": "FY",
      "currency": "USD",
      "price_currency": "USD",
      "fx_applied": false,
      "object": "v3.fundamentals.yield_analysis_ratio",
      "ttm_cash_from_oper": 111482000000,
      "ttm_cap_expend": -12715000000,
      "ttm_free_cash_flow": 98767000000,
      "free_cash_flow_yield": 2.5850863983396786,
      "cf_dvd_paid": -15421000000,
      "cf_proc_fr_repurch_eqty_detailed": -90711000000,
      "cf_pymt_debt_and_capital_lease": -10932000000,
      "cf_other_financing_act_excl_fx": -8103000000,
      "ttm_cff": -120686000000,
      "shareholder_yield_cff": 3.208270530392965,
      "returned_capital_ex_debt": 106132000000,
      "shareholder_yield_ex_debt": 2.8213725530025533,
      "cf_cash_from_oper": 111482000000,
      "cf_cap_expenditures": -12715000000,
      "ttm_after_tax_interest_expense": 0,
      "cf_free_cash_flow_firm": 98767000000,
      "enterprise_value": 3805675193800,
      "ttm_fcf_to_firm_yield": 2.5952556371838,
      "capital_yield": 3.171211253041644
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Parameters

Path parameters

identifierstringrequired

A ticker ID, an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), or a FIGI.

Examples: NASDAQ:AAPLtkr_cO46h8pgSu9QqyBBG000B9XRY4

Query parameters

period_typestringoptional

Financial period cadence.

Default: annualValues: annualquarterlyttm
period_labelstringoptional

Filter to a specific period within the fiscal year: FY for annual periods, or Q1–Q4 for quarterly and TTM periods.

Values: FYQ1Q2Q3Q4
datestringoptional

Pass a YYYY-MM-DD date directly for an exact period-end-date match. For a range, combine the modifiers below, for example, date.gte=2020-01-01&date.lt=2026-01-01.

+ Show filter modifiers
date.gtestring

Return statements whose period end date is on or after this date.

date.gtstring

Return statements whose period end date is strictly after this date.

date.ltestring

Return statements whose period end date is on or before this date.

date.ltstring

Return statements whose period end date is strictly before this date.

fiscal_yearobjectoptional

Filter by fiscal year. Combine the range modifiers below to select the reporting years you need.

+ Show filter modifiers
fiscal_year.gteinteger

Return statements from this fiscal year onward.

fiscal_year.gtinteger

Return statements after this fiscal year.

fiscal_year.lteinteger

Return statements through this fiscal year.

fiscal_year.ltinteger

Return statements before this fiscal year.

orderstringoptional

Sort by period end date (period_end_date).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 50Min: 1Max: 100
pagestringoptional

Opaque page token from a previous response. Follow the returned page URL when possible.

Response

Each normalized yield-analysis value is a top-level field on the period resource. Missing values are null.

Response fields

dataarray of objects

Array of financial period resources for the current page, one per reporting period.

+ Show child attributes
idstring

Unique identifier for the financial period record, beginning with fnd_. Store it as the stable reference to this period's figures.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL.

period_typestring

Cadence of the period: annual for full fiscal years, quarterly for fiscal quarters, or ttm for trailing-twelve-month aggregates.

period_end_datestring

Last calendar day of the financial period, in YYYY-MM-DD format.

fiscal_yearnumber

Fiscal year the period belongs to, e.g. 2025. Fiscal years may not align with calendar years; Apple's fiscal 2025 ends in September 2025.

period_labelstring

Label of the period within the fiscal year: FY for annual periods, or Q1 through Q4 for quarters.

currencystring

ISO 4217 code of the currency the financial values are reported in, e.g. USD.

price_currencystring

ISO 4217 code of the currency used for price-derived values such as market capitalization. It can differ from currency when the listing trades in another currency.

fx_appliedboolean

Whether metric values were converted from the company's reporting currency. false means the figures are as originally reported.

objectstring

String representing the object's type, e.g. v3.fundamentals.income_statement. Each fundamentals endpoint returns its own object type.

ttm_cash_from_opernumber

TTM Cash From Operations: Cash from Operating Activities (CF015, cf_cash_from_oper) for TTM period.

ttm_cap_expendnumber

TTM Capital Expenditures: Capital Expenditures (CF047, cf_cap_expenditures) for TTM period.

ttm_free_cash_flownumber

TTM Free Cash Flow: Free Cash Flow (CF045, cf_free_cash_flow) for TTM period.

free_cash_flow_yieldnumber

Free Cash Flow Yield (%): Free cash flow yield is a measure of how much cash a company generates per share compared to its share price.

cf_dvd_paidnumber

Dividends Paid: The amount of cash paid by a company to its shareholders as a distribution of its profits.

cf_proc_fr_repurch_eqty_detailednumber

Cash (Repurchase) of Equity: The amount of cash paid by a company to reacquire its own equity shares from existing shareholders.

cf_pymt_debt_and_capital_leasenumber

Repayments of Debt: The amount of cash payments for repaying debt.

cf_other_financing_act_excl_fxnumber

Other Financing Activities: The amount of cash inflows or outflows from other financing activities that are not separately disclosed in the cash flow statement.

ttm_cffnumber

TTM Cash Flow from Financing: Cash from Financing Activities (CF042, cf_cash_from_fin_act) for TTM period.

shareholder_yield_cffnumber

Shareholder Yield (Cash Flow from Financing) (%): Shareholder yield (cash flow from financing) is a measure of how much cash a company returns to its shareholders through dividends, share buybacks, and debt reduction.

returned_capital_ex_debtnumber

Cash to Shareholders: Returned capital ex debt (cash to shareholders) is a measure of how much cash a company returns to its shareholders through dividends and share buybacks.

shareholder_yield_ex_debtnumber

Shareholder Yield, Ex Debt (%): Shareholder yield (ex debt repayments) is a measure of how much cash a company returns to its shareholders through dividends and share buybacks, excluding any cash used to repay debt.

cf_cash_from_opernumber

Cash from Operating Activities: The amount of net cash generated by a company’s normal business operations during a specific period.

cf_cap_expendituresnumber

Capital Expenditures: Capital expenditures are the amount of money that a company spends on buying or upgrading physical assets, such as buildings, equipment, or machinery.

ttm_after_tax_interest_expensenumber

TTM After-Tax Interest Expense: After-Tax Interest Expense (R0073, after_tax_interest_expense) for TTM period.

cf_free_cash_flow_firmnumber

Free Cash Flow to Firm: Free Cash Flow to Firm (FCFF) is the cash that a company makes from its main activities after paying for all its expenses and investments.

enterprise_valuenumber

Enterprise Value: Enterprise value is a measure of a company’s total value, often used to estimate how much it would cost to buy the company.

ttm_fcf_to_firm_yieldnumber

TTM Free Cash Flow to Firm Yield (%): TTM free cash flow to firm yield is a measure of how much cash a company generates from its core operations relative to its total value.

capital_yieldnumber

Capital Yield (%): Capital yield is a measure of how much cash a company uses or receives from its financing activities relative to its total value.

next_page_urlnullable

URL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page.

Example

Return yield analysis for the financial period that ends on one exact date.

curl "https://api.roic.ai/v3.0.0/fundamental/ratios/yield-analysis/NASDAQ:AAPL?apikey=YOUR_API_KEY&period_type=annual&date=2025-09-30"

Related endpoints

Pair yield analysis with cash flow and enterprise value.