---
title: "Retrieve a list of Tasks"
method: GET
path: "/v2/task"
tags: ["Tasks"]
---

# Retrieve a list of Tasks

`GET /v2/task`

## Request

- Base URL: `https://api.workiz.com/crm/api`
- URL: `https://api.workiz.com/crm/api/v2/task`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/workiz/apis/developer-api/docs/v2/task/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Beta:** Breaking changes may occur without notice.

Retrieves a paginated list of Tasks. Requires the Tasks add-on.

## Query parameters

- `pageSize` number
- `page` number
- `field` 'start' | 'status'
- `order` 'ASC' | 'DESC'

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of Tasks.

- ResponseTasksV2Dto
  - `pageSize` number: The maximum number of items returned per page.
  - `page` number: The current page number.
  - `totalResults` number: The total number of results.
  - `hasMore` boolean: Whether there are more results.
  - `data` ResponseTaskV2Dto[]: A list of Tasks.
    - `id` string: The ID of the task (prefix `TSK-`).
    - `status` 'Done' | 'Open': The status of the task.
    - `title` string: The title of the task.
    - `description` string: The description of the task.
    - `start` string: The time & date when the task starts.
    - `end` string: The time & date when the task ends.
    - `isAllDay` boolean: Whether the task is an all-day task.
    - `tags` ResponseGenericTagV2Dto[]: > **Beta:** This property is subject to change. The tags assigned to the task.
      - `id` string: The ID of the tag (prefix `TAG-`).
      - `name` string: The name of the tag.
    - `techIds` string[]: Array of tech IDs assigned to the task (prefix `USR-`).
    - `parentType` 'job' | 'lead': The parent type of the task.
    - `parentId` string: The ID of the parent job or lead (prefix `JOB-` or `LD-`).
    - `isDeleted` boolean: Whether the task is deleted.
    - `updatedAt` string: The date and time the task was updated.
    - `createdAt` string: The date and time the task was created.

## Other responses

- `400`: Invalid query parameters.
- `401`: Missing or invalid authentication token.
- `403`: The API key does not have permission to access this resource. The Tasks add-on is not active on this account.
- `429`: Rate limit exceeded.

## Changes

- **2026-11-12** `fb557783146c`: 2 warning, 1 info
  - removed the optional property `data/items/tags/items/color` from the response with the `200` status
  - removed the optional property `data/items/tags/items/type` from the response with the `200` status
  - response property `message` list-of-types was narrowed by removing types `array` from media type `application/json` of response `403`
- **2026-11-10** `bb1c25c92b05`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/workiz/apis/developer-api/changes/v2/task/get.md)

---

[API](https://skmtc.dev/workiz/apis/developer-api.md) - [All operations](https://skmtc.dev/workiz/apis/developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/workiz/apis/developer-api/revisions/fb557783146c?raw)