# Retrieve a List discovery bucket

> Returns one UUID-prefix bucket of Public List discovery, ordered by ascending List ID.

`GET /lists/chunks/{prefix}` on `https://api.mediux.io`

Use the `path` from the manifest at `/lists`. Each entry carries the kind, List ID, name, owner (`{id, username}`), item count (titles on a Media or Game List, images on an Asset List), Subscriber count and `updatedAt`; read `/lists/{id}` for the titles or images. A bucket that has no Lists is not found.

## Parameters

- `prefix` (path, string, required): The bucket key: the first hexadecimal digits of the List ID, as listed in the manifest.

## Responses

### 200

A bucket of Public List discovery.

- `data` (array of object, required)
  - `kind` (string, required): One of "assetList", "mediaList", "gameList".
  - `id` (string (uuid), required)
  - `name` (string, required)
  - `owner` (object, required)
    - `id` (string (uuid), required)
    - `username` (string, required)
  - `itemCount` (integer, required)
  - `subscriberCount` (integer, required)
  - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
- `meta` (object, required)
  - `chunk` (integer | string, required)
  - `itemCount` (integer, required)
  - `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": [
    {
      "kind": "assetList",
      "id": "3b5115e3-fa0a-47da-92e5-7e7f178bab86",
      "name": "Sample Favourite Art",
      "owner": {
        "id": "b8a473d9-2f22-48f0-bd2a-c1221d7b32ca",
        "username": "e2erequester04203"
      },
      "itemCount": 0,
      "subscriberCount": 0,
      "updatedAt": "2026-10-28T06:49:02.808Z"
    },
    {
      "kind": "mediaList",
      "id": "3bbc9c83-2ac1-4cdb-85db-e3634f32fb1e",
      "name": "Sample Media Library",
      "owner": {
        "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
        "username": "Koltom"
      },
      "itemCount": 5,
      "subscriberCount": 0,
      "updatedAt": "2026-10-28T07:03:11.678Z"
    }
  ],
  "meta": {
    "chunk": "3b",
    "itemCount": 2,
    "updatedAt": "2026-10-28T07:03:11.678Z"
  }
}
```
