# Retrieve a Game

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

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

## Parameters

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

## Responses

### 200

The Game.

- `data` (object, required)
  - `kind` (string, required): One of "game".
  - `id` (integer, required)
  - `title` (string, required)
  - `year` (integer, nullable, required)
  - `originalGame` (object)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
  - `parentGame` (object)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
  - `overview` (string, nullable, required)
  - `storyline` (string, nullable, required)
  - `gameType` (string, required): One of "original", "port", "related", "remake", "remaster", "standaloneExpansion", "other".
  - `firstReleaseDate` (string, nullable, required)
  - `metadataImages` (object, required)
    - `cover` (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`.
    - `background` (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)
  - `platforms` (array of object, required)
    - `name` (string, required)
    - `abbreviation` (string, nullable, required)
  - `developers` (array of object, required)
    - `name` (string, required)
    - `role` (string, required): One of "main", "supporting", "porting", "other".
  - `publishers` (array of string, required)
  - `engines` (array of string, required)
  - `relatedGames` (array of object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, 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.

### 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": "game",
    "id": 33564,
    "title": "Afterbeat",
    "year": 2026,
    "overview": "A musical bullet-hell where all things beautiful are deadly. Dodge well little nanobot, you don't have much time.",
    "storyline": "Set in 207X, a mysterious disease called \"LNNS\" has been ravaging the world. A lone AI researcher, Anna Schroeder, attempts to find the cure with her trusty supercomputer companion HAL. Stumbling upon various “Projects,” the duo decides to investigate the efficacy of a cure using a pulse/rhythm-based interface.",
    "gameType": "original",
    "firstReleaseDate": "2026-10-08",
    "metadataImages": {
      "cover": {
        "id": "05a78497-c932-48dd-9444-d347be3f9b25",
        "extension": "avif"
      },
      "background": {
        "id": "5da5e3dd-c345-42e6-b776-0ff70f4e84cb",
        "extension": "avif",
        "accent": {
          "color": "#900c74"
        },
        "ambientMesh": {
          "base": "#1a1327",
          "grid": [
            [
              "#3a1842",
              "#421947",
              "#411a47"
            ],
            [
              "#341b42",
              "#3b1d47",
              "#3c1f48"
            ],
            [
              "#2e1e41",
              "#341f44",
              "#382148"
            ],
            [
              "#271c3c",
              "#2c1d40",
              "#302044"
            ],
            [
              "#221837",
              "#251a39",
              "#291c3e"
            ]
          ]
        }
      },
      "logo": {
        "id": "a1dcdf32-fb0d-4640-ae72-ee61ffa94d3a",
        "extension": "avif"
      }
    },
    "categories": [
      {
        "id": 399,
        "name": "Action"
      },
      {
        "id": 401,
        "name": "Arcade"
      },
      {
        "id": 450,
        "name": "Co-op"
      }
    ],
    "platforms": [
      {
        "name": "Linux",
        "abbreviation": "Linux"
      },
      {
        "name": "PC (Microsoft Windows)",
        "abbreviation": "PC"
      },
…
```
