# List a creator's Public Lists

> Returns one page of a creator's Public Lists, newest first.

`GET /users/{username}/lists/pages/{page}` on `https://api.mediux.io`

Pages hold up to 50 items, newest `updatedAt` first with ties by ID; read `content.lists.totalPages` on the profile or `meta` on the page. Page 1 of a kind with no items is an empty list. A page number beyond the last page returns `404`.

## Parameters

- `username` (path, string, required): The User's username in lower case (the URL key `lower(username)`), as in `/account` or any embedded `owner`. A spelling with capitals answers `308 Permanent Redirect` to the lower-case path. Usernames can change: after a rename the old username is not found at once, so keep the stable `id` and re-read the username from the creators directory.
- `page` (path, integer, required): The page number, starting from 1 (the newest items).

## Responses

### 200

A page of the creator's Public Lists.

- `data` (array of object, required)
  - `kind` (string, required): One of "assetList", "mediaList", "gameList".
  - `id` (string (uuid), required)
  - `name` (string, required)
  - `description` (string, nullable, required)
  - `owner` (object, required)
    - `id` (string (uuid), required)
    - `username` (string, required)
  - `itemCount` (integer, required)
  - `subscriberCount` (integer, 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`.
- `meta` (object, required)
  - `page` (integer, required)
  - `pageSize` (integer, required)
  - `totalItems` (integer, required)
  - `totalPages` (integer, required)
  - `next` (string (starts_with), nullable, required)
  - `previous` (string (starts_with), nullable, 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": [
    {
      "kind": "mediaList",
      "id": "18ee1ad3-32d0-453f-b8df-e760cfbde4b9",
      "name": "MCU on Disney+",
      "description": "The Marvel Studios series. Synthetic dev data.",
      "owner": {
        "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
        "username": "Koltom"
      },
      "itemCount": 13,
      "subscriberCount": 0,
      "createdAt": "2026-11-18T00:50:04.966Z",
      "updatedAt": "2026-11-18T00:50:08.022Z"
    },
    {
      "kind": "mediaList",
      "id": "dcfe8ee2-7697-48e0-affe-65dfa931f640",
      "name": "MCU: The Infinity Saga",
      "description": "Phases One to Three, Iron Man to Far From Home. Synthetic dev data.",
      "owner": {
        "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
        "username": "Koltom"
      },
      "itemCount": 23,
      "subscriberCount": 0,
      "createdAt": "2026-11-18T00:50:04.966Z",
      "updatedAt": "2026-11-18T00:50:07.948Z"
    },
    {
      "kind": "mediaList",
      "id": "1fc334a8-9abc-4e58-92f1-4c97eace7352",
      "name": "MCU in Release Order",
      "description": "Every Marvel Cinematic Universe film and series in release order. Synthetic dev data.",
      "owner": {
        "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
        "username": "Koltom"
      },
      "itemCount": 47,
      "subscriberCount": 0,
      "createdAt": "2026-11-18T00:50:04.966Z",
      "updatedAt": "2026-11-18T00:50:05.083Z"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 50,
    "totalItems": 6,
    "totalPages": 1,
    "next": null,
    "previous": null
  }
}
```
