# Retrieve the creators directory

> Returns the manifest of the creators directory: every bucket with its path and creator count.

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

Fetch the manifest, fetch any new buckets and re-validate the buckets you hold with `If-None-Match` (an unchanged bucket answers `304 Not Modified`). Bucket `xx` lists the creators whose User ID starts with those two lower-case hexadecimal digits. A creator is listed when they have at least one public Show, Movie, Collection or Game Set, Boxset, Loadout, Asset or Public List and are not hidden, banned or a system account. Buckets and the manifest are refreshed hourly, except that a creator who is banned or hidden leaves at once. 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 creators directory 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": "02",
      "path": "/users/chunks/02",
      "itemCount": 1,
      "updatedAt": "2024-02-14T14:07:40.000Z"
    },
    {
      "chunk": "03",
      "path": "/users/chunks/03",
      "itemCount": 1,
      "updatedAt": "2026-04-09T08:08:20.000Z"
    },
    {
      "chunk": "05",
      "path": "/users/chunks/05",
      "itemCount": 4,
      "updatedAt": "2026-06-11T17:33:57.000Z"
    }
  ],
  "meta": {
    "scheme": "uuidPrefix",
    "chunkCount": 176,
    "totalItems": 310
  }
}
```
