Productive icon

Productive

Interact with the Productive API

Actions508

Projects → Get projects

AI-generated

Summary

Retrieve a list of projects from the Productive API, with optional filtering, pagination, and result limits.

Inputs

  • Return All — Boolean to decide whether to fetch all matching projects or restrict the number of returned results.
  • Limit — Maximum number of projects to return when not returning all.
  • Page Number — Page number of results to retrieve when paginating (default 1).
  • Page Size — Number of projects per page when paginating results (default 30, max 200).
  • Filter Query String — A literal filter query string that overrides all other filters if provided.
  • Filters — One or more filters by specific project fields such as Company ID, ID, Person ID, Project Type, Query, Responsible ID, or Status; each filter includes a field, operation (e.g., equals, contains), and value. Ignored if Filter Query String is set.

Output shape

A list of project records matching the specified filters and pagination criteria.

If 'Return All' is true, all available projects are returned regardless of filtering limits. If false, pagination with 'Limit', 'Page Number', and 'Page Size' parameters is applied. The filter options are ignored if a literal 'Filter Query String' is provided.

Examples

Example 1: Get all projects with status 'active' and responsible ID equals to '1234' limited to 50 projects.

Set 'Return All' to false, specify Filters for Status equals 'active' and Responsible ID equals '1234', and set Limit to 50.

Discussion