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}

Parameters

Path Parameters

identifierstringrequired

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

Example: AAPL

Query Parameters

apikeystringrequired

Your API key for authentication.

periodstringoptional

Reporting period for financial data.

Default: annualValues: annual, quarterly

limitnumberoptional

Maximum number of periods to return.

Default: 10Example: 10

fiscal_year_startnumberoptional

Filter results starting from this fiscal year.

Example: 2020

fiscal_year_endnumberoptional

Filter results ending at this fiscal year.

Example: 2024

date_startstringoptional

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

Example: 2020-01-01

date_endstringoptional

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

Example: 2024-12-31

orderstringoptional

Sort order for time-series data.

Default: DESCValues: ASC, DESC

formatstringoptional

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

Default: jsonValues: json, excel

Code Examples

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

Response

Response200 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
  }
]

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