---
title: "Api Debt Maturities Wall"
method: GET
path: "/api/debt-maturities-wall"
---

# Api Debt Maturities Wall

`GET /api/debt-maturities-wall`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/debt-maturities-wall`
- Auth: none declared

Aggregate debt maturity wall across companies.

Returns a maturity wall showing when corporate debt comes due, grouped
by year with optional sector and IG/HY breakdowns.  Calls
data.maturity_wall.build_maturity_wall() which combines EDGAR-parsed
schedules with balance-sheet long_term_debt as fallback.

Query params:
  tickers   -- comma-separated ticker list (e.g. "AAPL,MSFT"); omit for all
  by_sector -- true to include per-sector breakdown (slower)

## Query parameters

- `tickers` string: Comma-separated list of tickers (optional; omit for market-wide wall)
- `by_sector` boolean: Include sector breakdown

## Response `200`

Successful Response

- DebtMaturitiesWallResponse: `GET /api/debt-maturities-wall?tickers=…&by_sector=…` — aggregate corporate debt maturity wall. FE renders the `data.years` array as the X-axis + `data.total_by_year` as the Y values. Errors degrade to an empty-state with the same two keys + an `error` string — layout stays stable.
  - `years` unknown[], required: Sorted list of years covered by the wall (may be int or str depending on builder). Empty list on no-data.
    - unknown
  - `total_by_year` object, required: {year: total_amount_$M} aggregate maturity by year. Empty {} on no-data.
  - `by_sector` object, nullable
  - `by_rating` object, nullable
  - `top_issuers_by_year` object, nullable
  - `peak_year` unknown
  - `total_outstanding` number, nullable
  - `companies_included` integer, nullable
  - `companies_attempted` integer, nullable
  - `fed_funds_rate` number, nullable
  - `risk_flags` string[], nullable
  - `wall_concentration` number, nullable
  - `schedule_dates` object, nullable
  - `data_quality` object, nullable
  - `total_basis` string, nullable
  - `total_in_window` number, nullable
  - `thereafter` number, nullable
  - `top_issuers_thereafter` unknown
  - `year_basis` string, nullable
  - `matured_excluded` unknown
  - `partially_elapsed` unknown
  - `undated_schedules` unknown
  - `fed_funds_series` string, nullable
  - `fed_funds_date` string, nullable
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)