Get Lists In Space

GET 
/projects/spaces/:spaceId/lists

Pages lists directly under a space (lists[], not items; excludes lists inside folders). Same limit/cursor paging as folders; optional anchorId for centered windows. Location comes from the token.

Request

Version stringrequired

API Version

Available optionsv3

spaceId stringrequired

Space id

limit number

Maximum number of items per page

Possible values: >= 1 and <= 100

Default value:20

cursor string

Opaque base64-encoded position cursor for forward pagination

anchorId string

Optional. Center the page on this child (for example a list inside a long folder). When set, the response includes anchorId, anchorIndex, windowStart, and may include prevCursor / nextCursor. For simple forward paging, omit anchorId and use limit + cursor from nextCursor only.

application/json

Successful response

application/json

Schema

Schema

listsobject[]required

Page of lists

nextCursorstringnullable

Cursor for the next page — pass back as cursor

prevCursorstringnullable

Cursor for the previous page (anchor windows only)

anchorIdstringnullable

Echoed when the request used anchorId

anchorIndexnumber

Index of the anchor list in the window

windowStartnumber

Start offset of the current window

Example (auto)

{
  "lists": [
    {
      "id": "6a102435124ecfb348bd5507",
      "type": "list",
      "name": "Inbox",
      "locationId": "ve9EPM428h8b87FE9C12Kg",
      "color": "#3B82F6",
      "isPrivate": false,
      "position": "a0",
      "createdAt": "2026-09-20T10:00:00.000Z",
      "updatedAt": "2026-09-21T12:00:00.000Z",
      "parentId": "6a102435124ecfb348bd5508"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjIwfQ==",
  "prevCursor": "eyJvZmZzZXQiOjB9",
  "anchorId": "6a102435124ecfb348bd5507",
  "anchorIndex": 0,
  "windowStart": 0
}