# Retrieve a Category's Assets

> Returns every public Asset made for this Category, grouped by slot.

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

Groups are always present, complete and newest first.

## Parameters

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

## Responses

### 200

The Category's Assets.

- `data` (object, required)
  - `posters` (array of object, 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)
    - `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`.
  - `thumbs` (array of object, 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)
    - `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": {
    "posters": [],
    "thumbs": []
  }
}
```
