List credit and debt ratios

Return debt balances, leverage ratios, capital-structure ratios, and interest coverage metrics for one company across financial periods.

GET/v3.0.0/fundamental/ratios/credit/{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/credit/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.credit_ratio",
      "short_and_long_term_debt": 98657000000,
      "bs_st_borrow": 20329000000,
      "bs_lt_borrow": 78328000000,
      "tot_debt_to_ebitda": 0.6815776383784232,
      "net_debt_to_ebitda": 0.43332550363390165,
      "total_debt_to_ebit": 0.7415031942878617,
      "net_debt_to_ebit": 0.471424276587749,
      "ebitda_to_interest_expn": null,
      "ebitda_les_cap_expend_to_int_exp": null,
      "oper_inc_to_int_exp": null,
      "is_int_expense": null,
      "com_eqy_to_tot_asset": 22.075431256454582,
      "lt_debt_to_tot_eqy": 106.23194499070972,
      "lt_debt_to_tot_cap": 44.014137929096826,
      "lt_debt_to_tot_asset": 21.803747345097023,
      "tot_debt_to_tot_eqy": 133.80304612588665,
      "tot_debt_to_tot_cap": 55.4374273014874,
      "tot_debt_to_tot_asset": 27.46262258483859,
      "net_debt_to_shrhldr_eqty": 85.06774442922436,
      "net_debt_to_capital": 44.16272962183247,
      "ebitda": 144748000000,
      "ebitda_after_capex": 132033000000,
      "is_oper_income": 133050000000
    }
  ],
  "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 credit and debt 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.

short_and_long_term_debtnumber

Total Debt: The sum of short-term and long-term debt owed to creditors.

bs_st_borrownumber

ST Debt: Debt obligations due within the next 12 months or current fiscal year, whichever is longer.

bs_lt_borrownumber

LT Debt: Debt that matures in more than one year.

tot_debt_to_ebitdanumber

Total Debt/EBITDA: Measures a company's ability to repay total debt using EBITDA.

net_debt_to_ebitdanumber

Net Debt/EBITDA: Measures a company's ability to repay debt after subtracting cash and cash equivalents using EBITDA.

total_debt_to_ebitnumber

Total Debt/EBIT: Measures a company's ability to repay total debt using EBIT.

net_debt_to_ebitnumber

Net Debt/EBIT: Measures a company's ability to repay debt after subtracting cash and cash equivalents using EBIT.

ebitda_to_interest_expnnumber

EBITDA to Interest Expense: Measures a company's ability to cover interest expense using EBITDA.

ebitda_les_cap_expend_to_int_expnumber

EBITDA-CapEx/Interest Expense: Measures a company's ability to cover interest expense using EBITDA after capital expenditures.

oper_inc_to_int_expnumber

EBIT to Interest Expense: Measures a company's ability to cover interest expense using operating income.

is_int_expensenumber

Interest Expense: The cost an entity pays to borrow funds.

com_eqy_to_tot_assetnumber

Common Equity/Total Assets: Shows how much of a company's assets are funded by common shareholders' equity.

lt_debt_to_tot_eqynumber

Long-Term Debt/Equity (%): Shows how much of a company's equity is matched by long-term debt.

lt_debt_to_tot_capnumber

Long-Term Debt/Capital (%): Shows how much of a company's capital is funded by long-term debt.

lt_debt_to_tot_assetnumber

Long-Term Debt/Total Assets (%): Shows how much of a company's assets are funded by long-term debt.

tot_debt_to_tot_eqynumber

Total Debt/Equity (%): Shows how much of a company's total debt is matched by shareholder equity.

tot_debt_to_tot_capnumber

Total Debt/Capital (%): Shows how much of a company's total capital is funded by total debt.

tot_debt_to_tot_assetnumber

Total Debt/Total Assets (%): Shows how much a company relies on debt to finance its assets and operations.

net_debt_to_shrhldr_eqtynumber

Net Debt to Equity: Shows how much net debt a company uses relative to shareholder equity.

net_debt_to_capitalnumber

Net Debt/Capital (%): Shows how much a company uses net debt to fund its operations.

ebitdanumber

EBITDA: Earnings before interest, taxes, depreciation, and amortization measure profit from core activities.

ebitda_after_capexnumber

EBITDA-CapEx: Shows earnings from core activities after capital expenditures.

is_oper_incomenumber

Operating Income (Loss): Measures profit from core operations.

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.

Related endpoints

Use balance-sheet and liquidity data for a broader solvency view.