# Retrieve an Asset

> Returns one public Asset by ID, including standalone Assets.

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

`id` and `extension` identify the Original; build image URLs from them. Unpublished, removed, replaced or private Assets and Base Art return `404`. Assets carry no counts. Responses are stored but revalidated with the `ETag`.

## Parameters

- `id` (path, string, required): The Asset's ID (a lowercase UUID).

## Responses

### 200

The Asset.

- `data` (object, required)
  - `id` (string (uuid), required)
  - `extension` (string, required)
  - `slot` (string, required): One of "poster", "backdrop", "logo", "squareArt", "titlecard", "thumb", "cover", "hero", "wideCover", "background", "squareCover", "icon".
  - `entity` (object, required)
    - `kind` (string, required)
    - `id` (integer, 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)
  - `set` (object, nullable, required)
    - `kind` (string, required): One of "showSet", "movieSet", "collectionSet", "gameSet", "talentSet", "brandSet", "categorySet".
    - `id` (integer, required)
  - `creator` (object, required)
    - `id` (string (uuid), required)
    - `username` (string, 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.

### 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": {
    "id": "1288b798-0b1e-4b12-b209-d0b5ae49006d",
    "extension": "jpg",
    "slot": "poster",
    "entity": {
      "kind": "movie",
      "id": 603
    },
    "language": "de",
    "edition": "fanEdit",
    "width": 2000,
    "height": 3000,
    "fileSize": 3910562,
    "set": {
      "kind": "collectionSet",
      "id": 38030
    },
    "creator": {
      "id": "ee591a84-669a-4960-a795-108404e24550",
      "username": "MrMagixx"
    },
    "createdAt": "2025-09-29T00:44:30.000Z",
    "updatedAt": "2025-09-29T00:44:30.000Z"
  }
}
```
