# Retrieve the Show index

> Returns the manifest of the Show index: every non-empty chunk with its path, `itemCount` and newest change.

`GET /shows` on `https://api.mediux.io`

Fetch the manifest, then fetch the chunks whose `updatedAt` moved since your last sync and re-validate the others with `If-None-Match` (an unchanged chunk answers `304 Not Modified`). `meta.scheme` is `idRange`: chunk `n` lists the Shows whose ID is at least `n * 10000` and below `(n + 1) * 10000`. Only non-empty chunks are listed. Each entry carries `hasSets`, `updatedAt` (the latest change to its public detail) and `artworkUpdatedAt` (the latest change to its `/assets` or `/sets`), so a library sync fetches only titles whose `artworkUpdatedAt` passed its last sync. Chunks and the manifest are refreshed hourly. The manifest is served with `Cache-Control: public, no-cache`, so send `If-None-Match` and expect `304 Not Modified` while nothing changed.

## Responses

### 200

The Show index manifest.

- `data` (array of object, required)
  - `chunk` (integer | string, required)
  - `path` (string (starts_with), required)
  - `itemCount` (integer, required)
  - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
- `meta` (object, required)
  - `scheme` (string, required): One of "idRange", "uuidPrefix".
  - `chunkSize` (integer)
  - `chunkCount` (integer, required)
  - `totalItems` (integer, 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": [
    {
      "chunk": 0,
      "path": "/shows/chunks/0",
      "itemCount": 1125,
      "updatedAt": "2026-11-20T00:01:02.644Z"
    },
    {
      "chunk": 1,
      "path": "/shows/chunks/1",
      "itemCount": 310,
      "updatedAt": "2026-11-20T00:01:02.644Z"
    },
    {
      "chunk": 2,
      "path": "/shows/chunks/2",
      "itemCount": 100,
      "updatedAt": "2026-11-20T00:01:02.644Z"
    }
  ],
  "meta": {
    "scheme": "idRange",
    "chunkSize": 10000,
    "chunkCount": 33,
    "totalItems": 7518
  }
}
```
