# Retrieve a List title

> Returns one title of a Public Media or Game List with its chosen Assets, including Season and Episode choices.

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

`{list, entity, <family node>}`: the sparse Set tree of the title (`show`, `movie`, `collection` or `game`) whose slots hold the List's chosen Assets, each keeping its `set` and `creator`; a slot with no choice is `null`. A title that is not on the List, and Asset Lists, return `404`. Responses are stored but revalidated with the `ETag`.

## Parameters

- `id` (path, string, required): The List's ID (a lowercase UUID).
- `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)

### 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": {
    "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": []
    }
  }
}
```
