---
title: "get tasks"
method: GET
path: "/{region}/v1/projects/{projectId}/tasks"
---

# get tasks

`GET /{region}/v1/projects/{projectId}/tasks`

Get tasks

## Response `200`

OK

- object
  - `paging` HttpPaging
    - `next` HttpPage
      - `after` string
      - `link` string
  - `results` Task[]
    - `assignedTo` User[] — * Optional task fields
      - `displayName` string
      - `email` string
      - `id` string
    - `calendar` TaskCalendar
      - `id` string
      - `name` string
      - `type` 'five-day' | 'six-day' | 'seven-day' | 'two-day' | 'custom'
    - `duration` integer
    - `externalId` string
    - `finish` string
    - `folder` TaskFolder
      - `code` string
      - `id` string
      - `name` string
      - `parentId` string
      - `path` string
    - `id` string — * Default task fields
    - `keyTask` boolean
    - `labour` TaskLabour[]
      - `id` string
      - `name` string
      - `quantity` number
    - `location` TaskLocation
      - `id` string
      - `name` string
      - `type` 'map' | 'drawing' | 'off-site'
    - `materials` TaskMaterial[]
      - `dailyActual` ResourceAllocation[]
        - `date` string
        - `quantity` number
      - `dailyPlanned` ResourceAllocation[]
        - `date` string
        - `quantity` number
      - `id` string
      - `name` string
      - `quantity` number
      - `unit` string
    - `name` string
    - `notes` string
    - `owner` User
      - `displayName` string
      - `email` string
      - `id` string
    - `package` TaskPackage
      - `code` string
      - `id` string
      - `name` string
    - `parent` TaskParent
      - `id` string
      - `name` string
    - `plant` TaskPlant[]
      - `category` string
      - `id` string
      - `name` string
      - `quantity` number
    - `progress` TaskStatusEvent[]
      - `amount` integer
      - `date` string
      - `name` string
      - `type` 'delay' | 'not-started' | 'on-schedule' | 'shortened' | 'started-early'
    - `relatedTasks` RelatedTask[]
      - `id` string
      - `lag` integer
      - `name` string
      - `relation` 'predecessor' | 'successor'
      - `type` 'start-start' | 'start-finish' | 'finish-start' | 'finish-finish'
    - `shift` 'day' | 'afternoon' | 'night' | '24hr'
    - `start` string
    - `status` 'planned' | 'promised' | 'done'
    - `subcontractor` Subcontractor
      - `id` string
      - `name` string
    - `workArea` GeojsonFeature
      - `bbox` number[]
      - `geometry` unknown
      - `id` unknown
      - `properties` GeojsonProperties
      - `type` string

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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