# Retrieve a Season

> Returns one Season with its descriptive metadata and Metadata Images.

`GET /seasons/{id}` on `https://api.mediux.io`

## Parameters

- `id` (path, integer, required): The Season's numeric Mediux ID.

## Responses

### 200

The Season.

- `data` (object, required)
  - `kind` (string, required): One of "season".
  - `id` (integer, required)
  - `title` (string, required)
  - `seasonNumber` (integer, required)
  - `year` (integer, nullable, required)
  - `show` (object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
  - `airDate` (string, nullable, required)
  - `metadataImages` (object, required)
    - `poster` (object, nullable, required)
      - `id` (string (uuid), required): Stable image ID, a lowercase UUID. Variant filenames use the same ID.
      - `extension` (string, required): Extension of the Original, such as `png`.
  - `episodes` (array of object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `episodeNumber` (integer, required)
    - `airDate` (string, nullable, required)

### 304

Not modified. The `If-None-Match` validator still matches; no body.

### 400

The path is not a valid route, or the request carried a query string or body.

### 404

The resource does not exist or is not public.

### 405

Only `GET`, `HEAD` and `OPTIONS` are supported.

### 429

Too many cache misses from this address. Retry after the `Retry-After` delay.

### 503

Temporarily unavailable. Retry after the `Retry-After` delay.

## Example response (200)

```json
{
  "data": {
    "kind": "season",
    "id": 3624,
    "title": "Season 1",
    "seasonNumber": 1,
    "year": 2011,
    "show": {
      "id": 1399,
      "title": "Game of Thrones",
      "year": 2011
    },
    "airDate": "2011-04-17",
    "metadataImages": {
      "poster": {
        "id": "b5641c4e-4cb2-4722-b4d0-a3409fe1fa57",
        "extension": "avif"
      }
    },
    "episodes": [
      {
        "id": 63056,
        "title": "Winter Is Coming",
        "episodeNumber": 1,
        "airDate": "2011-04-17"
      },
      {
        "id": 63057,
        "title": "The Kingsroad",
        "episodeNumber": 2,
        "airDate": "2011-04-24"
      },
      {
        "id": 63058,
        "title": "Lord Snow",
        "episodeNumber": 3,
        "airDate": "2011-05-01"
      }
    ]
  }
}
```
