Endpoints that can return many results, such as tasks, subtasks, projects, timesheet reports and bulk exports, return them one page at a time and accept filters and sorting as query parameters.
| Parameter | Description | Default |
|---|
page | Page number, starting at 0 | 0 |
size | Number of results per page | 20 |
Task, subtask and project lists return hasMore. When it is true, request the next page. Bulk export pages work differently and return hasNext and totalPages.Sorting#
Use sort=property,asc or sort=property,desc. The default order is ascending, and you can repeat sort to sort by more than one property.?sort=dueDate,asc&sort=priority,desc
Filtering tasks#
| Filter | Type |
|---|
title | Text |
status, priority, tags, creators, owners | Lists of values |
startDate, dueDate, createdTime, modifiedTime | Date-time (ISO 8601) |
overdue, dueDateSet, pending, upcoming | true or false |
customFields | JSON string (see below) |
Custom field conditions#
The customFields filter takes a JSON string. These conditions are supported:| Field type | Conditions |
|---|
| All fields | IS, ISNOT, CONTAINS, NOTCONTAINS, STARTSWITH, ENDSWITH, ISEMPTY, ISNOTEMPTY |
| Date fields | Also BEFORE, AFTER, BETWEEN, NOTBETWEEN, TODAY, TOMORROW |
Date values in custom field filters are epoch milliseconds. BETWEEN and NOTBETWEEN take two values; TODAY and TOMORROW take none. Modified at 2026-11-10 17:13:01
