List Lists

Get all reading lists.

List Lists

Returns all reading lists for the authenticated user.

curl https://twixb.com/api/v1/lists \
  -H "X-API-Key: twxb_your_key_here"

Response

[
  {
    "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