Productive icon

Productive

Interact with the Productive API

Actions508

Todos → Get todos

AI-generated

Summary

Retrieve a list of todos from Productive, optionally filtering, paginating, and limiting the results.

Inputs

  • Return All — Choose whether to return all todos or only a limited number.
  • Limit — Maximum number of todo results to return when not returning all.
  • Page Number — Page number of results to retrieve (starting at 1) when pagination is used.
  • Page Size — Number of todos to return per page (max 200) when pagination is used.
  • Filter Query String — Literal filter query string for advanced filtering, overriding other filters.
  • Filters — Structured filters by todo fields such as Assignee ID, Deal ID, Due Date, Status, or Task ID, using operations like equals, contains, greater than, and others. Ignored if Filter Query String is set.

Output shape

An array of todo objects matching the filters and pagination parameters.

When Return All is true, all matching todos are returned; otherwise, results are limited by pagination settings. If filters are provided, they are applied unless a Filter Query String is specified which overrides all filters.

Examples

Example 1: Fetch all todos assigned to a specific user with status 'open'

Set Return All to true and Filters to Assignee ID equals user ID and Status equals open.

Example 2: Fetch page 2 with 30 todos per page filtered by Due Date greater than today

Set Return All to false, Page Number to 2, Page Size to 30, and Filters to Due Date greater than filter value of today.

Discussion