# Retrieve a Show

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

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

## Parameters

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

## Responses

### 200

The Show.

- `data` (object, required)
  - `kind` (string, required): One of "show".
  - `id` (integer, required)
  - `title` (string, required)
  - `originalTitle` (string, nullable, required)
  - `year` (integer, nullable, required)
  - `overview` (string, nullable, required)
  - `tagline` (string, nullable, required)
  - `status` (string, nullable, required): One of "returningSeries", "planned", "inProduction", "pilot", "ended", "canceled", "other".
  - `inProduction` (boolean, nullable, required)
  - `firstAirDate` (string, nullable, required)
  - `lastAirDate` (string, nullable, required)
  - `seasonCount` (integer, required)
  - `episodeCount` (integer, 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`.
    - `backdrop` (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`.
      - `accent` (object, nullable, required)
      - `ambientMesh` (object, nullable, required)
    - `logo` (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`.
  - `categories` (array of object, required)
    - `id` (integer, required)
    - `name` (string, required)
  - `externalIds` (map of string, required)
  - `creators` (array of object, required)
    - `id` (integer, required)
    - `name` (string, required)
  - `networks` (array of object, required)
    - `id` (integer, required)
    - `name` (string, required)
  - `cast` (array of object, required)
    - `person` (object, required)
      - `id` (integer, required)
      - `name` (string, required)
    - `character` (string, nullable, required)
    - `order` (integer, required)
  - `crew` (array of object, required)
    - `person` (object, required)
      - `id` (integer, required)
      - `name` (string, required)
    - `job` (string, required)
    - `department` (string, required): One of "acting", "art", "camera", "costumeAndMakeUp", "creator", "crew", "directing", "editing", "lighting", "production", "sound", "visualEffects", "writing", "other".
  - `seasons` (array of object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `seasonNumber` (integer, required)
    - `airDate` (string, nullable, required)
    - `episodeCount` (integer, 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)
      - `episodeNumber` (integer, required)
      - `title` (string, 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": "show",
    "id": 1399,
    "title": "Game of Thrones",
    "originalTitle": "Game of Thrones",
    "year": 2011,
    "overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
    "tagline": "Winter is coming.",
    "status": "ended",
    "inProduction": false,
    "firstAirDate": "2011-04-17",
    "lastAirDate": "2019-05-19",
    "seasonCount": 8,
    "episodeCount": 73,
    "metadataImages": {
      "poster": {
        "id": "7b7b7442-7151-4d32-bebe-7dd39532e45f",
        "extension": "avif"
      },
      "backdrop": {
        "id": "cf64ba43-c3eb-4b1e-bc75-4161951862f1",
        "extension": "avif",
        "accent": {
          "color": "#030404"
        },
        "ambientMesh": {
          "base": "#090c0c",
          "grid": [
            [
              "#0c1012",
              "#0c1112",
              "#0d1113"
            ],
            [
              "#0e1314",
              "#0e1315",
              "#0f1416"
            ],
            [
              "#0f1416",
              "#101517",
              "#101618"
            ],
            [
              "#0d1315",
              "#0e1315",
              "#0f1416"
            ],
            [
              "#0b1012",
              "#0c1012",
              "#0c1013"
            ]
          ]
        }
      },
      "logo": {
        "id": "3bca0764-5956-4b3a-b6c0-8c3451463753",
        "extension": "svg"
      }
    },
    "categories": [
      {
        "id": 1,
        "name": "Action"
      },
      {
        "id": 2,
        "name": "Adventure"
      },
      {
        "id": 8,
        "name": "Drama"
      },
      {
        "id": 10,
        "name": "Fantasy"
      },
      {
…
```
