Search projects

get

https://app2.gettruss.io/api/v1/projects/search

Search and filter projects using various criteria

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

Search by project name, contact email, contact first/last name

archived

string

enum

Defaults to false

Show archived projects (default shows non-archived only)

Allowed:

watching

string

enum

Defaults to false

Show only projects the current user is watching

Allowed:

tag

string

Filter by a single tag name

project_status_id

integer

Filter by project status ID

firm_user

integer

Filter by user ID (project owner)

sort

string

enum

Defaults to updated_at

Column to sort by

direction

string

enum

Defaults to desc

Sort direction

Allowed:

query_type

string

enum

Defaults to and

How to combine advanced filters (used with filters parameter)

Allowed:

filters

array of objects

Advanced filtering array. Each filter has type, field, criteria, and value/values. NOTE: Swagger UI generates filters[0][field]=tags format. Manually change [0] to [] for Rails: filters[][field]=tags For enum fields (project_status, tags, owner, watcher): filters[][type]=enum&filters[][field]=tags&filters[][criteria]=has_any_of&filters[][values][]=tag1 For string fields: filters[][type]=string&filters[][field]=name&filters[][criteria]=contains&filters[][value]=tax For date fields: filters[][type]=date&filters[][field]=due_date&filters[][criteria]=before&filters[][value]=2024-12-31 For numeric fields: filters[][type]=number&filters[][field]=tasks_completion_percentage&filters[][criteria]=greater_than&filters[][value]=75

filters

Response

200Successful response with filtered projects