---
title: "Get task info"
method: GET
path: "/tasks"
tags: ["[v1] Task"]
---

# Get task info

`GET /tasks`

Returns information about task or tasks.

If asked about specific task (`task_id` or `external_task_id` was provided) and no task was found it returns error status of `404 Not Found`.

## Query parameters

- `task_id` string
- `external_task_id` string
- `perms` 'create_subtask' | 'edit_task_settings' | 'track_time' | 'view_detailed_data'
- `exclude_archived` 0 | 1
- `status` 'active' | 'archived' | 'all'
- `minimal` '0' | '1'
- `ignoreAdminRights` boolean

## Response `200`

It returns an object of objects keyed with ID of a task in a tree structure.

- object
  - `[task_id]` object
    - `task_id` integer
    - `parent_id` integer, nullable
    - `assigned_by` integer, nullable
    - `name` string
    - `external_task_id` string, nullable
    - `external_parent_id` string, nullable
    - `level` integer
    - `archived` integer
    - `tags` string, nullable
    - `budgeted` integer
    - `budget_unit` string
    - `root_group_id` integer, nullable
    - `billable` integer
    - `note` string, nullable
    - `public_hash` string, nullable
    - `add_date` string
    - `modify_time` string, nullable
    - `color` string
    - `users` object
      - `[user_id]` object
        - `user_id` integer
        - `role_id` integer
    - `perms` object
      - `1` integer
      - `2` integer
      - `3` integer
      - `5` integer
      - `6` integer
      - `7` integer
    - `user_access_type` integer
    - `keywords` string, nullable

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[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)