Productive icon

Productive

Interact with the Productive API

Actions508

Tasks → Get tasks

AI-generated

Summary

Retrieve a collection of tasks from the Productive API applying optional filtering, sorting, and pagination.

Inputs

  • Return All — Boolean flag to return all tasks matching filters instead of limiting results.
  • Limit — Maximum number of tasks to return when 'Return All' is false.
  • Page Number — The page number to retrieve when paginating results and 'Return All' is false.
  • Page Size — Number of tasks returned per page in pagination, maximum 200, used when 'Return All' is false.
  • Filter Query String — Literal filter query string to override all other filters; supports Productive API syntax for multiple filters.
  • Filters — One or more filters on task fields (ignored if Filter Query String is used). Each filter specifies a field, an operation (e.g., equals, contains), and a value.
  • Sort By — Field by which to sort the retrieved tasks.
  • Sort Order — Order direction for sorting: ascending or descending.

Output shape

a list of task objects matching the applied filters, sorted and paginated as specified

Results are paginated when 'Return All' is false, limited by 'Limit', 'Page Number', and 'Page Size' parameters; if 'Return All' is true, all matching tasks are returned ignoring pagination. Filtering can be done either by providing a raw filter query string or by using the advanced filters UI. Errors during retrieval can result in error messages when 'Continue On Fail' is enabled.

Examples

Example 1: Fetch up to 50 tasks assigned to a specific user, sorted by due date in ascending order.

Return All = false; Limit = 50; Filters include Assignee ID equals specific user ID; Sort By = Due Date; Sort Order = Ascending

Example 2: Retrieve all tasks with status 'Open' without pagination.

Return All = true; Filters include Status equals 'Open'

Discussion