List Lists

GET

/v1/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