# Get a title in one of your Lists

> Returns one title of a Media or Game List the user owns or subscribes to, with its chosen Assets.

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

The same body as the public List title route: the title's sparse Set tree whose slots hold the List's chosen Assets, and `null` where nothing is chosen. A title that is not on the List, and Asset Lists, return `404`.

## 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`.
- `family` (path, string, required): The title's Entity family.
- `entity` (path, integer, required): The title's Mediux ID.

## Responses

### 200

The title.

- `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": {
    "list": {
      "id": "3bbc9c83-2ac1-4cdb-85db-e3634f32fb1e",
      "name": "Sample Media Library"
    },
    "entity": {
      "id": 456,
      "title": "The Simpsons",
      "year": 1989,
      "kind": "show"
    },
    "show": {
      "id": 456,
      "title": "The Simpsons",
      "year": 1989,
      "poster": null,
      "backdrop": null,
      "logo": null,
      "squareArt": null,
      "thumb": null,
      "seasons": []
    }
  }
}
```
