# Retrieve a Movie

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

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

## Parameters

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

## Responses

### 200

The Movie.

- `data` (object, required)
  - `kind` (string, required): One of "movie".
  - `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 "rumored", "planned", "inProduction", "postProduction", "released", "canceled", "other".
  - `releaseDate` (string, nullable, required)
  - `runtimeMinutes` (integer, nullable, 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)
  - `collection` (object, nullable, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, 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`.
    - `movies` (array of object, required)
      - `id` (integer, required)
      - `title` (string, required)
      - `year` (integer, nullable, required)
      - `releaseDate` (string, nullable, required)
      - `poster` (object, nullable, required)
  - `companies` (array of object, required)
    - `company` (object, required)
      - `id` (integer, required)
      - `name` (string, required)
    - `role` (string, required): One of "production".
  - `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".

### 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": "movie",
    "id": 603,
    "title": "The Matrix",
    "originalTitle": "The Matrix",
    "year": 1999,
    "overview": "Set in the 22nd century, The Matrix tells the story of a computer hacker who joins a group of underground insurgents fighting the vast and powerful computers who now rule the earth.",
    "tagline": "Believe the unbelievable.",
    "status": "released",
    "releaseDate": "1999-03-31",
    "runtimeMinutes": 136,
    "metadataImages": {
      "poster": {
        "id": "80dae1fe-e38e-4282-bd32-a1aea5606ecd",
        "extension": "avif"
      },
      "backdrop": {
        "id": "f02c6a97-366b-4190-96f5-8a9f615f84be",
        "extension": "avif",
        "accent": {
          "color": "#fafcf5"
        },
        "ambientMesh": {
          "base": "#60615b",
          "grid": [
            [
              "#374b4d",
              "#3d5251",
              "#415654"
            ],
            [
              "#2f4449",
              "#344a4e",
              "#394f51"
            ],
            [
              "#2a3e46",
              "#2d4349",
              "#31494d"
            ],
            [
              "#253941",
              "#273d43",
              "#2c4148"
            ],
            [
              "#24363d",
              "#24373f",
              "#293c42"
            ]
          ]
        }
      },
      "logo": {
        "id": "f3bbbd6a-ad8f-4bef-a3b7-72cd545aa1df",
        "extension": "svg"
      }
    },
    "categories": [
      {
        "id": 1,
        "name": "Action"
      },
      {
        "id": 20,
        "name": "Science Fiction"
      }
    ],
    "externalIds": {
      "imdb": "tt0133093",
      "tvdb": "169",
      "wikidata": "Q83495",
      "simkl": null,
      "traktSlug": "481",
      "letterboxd": null,
      "justwatch": null,
      "metacritic": "movie/the-matrix",
      "plex": "5d776827880197001ec90904",
      "rottentomatoes": "m/matrix"
…
```
