Skip to main content

​
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

FieldTypeDescription
idstring (UUID)List ID
namestringList name
descriptionstringOptional description
is_publicbooleanWhether the list is publicly accessible
share_tokenstringToken for sharing the list
item_countintegerNumber of posts in the list