# Retrieve a Movie Set

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

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

## Parameters

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

## Responses

### 200

The Movie Set.

- `data` (object, required)
  - `kind` (string, required): One of "movieSet".
  - `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.
  - `edition` (string, nullable, required): One of "theatricalCut", "directorsCut", "extendedCut", "unratedCut", "imaxVersion", "criterionEdition", "finalCut", "fanEdit", "producersCut", "alternateColorGrading".
  - `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`.
  - `movie` (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`.

### 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": "movieSet",
    "id": 63552,
    "title": "Set #63552",
    "description": null,
    "creator": {
      "id": "ba5477cf-42c6-448e-a8e2-1216ee26b795",
      "username": "Danmark"
    },
    "language": "en",
    "edition": "theatricalCut",
    "group": {
      "kind": "boxset",
      "id": 2214
    },
    "downloadCount": 1,
    "createdAt": "2026-11-16T09:07:32.000Z",
    "updatedAt": "2026-11-16T09:07:32.000Z",
    "movie": {
      "id": 264660,
      "title": "Ex Machina",
      "year": 2015,
      "poster": {
        "id": "31a7bc4a-2883-484d-ad0e-a0b4969c8134",
        "extension": "jpg",
        "language": "en",
        "edition": "theatricalCut",
        "width": 1024,
        "height": 1536,
        "fileSize": 556809,
        "createdAt": "2026-11-16T09:07:35.000Z",
        "updatedAt": "2026-11-16T09:07:35.000Z"
      },
      "backdrop": null,
      "logo": null,
      "squareArt": null,
      "thumb": null
    }
  }
}
```
