Debt maturities

One company's reported debt due by maturity year, from XBRL filings.

One row is

One company's reported debt due by maturity year, from XBRL filings

Example response

Trimmed real output. No key needed.

GET /v1/datasets/debt-maturities/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "version": 1,
    "symbol": "AAPL",
    "cik": "0000320193",
    "entityName": "Apple Inc.",
    "taxonomy": "us-gaap",
    "status": "partial",
    "fetchedAt": "2026-10-08T12:00:00.000Z",
    "asOf": "2025-09-27",
    "source": {
      "name": "SEC EDGAR company facts",
      "url": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
      "cadence": "Annual filing, refreshed at most every six hours"
    },
    "latest": {
      "asOf": "2025-09-27",
      "filed": "2025-10-31",
      "accession": "0000320193-25-000079",
      "form": "10-K",
      "currency": "USD",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/0000320193-25-000079-index.htm",
      "complete": true,
      "buckets": [
        {
          "id": "InNextTwelveMonths",
          "label": "Next 12 months",
          "year": 2026,
          "fact": {
            "value": 12393000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalInNextTwelveMonths",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 12393000000
        },
        {
          "id": "InYearTwo",
          "label": "Year 2",
          "year": 2027,
          "fact": {
            "value": 10078000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalInYearTwo",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 10078000000
        },
        {
          "id": "InYearThree",
          "label": "Year 3",
          "year": 2028,
          "fact": {
            "value": 9300000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalInYearThree",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 9300000000
        },
        {
          "id": "InYearFour",
          "label": "Year 4",
          "year": 2029,
          "fact": {
            "value": 5235000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalInYearFour",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 5235000000
        },
        {
          "id": "InYearFive",
          "label": "Year 5",
          "year": 2030,
          "fact": {
            "value": 4972000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalInYearFive",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 4972000000
        },
        {
          "id": "AfterYearFive",
          "label": "Thereafter",
          "year": null,
          "fact": {
            "value": 49303000000,
            "tag": "LongTermDebtMaturitiesRepaymentsOfPrincipalAfterYearFive",
            "unit": "USD",
            "start": null,
            "end": "2025-09-27",
            "accession": "0000320193-25-000079",
            "filed": "2025-10-31",
            "form": "10-K"
          },
          "value": 49303000000
        }
      ],
      "totalPrincipal": {
        "value": 91281000000,
        "unit": "USD",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 1,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": "2025-09-27",
          "historyEnd": "2025-09-27",
          "min": 91281000000,
          "max": 91281000000,
          "mean": 91281000000
        }
      },
      "next12Months": {
        "value": 12393000000,
        "unit": "USD",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 1,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": "2025-09-27",
          "historyEnd": "2025-09-27",
          "min": 12393000000,
          "max": 12393000000,
          "mean": 12393000000
        }
      },
      "next12MonthsShare": {
        "value": 13.57675748512834,
        "unit": "%",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 1,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": "2025-09-27",
          "historyEnd": "2025-09-27",
          "min": 13.57675748512834,
          "max": 13.57675748512834,
          "mean": 13.57675748512834
        }
      },
      "next3Years": {
        "value": 31771000000,
        "unit": "USD",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 1,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": "2025-09-27",
          "historyEnd": "2025-09-27",
          "min": 31771000000,
          "max": 31771000000,
          "mean": 31771000000
        }
      },
      "next3YearsShare": {
        "value": 34.805709841040304,
        "unit": "%",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 1,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": "2025-09-27",
          "historyEnd": "2025-09-27",
          "min": 34.805709841040304,
          "max": 34.805709841040304,
          "mean": 34.805709841040304
        }
      },
      "interestExpense": {
        "value": null,
        "unit": "USD",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 0,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": null,
          "historyEnd": null,
          "min": null,
          "max": null,
          "mean": null
        }
      },
      "borrowingCostPercent": {
        "value": null,
        "unit": "%",
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "percentile": {
          "value": null,
          "rank": null,
          "sampleCount": 0,
          "minimumSamples": 5,
          "windowStart": "2015-09-27",
          "windowEnd": "2025-09-27",
          "historyStart": null,
          "historyEnd": null,
          "min": null,
          "max": null,
          "mean": null
        }
      },
      "interestExpenseFact": null,
      "borrowingCostEvidence": null
    },
    "history": [
      {
        "asOf": "2025-09-27",
        "filed": "2025-10-31",
        "accession": "0000320193-25-000079",
        "currency": "USD",
        "complete": true,
        "totalPrincipal": 91281000000,
        "next12Months": 12393000000,
        "next3Years": 31771000000,
        "next12MonthsShare": 13.57675748512834,
        "next3YearsShare": 34.805709841040304,
        "interestExpense": null,
        "borrowingCostPercent": null,
        "interestExpenseTag": null,
        "borrowingCostDebtTags": null
      }
    ],
    "warnings": [
      "Annual interest expense is not reported in a supported matching filing, currency and duration.",
      "At least five comparable annual filing observations are required for a percentile."
    ]
  },
  "meta": {
    "dataset": "debt-maturities",
    "asOf": "2025-09-27",
    "source": [
      {
        "id": "sec-edgar",
        "attribution": "U.S. Securities and Exchange Commission and the filing issuer",
        "licence": "Public SEC filings; preserve filing attribution and fair-access limits"
      }
    ],
    "historyStarts": "2025-09-27",
    "coverage": {
      "observations": 1
    },
    "lastUpdated": "2025-10-31"
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/debt-maturities/{symbol}4 credits

SEC XBRL debt maturity schedule. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

symbol

In

path, required

Type

string ^[A-Za-z0-9.:-]{1,32}$

Notes

Company symbol; normalized to uppercase.

  • Credits: 4 (history x2)
  • Plans: Basic, Desk, Enterprise

Meta fields

Field

dataset

Here

The dataset id

In the example

"debt-maturities"

Field

asOf

Here

The observation date established by the service; otherwise null

In the example

"2025-09-27"

Field

source

Here

Attribution and usage terms of each source

In the example

1 source

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

"2025-09-27"

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

{"observations":1}

Field

lastUpdated

Here

The source update time established by the service; otherwise null

In the example

"2025-10-31"

Sources

Source

U.S. Securities and Exchange Commission and the filing issuer

Usage terms

Public SEC filings; preserve filing attribution and fair-access limits

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.