Equity Listings

GET/gateway/v1/equity/listings

Returns all current verified active stock listings for the issuer resolved from the requested ticker. Ticker alone is not treated as a durable listing identity.

Query Parameters

symbolstringrequired

Ticker used to resolve the issuer whose current verified stock listings are returned

Example: AAPL

limitinteger

Results per page

offsetinteger

Pagination offset

Equity Listings

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/equity/listings?symbol=AAPL', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseEquityListing.json",
  "data": [
    {
      "financial_serving_reason": "<string>",
      "financial_serving_status": "<string>",
      "is_current": true,
      "is_primary": true,
      "issuer_cik": "<string>",
      "issuer_company_id": "<string>",
      "issuer_legal_name": "<string>",
      "listing_currency": "<string>",
      "listing_exchange_code": "<string>",
      "listing_id": "<string>",
      "listing_lifecycle_status": "<string>",
      "listing_symbol_id": "<string>",
      "reporting_series_display_name": "<string>",
      "reporting_series_id": "<string>",
      "security_id": "<string>",
      "security_name": "<string>",
      "security_type": "<string>",
      "share_class": "<string>",
      "stock_type": "<string>",
      "symbol_exchange_code": "<string>",
      "symbol_identity_status": "<string>",
      "ticker": "<string>",
      "valid_from": "<string>",
      "valid_to": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}