> For the complete documentation index, see [llms.txt](https://api-documentation.autoshares.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-documentation.autoshares.dev/rest-api/trading-api/securities/get-options-expiration-dates/securities_getoptionsexpirations.md).

# Syntax

## Get options expirations set

```
GET /v{version}/options/expirations
```

### Description

This API endpoint enables you to retrieve expiration dates of options with a specific underlying security.

### Parameters

| Type       | Name                           | Description                                                                                                                                                   | Schema | Default |
| ---------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------- |
| **Header** | **Authorization**   *required* | This is the authorization token that you retrieved from the first endpoint (/token).                                                                          | string |         |
| **Header** | **Et-App-Key**   *required*    | This is your app’s unique key that can be retrieved from the BO Companies widget in Autoshares Trader.                                                        | string |         |
| **Path**   | **version**   *required*       | This is the version of the API. Unless you have multiple versions of Autoshares Trader’s API deployed in your environment, leave it at 1.0.                   | string | `"1"`   |
| **Query**  | **currency**   *optional*      | This is the exchange on which the options are listed (use it if you have multiple options with the same ticker but listed on different exchanges).            | string |         |
| **Query**  | **exchange**   *optional*      | This is the currency in which the options are denominated (use it if you have multiple options with the same ticker but denominated in different currencies). | string |         |
| **Query**  | **underlying**   *required*    | This is the ticker symbol of the underlying security of the options whose expiration dates need to be retrieved.                                              | string |         |

### Responses

| HTTP Code | Description                                                                                                                   | Schema                                                                                                                                                           |
| --------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **200**   | Successful request, JSON data is returned, containing the expiration dates of options with the specified underlying security. | < [OptionExpirationResource](/rest-api/trading-api/securities/get-options-expiration-dates/securities_getoptionsexpirations.md#optionexpirationresource) > array |
| **401**   | The access level of the provided authorization token is not sufficient to perform this operation.                             | No Content                                                                                                                                                       |
| **403**   | The provided Et-App-Key is incorrect.                                                                                         | No Content                                                                                                                                                       |
| **422**   | A validation error occurred while processing the request.                                                                     | No Content                                                                                                                                                       |
| **500**   | Internal server error                                                                                                         | No Content                                                                                                                                                       |

### Produces

* `application/json`
* `text/json`