---
title: "The available option expiration dates for a stock, ascending, with the number of listed contracts at each. Use one of these as the `expiration` for the option chain. This endpoint returns dates and counts, not price quotes; an empty successful response means the stock has no listed options, while an unavailable feed returns 503. Pass `expired=true` to list past expirations instead, for use with the session and bars endpoints; `startDate` and `endDate` then bound the expiration dates and default to the last 90 days."
method: GET
path: "/v1/stocks/{ticker}/options/expirations"
tags: ["Options"]
---

# The available option expiration dates for a stock, ascending, with the number of listed contracts at each. Use one of these as the \`expiration\` for the option chain. This endpoint returns dates and counts, not price quotes; an empty successful response means the stock has no listed options, while an unavailable feed returns 503. Pass \`expired=true\` to list past expirations instead, for use with the session and bars endpoints; \`startDate\` and \`endDate\` then bound the expiration dates and default to the last 90 days.

`GET /v1/stocks/{ticker}/options/expirations`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/options/expirations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/options/expirations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `expired` boolean
- `startDate` string, date
- `endDate` string, date

## Response `200`

OK

- OptionExpirationsResponse
  - `ticker` string, nullable
  - `companyName` string, nullable
  - `truncated` boolean
  - `expirations` OptionExpirationDto[], nullable
    - `expirationDate` string, date
    - `contractCount` integer

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)