< API Reference
GET
/allaccess/reference/expirations?symbols={symbols}
Get current expiration dates for an underlying security. Expirations can be used as an optional parameter for other API methods, including Market at a Glance option-and-underlying-quotes and Time and Sales option-trades.

Example URI

Live (1 points)

https://api.livevol.com/v1/live/allaccess/reference/expirations?symbols=CBOE,AAPL

Delayed (1 points)

https://api.livevol.com/v1/delayed/allaccess/reference/expirations?symbols=CBOE,AAPL

Request Information

URI Parameters

Name Description Type Additional information
symbols

Comma-separated list of underlying symbols

 string

Required

Response Information

Resource Description

Collection of SymbolExpirations

Name Description Type Additional information
expirations

Expirations per symbol

 Collection of string

None
symbol

Symbol

 string

None

Response Formats

application/json, text/json

Sample: 
[
  {
    "expirations": [
      "2020-10-02",
      "2020-10-09",
      "2020-10-16"
    ],
    "symbol": "CBOE"
  },
  {
    "expirations": [
      "2020-10-02",
      "2020-10-09",
      "2020-10-16"
    ],
    "symbol": "AAPL"
  }
]

application/xml, text/xml

Sample: 
<symbols_expirations xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <symbol_expirations>
    <expirations>
      <expiration>2020-10-02</expiration>
      <expiration>2020-10-09</expiration>
      <expiration>2020-10-16</expiration>
    </expirations>
    <symbol>CBOE</symbol>
  </symbol_expirations>
  <symbol_expirations>
    <expirations>
      <expiration>2020-10-02</expiration>
      <expiration>2020-10-09</expiration>
      <expiration>2020-10-16</expiration>
    </expirations>
    <symbol>AAPL</symbol>
  </symbol_expirations>
</symbols_expirations>