Pricing Blog Insights Playground
Dashboard

Credit Facilities

GET/api/footnotes/credit-facilities

Pro

Returns a company's credit facilities, revolvers, term-loan agreements, commercial-paper programs, one entry per facility, with total capacity, amount drawn, remaining headroom, letters of credit, commitment fees, and interest rates. This is the liquidity picture from the debt footnote that never appears on the face of the balance sheet.

Each entry is one borrowing arrangement: either a facility-level row (debtInstrumentMember: null) or one drawn line under a facility that the filer tagged crossed with the XBRL debt-instrument axis (debtInstrumentMember names the tranche, linking it to the Debt Structure endpoint). Entries sharing the same member are a facility/category rollup beside its component lines, e.g. a mortgage lender's warehouse-lines category total next to each individual line. Values from different arrangements are never mixed into one entry, so utilization (derived as outstanding / maxCapacity when both sides are present in a single known currency) is always internally consistent. When summing across facilities, use only the rollup rows or only the component rows, never both.

Monetary values default to US dollars. Pass the currency parameter to receive any supported ISO 4217 currency instead: values not already in that currency are converted at the period-end spot rate, and the per-period fx block records the exact rate(s) applied so each conversion is reproducible. Pass currency=original for as-filed values. Rates and fees are fractions of 1 (0.015 = 1.5%) and are never converted.

What this data can tell you:

Data honesty notes:

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/footnotes/credit-facilities?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8&currency=USD' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Per-facility capacity, drawn amounts, and terms, organized by period

Response schema

array of:
  • period string (date)

    The fiscal period end date (YYYY-MM-DD), the balance-sheet date the values are measured at

  • fiscalYear integer

    The company's fiscal year (handles non-December year-ends).

  • fiscalPeriod string (enum)

    Fiscal period of a reported value: `FY` (annual) or `Q1`-`Q4` (quarterly).

    Allowed values: FY, Q1, Q2, Q3, Q4
  • facilities array of object

    One entry per credit facility, sorted by total capacity descending. Fields the filer did not tag are omitted, not serialized as `null`.

    array of:
    • member string

      Raw XBRL member QName of the facility

    • name string

      Derived display label

    • debtInstrumentMember string | null

      Tranche member this entry's values were tagged on (crossed with the debt-instrument axis); links to the same tranche in the Debt Structure endpoint. Null for facility-level rows; entries sharing a `member` are the rollup beside its component lines.

    • debtInstrumentName string | null

      Derived display label of `debtInstrumentMember`

    • currency string | null

      Currency of the monetary values after conversion (the requested `currency` unless listed in `fx.unconverted`); null when the entry's values remain in mixed currencies or no monetary field is present

    • normalized boolean

      Only present (as `true`) when a rate value was re-scaled from a mis-tagged whole percent (`1.5`) to a fraction (`0.015`).

    • utilization number

      Derived `outstanding / maxCapacity`; only present when both sides exist in one known currency and capacity > 0. Values above 1 indicate drawn beyond stated capacity as filed.

    • maxCapacity number

      Maximum borrowing capacity of the facility

    • outstanding number

      Amount drawn / outstanding under the facility

    • remainingCapacity number

      Remaining undrawn capacity as disclosed by the filer

    • currentCapacity number

      Currently available borrowing capacity (can be below maximum when covenants or borrowing-base limits apply)

    • lettersOfCredit number

      Letters of credit outstanding under the facility

    • statedRate number

      Stated interest rate as a fraction of 1

    • effectiveRate number

      Effective interest rate as a fraction of 1

    • rateAtPeriodEnd number

      Interest rate in effect at the period end as a fraction of 1

    • variableSpread number

      Basis spread over the variable benchmark rate as a fraction of 1

    • commitmentFee number

      Commitment fee as a fraction of 1

    • unusedFee number

      Fee on unused capacity as a fraction of 1

    • weightedAverageRate number

      Weighted-average interest rate as a fraction of 1

  • dateFiled string (date) | null

    SEC filing acceptance date of the newest filing contributing to this period. Use this to gate point-in-time data and avoid lookahead bias.

  • fx object

    Foreign-currency conversion audit for this period. Every monetary value in `facts` is in the requested `currency` (default **US dollars**). This block is absent when the period was already wholly in the target currency (e.g. a US filer with the default USD, nothing to convert). It is present when one or more line items were originally filed in a different currency and converted on the fly, and it records the exact rate(s) applied so the conversion can be reproduced. Rates come from the Frankfurter API (api.frankfurter.dev). Instant balance-sheet items use the spot rate at period end; flow income/cash-flow items use the day-weighted average rate over the period.

    • targetCurrency string

      The currency (ISO 4217) every `facts` value was converted INTO, the value of the request `currency` parameter (default USD). The literal `original` here means no conversion was requested: each fact stays in its as-reported currency (see `unconverted` for the per-fact mapping).

    • originalCurrencies array of string

      Every source currency (ISO 4217) that appeared in this period, the union of converted, unconverted, and already-in-target. The target currency itself is listed when some facts were natively in it (e.g. a foreign filer reporting some lines in USD alongside its converted local currency), so a mixed period reflects its true composition rather than appearing wholly converted.

    • rates array of object

      One entry per (source currency, method) actually applied. `rate` is the multiplier: `target = original * rate`.

      array of:
      • from string

        ISO 4217 source currency that was converted.

      • method string (enum)

        `spot` for instant balance-sheet items (rate at period end); `average` for flow income/cash-flow items (day-weighted mean over the period).

        Allowed values: spot, average
      • rate number

        Multiply the original-currency amount by this to get the `targetCurrency` amount.

      • effectiveDate string (date)

        Spot only: the date (YYYY-MM-DD) the applied rate was published (≤ period end).

      • start string (date)

        Average only: period start (YYYY-MM-DD).

      • end string (date)

        Average only: period end (YYYY-MM-DD).

    • unconverted map of string to array of string

      Facts that could NOT be converted (no published rate within tolerance, or an unsupported code/date), grouped by the currency they remain in: each key is a source ISO 4217 code, each value lists the curated fact names in `facts` still in that currency (NOT `targetCurrency`). Absent when everything converted. Use it to know exactly which figures to treat as native currency.

      • * (additional properties) array of string

Example response

[
  {
    "period": "2026-05-31",
    "fiscalYear": 2026,
    "fiscalPeriod": {},
    "facilities": [
      {
        "member": "orcl:TermLoanCreditAgreementDueAugust2027Member",
        "name": "Term Loan Credit Agreement Due August 2027",
        "debtInstrumentMember": null,
        "debtInstrumentName": null,
        "currency": "USD",
        "normalized": true,
        "utilization": 0.15,
        "maxCapacity": 10000000000,
        "outstanding": 1500000000,
        "remainingCapacity": 8500000000,
        "currentCapacity": 9000000000,
        "lettersOfCredit": 120000000,
        "statedRate": 0.0135,
        "effectiveRate": 0.0529,
        "rateAtPeriodEnd": 0.0488,
        "variableSpread": 0.011,
        "commitmentFee": 0.002,
        "unusedFee": 0.001,
        "weightedAverageRate": 0.0435
      }
    ],
    "dateFiled": "2026-06-23",
    "fx": {}
  }
]

400 Bad Request

Invalid parameters or symbol not found

Response schema

  • error string

    Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{}