# Retrieve a Collection Set

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

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

## Parameters

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

## Responses

### 200

The Collection Set.

- `data` (object, required)
  - `kind` (string, required): One of "collectionSet".
  - `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`.
  - `collection` (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`.
    - `movies` (array of object, required)
      - `id` (integer, required)
      - `title` (string, required)
      - `year` (integer, nullable, required)
      - `poster` (object, nullable, required)
      - `backdrop` (object, nullable, required)
      - `logo` (object, nullable, required)
      - `squareArt` (object, nullable, required)
      - `thumb` (object, 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.

### 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": "collectionSet",
    "id": 53526,
    "title": "Set #53526",
    "description": null,
    "creator": {
      "id": "9c145ec0-4cf6-4dc0-8973-70337091c321",
      "username": "willtong93"
    },
    "language": "en",
    "edition": "theatricalCut",
    "group": {
      "kind": "boxset",
      "id": 2007
    },
    "downloadCount": 170,
    "createdAt": "2026-06-16T08:53:42.000Z",
    "updatedAt": "2026-06-17T08:12:48.000Z",
    "collection": {
      "id": 2344,
      "title": "The Matrix Collection",
      "year": 1999,
      "poster": {
        "id": "727c2718-bea2-4d49-aeeb-9447058978ad",
        "extension": "jpg",
        "language": "en",
        "edition": "theatricalCut",
        "width": 1500,
        "height": 2250,
        "fileSize": 2992933,
        "createdAt": "2026-06-16T08:53:45.000Z",
        "updatedAt": "2026-06-16T08:53:45.000Z"
      },
      "backdrop": null,
      "logo": null,
      "squareArt": null,
      "movies": [
        {
          "id": 603,
          "title": "The Matrix",
          "year": 1999,
          "poster": {
            "id": "e401f692-2994-4534-98fd-1ef0c471f582",
            "extension": "jpg",
            "language": "en",
            "edition": "theatricalCut",
            "width": 1500,
            "height": 2250,
            "fileSize": 4695444,
            "createdAt": "2026-06-16T08:53:48.000Z",
            "updatedAt": "2026-06-16T08:53:48.000Z"
          },
          "backdrop": null,
          "logo": null,
          "squareArt": null,
          "thumb": null
        },
        {
          "id": 604,
          "title": "The Matrix Reloaded",
          "year": 2003,
          "poster": {
            "id": "a2b63aaf-8b32-4bf5-9ec8-e208781e5cf0",
            "extension": "jpg",
            "language": "en",
            "edition": "theatricalCut",
            "width": 1500,
            "height": 2250,
            "fileSize": 4685242,
            "createdAt": "2026-06-16T08:53:50.000Z",
            "updatedAt": "2026-06-16T08:53:51.000Z"
          },
          "backdrop": null,
          "logo": null,
          "squareArt": null,
          "thumb": null
        },
        {
          "id": 605,
…
```
