# Retrieve a Collection

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

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

## Parameters

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

## Responses

### 200

The Collection.

- `data` (object, required)
  - `kind` (string, required): One of "collection".
  - `id` (integer, required)
  - `title` (string, required)
  - `year` (integer, nullable, required)
  - `overview` (string, nullable, required)
  - `firstReleaseDate` (string, nullable, required)
  - `lastReleaseDate` (string, nullable, required)
  - `movieCount` (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`.
  - `movies` (array of object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
    - `releaseDate` (string, nullable, 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`.

### 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": "collection",
    "id": 2344,
    "title": "The Matrix Collection",
    "year": 1999,
    "overview": "The Matrix collection depicts a complex science fiction story incorporating many philosophical elements. Written and directed by the Wachowskis and produced by Joel Silver.",
    "firstReleaseDate": "1999-03-31",
    "lastReleaseDate": "2021-12-16",
    "movieCount": 4,
    "metadataImages": {
      "poster": {
        "id": "573501de-5b55-44d2-8a9f-5be64b005928",
        "extension": "avif"
      },
      "backdrop": {
        "id": "d3de74ae-4a87-482a-a56c-3e8cfdb0cf97",
        "extension": "avif",
        "accent": {
          "color": "#020502"
        },
        "ambientMesh": {
          "base": "#0b170b",
          "grid": [
            [
              "#061306",
              "#061706",
              "#061a07"
            ],
            [
              "#050e05",
              "#051205",
              "#061406"
            ],
            [
              "#040b04",
              "#050d05",
              "#051105"
            ],
            [
              "#040904",
              "#040b04",
              "#050d05"
            ],
            [
              "#040804",
              "#040904",
              "#040b04"
            ]
          ]
        }
      },
      "logo": null
    },
    "movies": [
      {
        "id": 603,
        "title": "The Matrix",
        "year": 1999,
        "releaseDate": "1999-03-31",
        "poster": {
          "id": "80dae1fe-e38e-4282-bd32-a1aea5606ecd",
          "extension": "avif"
        }
      },
      {
        "id": 604,
        "title": "The Matrix Reloaded",
        "year": 2003,
        "releaseDate": "2003-05-15",
        "poster": {
          "id": "745c5998-bd46-44b0-a1a5-502dd36a49e5",
          "extension": "avif"
        }
      },
      {
        "id": 605,
        "title": "The Matrix Revolutions",
        "year": 2003,
        "releaseDate": "2003-11-05",
…
```
