# Get one of your Lists

> Returns a List the user owns or subscribes to, in the public List shape.

`GET /account/lists/{id}` on `https://api.mediux.io`

The same body as the public List route, including the user's private Lists. Takes no query string.

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: `lists:read`.

## Parameters

- `id` (path, string, required): The List's ID (a lowercase UUID). A List the user neither owns nor subscribes to, or a malformed ID, is `404` `list.notFound`.

## Responses

### 200

The List.

- `data` (object, required)

### 400

The request is malformed or failed validation. Inspect `error.code` and `error.issues`.

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 404

The resource does not exist or is not the user's.

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (200)

```json
{
  "data": {
    "kind": "mediaList",
    "id": "3bbc9c83-2ac1-4cdb-85db-e3634f32fb1e",
    "name": "Sample Media Library",
    "description": "Screenshot sample: shows, movies and collections",
    "owner": {
      "id": "2bd3576d-22be-453a-a780-ae27ba44401e",
      "username": "Koltom"
    },
    "itemCount": 5,
    "subscriberCount": 1,
    "createdAt": "2026-10-28T07:02:47.806Z",
    "updatedAt": "2026-10-28T07:03:11.678Z",
    "titles": [
      {
        "entity": {
          "id": 456,
          "title": "The Simpsons",
          "year": 1989,
          "kind": "show"
        },
        "position": 1,
        "poster": null,
        "choiceCount": 0,
        "updatedAt": "2026-10-28T07:03:11.678Z"
      },
      {
        "entity": {
          "id": 84,
          "title": "Indiana Jones Collection",
          "year": 1981,
          "kind": "collection"
        },
        "position": 2,
        "poster": null,
        "choiceCount": 0,
        "updatedAt": "2026-10-28T07:03:11.678Z"
      },
      {
        "entity": {
          "id": 614696,
          "title": "#Alive",
          "year": 2020,
          "kind": "movie"
        },
        "position": 3,
        "poster": null,
        "choiceCount": 0,
        "updatedAt": "2026-10-28T07:03:11.678Z"
      },
      {
        "entity": {
          "id": 63,
          "title": "Twelve Monkeys",
          "year": 1995,
          "kind": "movie"
        },
        "position": 4,
        "poster": null,
        "choiceCount": 0,
        "updatedAt": "2026-10-28T07:03:11.678Z"
      },
      {
        "entity": {
          "id": 97546,
          "title": "Ted Lasso",
          "year": 2020,
          "kind": "show"
        },
        "position": 5,
        "poster": null,
        "choiceCount": 0,
        "updatedAt": "2026-10-28T07:03:11.678Z"
      }
    ]
  }
}
```
