Profitability Ratios API

Retrieve profitability ratios for any publicly traded company. This endpoint returns a comprehensive set of margin and return metrics that measure how effectively a company converts revenue into profit and generates returns on invested capital.

Profitability ratios are among the most widely used metrics in fundamental analysis. Return on equity (ROE) shows how much profit a company generates with shareholder capital, while margins like gross margin and operating margin reveal where value is created and lost in the business model. Together, these ratios help analysts evaluate management effectiveness, compare companies across sectors, and identify businesses with sustainable competitive advantages.

Data is available for both annual and quarterly periods, with up to 250 historical periods per request.

GEThttps://api.roic.ai/v2/fundamental/ratios/profitability/{identifier}

Request

curl "https://api.roic.ai/v2/fundamental/ratios/profitability/AAPL?apikey=YOUR_API_KEY"

Response

200 OK

[
  {
    "ticker": "AAPL",
    "date": "2025-09-30",
    "period": "annual",
    "period_label": "2025",
    "fiscal_year": "2025",
    "currency": "USD",
    "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
  }
]

Parameters

Path parameters

identifierstringrequired

Company identifier — supports ticker symbol (e.g., AAPL), CIK, CUSIP, or ISIN.

Example: AAPL

Query parameters

periodstring

Reporting period for financial data.

Default: annualValues: annualquarterly

limitnumber

Maximum number of periods to return.

Default: 10Example: 10

fiscal_year_startnumber

Filter results starting from this fiscal year.

Example: 2020

fiscal_year_endnumber

Filter results ending at this fiscal year.

Example: 2024

date_startstring

Filter results starting from this date (YYYY-MM-DD format).

Example: 2020-01-01

date_endstring

Filter results ending at this date (YYYY-MM-DD format).

Example: 2024-12-31

orderstring

Sort order for time-series data.

Default: DESCValues: ASCDESC

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel

Field Dictionary

Field	Description
`return_com_eqy`	Return on common equity (ROE)
`return_on_asset`	Return on assets (ROA)
`return_on_cap`	Return on capital (ROC)
`return_on_inv_capital`	Return on invested capital (ROIC)
`gross_margin`	Gross profit margin
`ebitda_margin`	EBITDA margin
`oper_margin`	Operating margin
`incremental_operating_margin`	Incremental operating margin
`pretax_inc_to_net_sales`	Pre-tax income to net sales
`profit_margin`	Net profit margin
`net_income_to_common_margin`	Net income to common margin
`eff_tax_rate`	Effective tax rate
`dvd_payout_ratio`	Dividend payout ratio
`sustain_growth_rt`	Sustainable growth rate

Metadata

Field	Description
`ticker`	Company ticker symbol
`date`	Period end date
`period`	Reporting period (e.g. Annual, Quarterly)
`period_label`	Human-readable period label
`fiscal_year`	Fiscal year
`currency`	Reporting currency

Use Cases

Screen for high-ROE companies with consistent margins as quality stock candidates
Compare gross margins across competitors to identify pricing power and cost advantages
Track operating margin expansion or compression over time to evaluate management execution
Combine ROE with payout ratio to calculate sustainable growth rates for valuation models
Filter by profit margin thresholds to build profitability-focused factor portfolios

Credit & Debt Ratios - leverage and interest coverage to pair with return metrics
Valuation Multiples - P/E and P/B ratios for valuation context alongside profitability
Income Statement - raw revenue, earnings, and margin data