Get tasks
Lists the tasks belonging to the authenticated company, oldest-first (by creation time). Results never cross company boundaries and are paginated: next_page holds the URL of the following page, or null on the last page.
A task may be linked to exactly one other entity. The linked entity is returned as the matching relation field (order, invoice, purchase, contact, product, batch, assembly, return, or company); every other relation field is null. Tasks linked to an internal-only entity that has no public API model return every relation field as null.
Required permission: tasks_permissions_view.
Query parameters
Restrict the result to specific tasks by ID. Repeat the bracketed key once per ID. Unknown IDs match nothing; an empty list is treated as no filter. At most 200 IDs.
Restrict to tasks owned by specific users, by user ID. Repeat the bracketed key once per ID. At most 200 IDs.
Filter to tasks with any of these statuses. Repeat the bracketed key once per status. At most 200.
Filter to tasks linked to any of these entity kinds. Repeat the bracketed key once per kind. At most 200.
Filter by due datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
Filter by creation datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted.
Filter by last-updated datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted.
Page selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
Response
A list of tasks
Changes
No recorded changes to this endpoint across all 1 revision of this API.