Get Tasks

GET 
/projects/lists/:listId/tasks

Pages tasks whose primary (home) list is this list. Use limit and query searchAfter from the previous response searchAfter (opaque base64url string). Prefer Search Tasks with parentTaskId / subtaskViewMode for subtask-focused views.

Request

Version stringrequired

API Version

Available optionsv3

listId stringrequired

List id

limit number

Maximum number of tasks per page. Defaults to 50.

Possible values: >= 1 and <= 100

Default value:50

searchAfter string

Opaque searchAfter from the previous response searchAfter (base64url-encoded JSON array). Pass the string back verbatim. Legacy JSON array strings (e.g. [1738683828372,"taskId"]) are also accepted.

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Successful response

application/json

Schema

Schema

tasksobject[]required

Matching tasks

totalnumberrequired

Total matching count

searchAfterstringnullable

Opaque searchAfter (base64url-encoded JSON array, typically [sortValue, taskId]). Pass back verbatim as Search Tasks body searchAfter or Get Tasks query searchAfter. null when there is no further page.

Example (auto)

{
  "tasks": [
    {
      "id": "6a102435124ecfb348bd5509",
      "locationId": "ve9EPM428h8b87FE9C12Kg",
      "objectKey": "task",
      "assignees": [
        "user_1"
      ],
      "properties": {
        "title": "Follow up with client",
        "status": "to_do",
        "dueDate": "2026-09-20T17:00:00.000Z",
        "priority": 2,
        "primaryListId": "6a102435124ecfb348bd5507"
      }
    }
  ],
  "total": 1,
  "searchAfter": "WzE3Mzg2ODM4MjgzNzIsIjY3YTIzNWI0OWIyODk0MzFiY2Y2NTdmOCJd"
}