Babylon Icon

/listings

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

GET /listings

Provides the listing of the securities in one or more segement ledgers.

Query parameters

  • segmentLedger — one or more segment ledger identifiers (comma-separated, case-preserving)
  • format (optional) — json (default) or csv
  • columns (optional) — comma-separated field names; subset + order applied
  • asOfDate (optional) — return the single metadata version in effect on this date (YYYY-MM-DD)

Example request (JSON, two ledgers)

GET /listings?segmentLedger=MyGBSegment,MySASegment

Example response — 200 (JSON, columnar)

{
  "listings": [
    {
      "isin": "GB00B03MLX29",
      "symbol": "VOD",
      "bourse": "LSE",
      "name": "Vodafone Group PLC",
      "priceCurrency": "GBP"
    },
    {
      "isin": "ZAE000200457",
      "symbol": "SOL",
      "bourse": "JSE",
      "name": "Sasol Limited",
      "priceCurrency": "ZAR"
    }
  ]
}

Example request (CSV, two ledgers, ordered subset)

GET /listings?segmentLedger=MyGBSegment,MySASegment&format=csv&columns=isin,symbol,currency

Example response — 200 (CSV, ordered subset)

Isin,Symbol,Currency
GB00B03MLX29,VOD,GBP
ZAE000200457,SOL,ZAR

← Back to API