Get Lists In Folder

GET 
/projects/folders/:folderId/lists

Pages lists under a folder (lists[], not items). Same paging as space children. Example: open a folder view, then Create List In Folder for a client project.

Request

Version stringrequired

API Version

Available optionsv3

folderId stringrequired

Folder 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
}