---
title: "Search projects"
method: GET
path: "/projects/search"
tags: ["Projects"]
---

# Search projects

`GET /projects/search`

Search and filter projects using various criteria

## Query parameters

- `query` string
- `archived` 'true' | 'false'
- `watching` 'true' | 'false'
- `tag` string
- `project_status_id` integer
- `firm_user` integer
- `sort` 'name' | 'user' | 'due_date' | 'complete_num' | 'updated_at' | 'pending_tasks_count' | 'completed_tasks_count' | 'client' | 'action_items' | 'last_uploaded' | 'last_visited' | 'project_status_position' | 'first_sent_for_review_at'
- `direction` 'asc' | 'desc'
- `query_type` 'and' | 'or'
- `filters` object[]
  - `type` 'enum' | 'string' | 'date' | 'number', required — Data type - 'enum' for array fields, 'string' for text, 'date' for dates, 'number' for numeric
  - `field` 'project_status' | 'tags' | 'contact_tags' | 'entity_tags' | 'owner' | 'watcher' | 'tasks_completion_percentage' | 'name' | 'due_date' | 'created_at' | 'updated_at', required — Field to filter on
  - `criteria` 'has_any_of' | 'has_all_of' | 'has_none_of' | 'equals' | 'not_equals' | 'less_than' | 'less_than_or_equal_to' | 'greater_than' | 'greater_than_or_equal_to' | 'between' | 'not_between' | 'contains' | 'starts_with' | 'ends_with' | 'does_not_equal' | 'does_not_contain' | 'does_not_start_with' | 'does_not_end_with' | 'before' | 'on_or_before' | 'after' | 'on_or_after' | 'never', required — Filter criteria (depends on field and type)
  - `value` union — Single value for string, numeric, or date filters. For tasks_completion_percentage, value is 0-100 (percentage)
    - string
    - number
  - `values` union[] — Array of values for multi-value filters (use value OR values, not both). For between/not_between criteria, provide [start, end] values.
    - union
      - string
      - integer

## Response `200`

Successful response with filtered projects

- object
  - `data` object[]

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/9418bb2b65bf/schema)