# Retrieve a Show Set

> Returns one Show Set: its header and a sparse Entity tree of the artwork it holds.

`GET /show-set/{id}` on `https://api.mediux.io`

## Parameters

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

## Responses

### 200

The Show Set.

- `data` (object, required)
  - `kind` (string, required): One of "showSet".
  - `id` (integer, required)
  - `title` (string, required)
  - `description` (string, nullable, required)
  - `creator` (object, required)
    - `id` (string (uuid), required)
    - `username` (string, required)
  - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
  - `group` (object, nullable, required)
    - `kind` (string, required): One of "boxset", "loadout".
    - `id` (integer, required)
  - `downloadCount` (integer, required): All-time Download total, up to about a day old.
  - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
  - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
  - `show` (object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
    - `poster` (object, nullable, required)
      - `id` (string (uuid), required)
      - `extension` (string, required)
      - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
      - `edition` (string, nullable): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
      - `width` (integer, required)
      - `height` (integer, required)
      - `fileSize` (integer, required)
      - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
      - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
    - `backdrop` (object, nullable, required)
      - `id` (string (uuid), required)
      - `extension` (string, required)
      - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
      - `edition` (string, nullable): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
      - `width` (integer, required)
      - `height` (integer, required)
      - `fileSize` (integer, required)
      - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
      - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
    - `logo` (object, nullable, required)
      - `id` (string (uuid), required)
      - `extension` (string, required)
      - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
      - `edition` (string, nullable): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
      - `width` (integer, required)
      - `height` (integer, required)
      - `fileSize` (integer, required)
      - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
      - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
    - `squareArt` (object, nullable, required)
      - `id` (string (uuid), required)
      - `extension` (string, required)
      - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
      - `edition` (string, nullable): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
      - `width` (integer, required)
      - `height` (integer, required)
      - `fileSize` (integer, required)
      - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
      - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
    - `thumb` (object, nullable, required)
      - `id` (string (uuid), required)
      - `extension` (string, required)
      - `language` (string, nullable, required): ISO 639-1 code; `xx` is textless.
      - `edition` (string, nullable): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
      - `width` (integer, required)
      - `height` (integer, required)
      - `fileSize` (integer, required)
      - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
      - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
    - `seasons` (array of object, required)
      - `id` (integer, required)
      - `seasonNumber` (integer, required)
      - `poster` (object, nullable, required)
      - `backdrop` (object, nullable, required)
      - `episodes` (array of object, 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.

### 410

The Set, Boxset or Loadout existed and is no longer public.

### 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": "showSet",
    "id": 771,
    "title": "Set #771",
    "description": null,
    "creator": {
      "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
      "username": "Koltom"
    },
    "language": "en",
    "group": {
      "kind": "boxset",
      "id": 116
    },
    "downloadCount": 3349,
    "createdAt": "2023-12-19T07:09:34.000Z",
    "updatedAt": "2024-05-10T03:46:56.000Z",
    "show": {
      "id": 90462,
      "title": "Chucky",
      "year": 2021,
      "poster": {
        "id": "fa5f7887-8610-45f0-9dbc-78bf1d500065",
        "extension": "jpg",
        "language": "en",
        "width": 1000,
        "height": 1500,
        "fileSize": 451290,
        "createdAt": "2023-12-19T07:09:34.000Z",
        "updatedAt": "2023-12-19T07:09:34.000Z"
      },
      "backdrop": {
        "id": "d9dfd918-d6e6-406c-8ab0-7da6e5ee1711",
        "extension": "jpg",
        "language": "en",
        "width": 1920,
        "height": 1080,
        "fileSize": 974606,
        "createdAt": "2023-12-19T07:09:37.000Z",
        "updatedAt": "2023-12-19T07:09:37.000Z"
      },
      "logo": null,
      "squareArt": null,
      "thumb": null,
      "seasons": [
        {
          "id": 126146,
          "seasonNumber": 1,
          "poster": {
            "id": "04347ecf-c81c-48b5-9f07-19963685c30a",
            "extension": "jpg",
            "language": "en",
            "width": 1000,
            "height": 1500,
            "fileSize": 1035599,
            "createdAt": "2023-12-19T07:09:35.000Z",
            "updatedAt": "2023-12-19T07:09:35.000Z"
          },
          "backdrop": null,
          "episodes": [
            {
              "id": 1823891,
              "episodeNumber": 1,
              "title": "Death by Misadventure",
              "titlecard": {
                "id": "5639edc4-8036-4554-b313-bc3c9dcad952",
                "extension": "jpg",
                "language": "en",
                "width": 1920,
                "height": 1080,
                "fileSize": 294782,
                "createdAt": "2023-12-19T07:09:37.000Z",
                "updatedAt": "2024-04-14T07:09:45.000Z"
              }
            },
            {
              "id": 3256394,
              "episodeNumber": 2,
              "title": "Give Me Something Good to Eat",
…
```
