# Retrieve a creators directory bucket

> Returns one UUID-prefix bucket of the creators directory, ordered by ascending User ID.

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

Use the `path` from the manifest at `/users`. Each entry carries the User ID, username, current Avatar (`{id, extension}`) and the public item counts per kind; read `/users/{username}` (the `username` in lower case) for the full profile. A bucket that has no creators is not found.

## Parameters

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

## Responses

### 200

A bucket of the creators directory.

- `data` (array of object, required)
  - `id` (string (uuid), required)
  - `username` (string, required)
  - `avatar` (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`.
  - `contentCounts` (object, required)
    - `sets` (integer, required)
    - `boxsets` (integer, required)
    - `loadouts` (integer, required)
    - `assets` (integer, required)
    - `lists` (integer, required)
- `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": [
    {
      "id": "2b673491-47a2-4bd7-8316-4327e51ff34d",
      "username": "turnbud",
      "avatar": null,
      "contentCounts": {
        "sets": 68,
        "boxsets": 0,
        "loadouts": 0,
        "assets": 0,
        "lists": 0
      }
    },
    {
      "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
      "username": "Koltom",
      "avatar": {
        "id": "dee6cbd8-d1c1-4e3d-9f35-e55bd72ac4f4",
        "extension": "png"
      },
      "contentCounts": {
        "sets": 105,
        "boxsets": 8,
        "loadouts": 0,
        "assets": 7,
        "lists": 6
      }
    }
  ],
  "meta": {
    "chunk": "2b",
    "itemCount": 2,
    "updatedAt": "2026-11-18T00:50:04.966Z"
  }
}
```
