> ## 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.

# List Lists

> Get all reading lists.

# List Lists

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

Returns all reading lists for the authenticated user.

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

## Response

```json theme={null}
[
  {
    "id": "5593f707-f53c-471f-83b5-bc85cebcb395",
    "name": "Must Read",
    "description": null,
    "is_public": false,
    "share_token": null,
    "item_count": 5,
    "created_at": "2026-02-09T15:02:28.722079",
    "updated_at": "2026-02-09T15:02:28.722085"
  }
]
```

## Response fields

| Field         | Type          | Description                             |
| ------------- | ------------- | --------------------------------------- |
| `id`          | string (UUID) | List ID                                 |
| `name`        | string        | List name                               |
| `description` | string        | Optional description                    |
| `is_public`   | boolean       | Whether the list is publicly accessible |
| `share_token` | string        | Token for sharing the list              |
| `item_count`  | integer       | Number of posts in the list             |