---
title: "Search in projects tree"
method: POST
path: "/v3/projects/search"
tags: ["[v3] Projects"]
---

# Search in projects tree

`POST /v3/projects/search`

Search in projects tree

## Headers

- `Accept` string
- `Content-Type` string

## Request body

- object
  - `searchText` string — Phrase to search for. At least one of `searchText` or `userIds` is required.
  - `userIds` integer[] — User IDs directly assigned to returned projects. At least one of `searchText` or `userIds` is required.
  - `status` 'all' | 'active', required — Filter tasks by status
  - `context` 'invoice' | 'time_tracking' | 'reports' | 'edit_settings' | 'create_subtask' — Project tree context
  - `include` string[] — List of additional fields to include. Recognized extensions unavailable for the current account are ignored.

## Response `200`

OK

- object
  - `data` ProjectsItem[]
    - `taskId` integer
    - `name` string
    - `parentId` integer
    - `level` integer
    - `note` unknown
    - `rootGroupId` integer
    - `archived` integer
    - `billable` unknown
    - `hasChildren` unknown
    - `children` unknown[]
      - unknown
    - `disabled` unknown
    - `disableReason` string
  - `meta` object
  - `searchInfo` object
    - `items` integer
    - `total` integer

## Other responses

- `403` — The authenticated OAuth2 access token or PAT does not contain any scope accepted by the endpoint.
- `default` — Default

---

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