> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twixb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get List

> Get a reading list with its items.

# Get List

<div className="method-badge get">GET</div> `/v1/lists/{list_id}`

Returns a list with all its post items.

## Path parameters

| Parameter | Type          | Description |
| --------- | ------------- | ----------- |
| `list_id` | string (UUID) | List ID     |

```bash theme={null}
curl https://twixb.com/api/v1/lists/5593f707-... \
  -H "X-API-Key: twxb_your_key_here"
```

## Response

Returns the list object with an `items` array containing the saved posts.