---
title: "List projects tree"
method: POST
path: "/v3/projects"
tags: ["[v3] Projects"]
---

# List projects tree

`POST /v3/projects`

List projects tree

## Headers

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

## Request body

- object
  - `parentId` integer, required — Parent ID to search (0 for root task)
  - `status` 'all' | 'active', required — Filter tasks by status
  - `context` 'invoice' | 'time_tracking' | 'reports' | 'edit_settings' | 'create_subtask' — Project tree context
  - `include` unknown[] — List of additional fields to include. Recognized extensions unavailable for the current account are ignored. The users field contains active assigned users only.
    - unknown
  - `page` integer — Page number for pagination
  - `limit` integer — Number of items per page

## 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
  - `pagination` object
    - `page` integer
    - `totalPages` 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/versions/c7e9d1f9cf61/schema)