/reference/listings

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

GET `/reference/listings`

List current reference information for securities used by a segment ledger, a bond ladder or both.

Query parameters

segmentLedger (conditionally required) — identifier of a segment ledger.
bondLadder (conditionally required) — identifier of a bond ladder.
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?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"
  ],
  "columnTypes": {},
  "rows": [
    {
      "bourseSymbol": "LSE:VOD",
      "securityType": "SHRS",
      "issuer": "Vodafone Group PLC",
      "description": "ORD USD0.20 20/21",
      "priceCurrency": "GBp",
      "isin": "GB00BH4HKS39"
    }
  ]
}

For CSV, send Accept: text/csv:

GET /reference/listings?segmentLedger=MyGBSegment&valueDate=2026-07-22
Accept: text/csv

BourseSymbol,SecurityType,Issuer,Description,PriceCurrency,Isin
LSE:VOD,SHRS,Vodafone Group PLC,ORD USD0.20 20/21,GBp,GB00BH4HKS39

POST `/reference/listings`

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

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

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

The response has the same shape as the GET response.

← Back to API