List profitability ratios

Return profitability metrics including returns on equity, assets, capital, and invested capital, plus margins, tax rate, payout, and sustainable growth.

GET/v3.0.0/fundamental/ratios/profitability/{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/profitability/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.profitability_ratio",
      "return_com_eqy": 156.19204328364452,
      "return_on_asset": 30.93254683307996,
      "return_on_cap": 64.24212530684346,
      "return_on_inv_capital": 59.78971095435014,
      "gross_margin": 46.90516410716045,
      "ebitda_margin": 34.78173110887373,
      "oper_margin": 31.970799762591884,
      "incremental_operating_margin": 39.138740746636955,
      "pretax_inc_to_net_sales": 31.893666153243576,
      "profit_margin": 26.91506412181824,
      "net_income_to_common_margin": 26.91506412181824,
      "eff_tax_rate": 15.610002335586044,
      "dvd_payout_ratio": 13.76752075707526,
      "sustain_growth_rt": 134.68827130366878
    }
  ],
  "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 quarterly data to one fiscal quarter. Use this parameter only with period_type=quarterly.

Values: Q1Q2Q3Q4
dateobjectoptional

Filter by period end date. Combine the range modifiers below to select the reporting periods you need.

+ Show filter modifiers
date.gtestring

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

date.gtstring

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

date.ltestring

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

date.ltstring

Return ratios 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 ratios for the specified fiscal year and all later fiscal years.

fiscal_year.gtinteger

Return ratios only for fiscal years after the specified year.

fiscal_year.lteinteger

Return ratios for the specified fiscal year and all earlier fiscal years.

fiscal_year.ltinteger

Return ratios only for fiscal years before the specified year.

orderstringoptional

Sort by period end date (period_end_date).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 50Min: 1Max: 100

Pagination URLs

next_page_urlstring | null

Ready-made URL of the next page, returned in the response. Request it unchanged to continue paging; null on the last page. It carries no credentials, so pass apikey separately or use the Authorization header.

previous_page_urlstring | null

Ready-made URL of the previous page, returned in the response. Request it unchanged to page back; null on the first page. It carries no credentials, so pass apikey separately or use the Authorization header.

Response

Each profitability ratio 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.

return_com_eqynumber

Return on Common Equity (%): Measures how much net income a company earns for each unit of common equity.

return_on_assetnumber

Return on Assets (%): Measures how much net income a company earns for each unit of total assets.

return_on_capnumber

Return on Capital (%): Shows how much profit an investment generates for the people who provide the capital.

return_on_inv_capitalnumber

Return on Invested Capital (%): Measures how efficiently a company uses invested capital to generate operating profit.

gross_marginnumber

Gross Margin (%): Measures how much revenue remains after paying the direct costs of products or services.

ebitda_marginnumber

EBITDA Margin (%): Measures EBITDA as a percentage of revenue.

oper_marginnumber

Operating Margin (%): Measures how much revenue becomes operating profit after core business costs.

incremental_operating_marginnumber

Incremental Operating Margin (%): Measures how much operating income changes when revenue changes.

pretax_inc_to_net_salesnumber

Pretax Margin (%): Measures how much revenue remains as profit before income taxes.

profit_marginnumber

Profit Margin (%): Measures how much revenue remains as net income after all expenses.

net_income_to_common_marginnumber

Net Income to Common Margin (%): Measures how much revenue remains as profit for common shareholders.

eff_tax_ratenumber

Effective Tax Rate (%): Measures income tax expense as a percentage of pretax income.

dvd_payout_rationumber

Dvd Payout Ratio (%): Measures how much net income a company distributes to common shareholders as dividends.

sustain_growth_rtnumber

Sustainable Growth Rate (%): Measures how quickly a company can grow using retained profits without additional borrowing.

next_page_urlnullable

URL of the next page of results, or null on the last page. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page. Request it unchanged to page back.

Example

Return annual profitability ratios for fiscal year 2025.

curl "https://api.roic.ai/v3.0.0/fundamental/ratios/profitability/NASDAQ:AAPL?apikey=YOUR_API_KEY&period_type=annual&fiscal_year.gte=2025&fiscal_year.lte=2025"

Related endpoints

Pair returns and margins with statement data and valuation multiples.