Autotask icon

Autotask

Work with Autotask PSA REST API resources

Actions125

Project → List Projects

AI-generated

Summary

Retrieve a list of Project records from Autotask PSA matching specified filter criteria.

Inputs

  • returnAll — Whether to fetch all matching project records or cap results at a specified limit.
  • limit — Maximum number of project records to return when Return All is disabled.
  • includeFields — Comma-separated list of Autotask field names to restrict response fields (e.g., id, projectName, companyID).
  • useAdvancedFilters — Toggles visibility of the row-builder and raw JSON filter controls.
  • advancedFilters — List of field-based condition clauses joined by AND logic.
  • filterJson — Raw Autotask filter JSON array or object for complex logical queries such as OR groups.
  • requestOptions — Additional request options, such as an Impersonation Resource ID to execute the request on behalf of a specific user.

Output shape

a list of items

Returns an array of Project entity objects from Autotask. If no filter clauses are specified, defaults to querying projects with an ID greater than or equal to 0.

Examples

Example 1: List the first 50 projects

Set Return All to false and Limit to 50.

Example 2: Fetch specific project attributes for all projects

Set Return All to true and enter field names in Include Fields (e.g., "id,projectName,companyID,status").

Example 3: Query projects using advanced field filters

Set Use Advanced Filters to true, add a Clause under Advanced Filters where Field is "status", Operator is "eq", and Value is "1".

Links

Discussion