/reference/listings-historic

Base URL https://api.babylon.app/v1

GET `/reference``/listings-historic`

List temporal reference records for securities used by a segment ledger, a bond ladder or both.

Query parameters

segmentLedger (conditionally required) — segment-ledger identifier.
bondLadder (conditionally required) — bond-ladder identifier.
valueDate (optional) — reference date in YYYY-MM-DD format; defaults to the current date.

At least one of segmentLedger or bondLadder is required.

Example request

GET /reference/listings-historic?segmentLedger=MyGBSegment&valueDate=2026-07-22

Example response — 200

{
  "name": "Listings",
  "description": "MyGBSegment listings on 2026-07-22",
  "columns": ["bourseSymbol", "securityType", "issuer", "description", "priceCurrency", "isin", "appliesFrom", "appliesUntil"],
  "columnTypes": {},
  "rows": [
    {
      "bourseSymbol": "LSE:VOD",
      "securityType": "SHRS",
      "issuer": "Vodafone Group PLC",
      "description": "ORD USD0.20 20/21",
      "priceCurrency": "GBp",
      "isin": "GB00BH4HKS39",
      "appliesFrom": "2024-01-01",
      "appliesUntil": null
    }
  ]
}

For CSV, send Accept: text/csv.

POST `/reference``/listings-historic`

POST performs the same lookup with parameters in a JSON request body.

POST /reference/listings-historic
Content-Type: application/json

{
  "segmentLedger": "MyGBSegment",
  "valueDate": "2026-07-22"
}

The response has the same shape as the GET response.

← Back to API