---
title: "Retrieves a paginated list of tasks with details including assignees, dates, status, priority, tags, and time tracking. Supports filtering by project, section, status, priority, due date range, assigned user, completion state, and parent task / hierarchy."
method: GET
path: "/api/Task"
tags: ["Task"]
---

# Retrieves a paginated list of tasks with details including assignees, dates, status, priority, tags, and time tracking. Supports filtering by project, section, status, priority, due date range, assigned user, completion state, and parent task / hierarchy.

`GET /api/Task`

## Query parameters

- `UpdatedAfter` string, date-time
- `pageSize` integer
- `pageNumber` integer
- `Sort` string
- `isComplete` boolean
- `ProjectID` integer
- `TaskStatusCode` string
- `TaskPriorityCode` string
- `DueDateFrom` string, date-time
- `DueDateTo` string, date-time
- `AssignedToUserIDs` integer[]
- `ParentTaskIDFK` integer
- `isRootLevel` boolean

## Response `200`

Returns a paginated list of tasks with full details.

- TaskList — Paginated collection of tasks.
  - `Tasks` TaskDetails[] — List of task records for this page.
    - `TaskID` integer — Unique identifier for the task.
    - `ProjectIDFK` integer — The project this task belongs to.
    - `ProjectTitle` string — Title of the parent project.
    - `ProjectCode` string — Short code of the parent project.
    - `SectionTitle` string — Title of the section this task is in.
    - `SectionIDFK` integer — The section (task group) this task belongs to.
    - `Title` string — Task title/name.
    - `Description` string — Task description (may contain HTML).
    - `DescriptionNoHTML` string — Task description with HTML tags stripped.
    - `AssignedToUsers` AssignedToUser[] — List of users assigned to this task.
      - `AssignedToUserIDFK` integer — User ID of the assigned user.
      - `AssignedToEmail` string — Email of the assigned user.
      - `AssignedToFirstname` string — First name of the assigned user.
      - `AssignedToLastname` string — Last name of the assigned user.
    - `DateStart` string, date-time — Task start date.
    - `DateDue` string, date-time — Task due date.
    - `DateCompleted` string, date-time — Date the task was marked as completed.
    - `EstimatedEffort` number, double — Estimated effort in decimal hours.
    - `ActualTime` number, double — Actual time logged against this task in decimal hours.
    - `Tags` TagItem[] — List of tags applied to this task.
      - `TagID` integer — Unique identifier for the tag.
      - `Name` string — Tag name.
      - `Color` string — Hex color code for the tag (e.g. '#FF5733').
    - `AccountTaskTypeIDFK` integer — The task type (workflow) ID for this task.
    - `TaskStatusCode` string — Current task status code.
    - `TaskStatusName` string — Display name of the current task status.
    - `isCompleteStatus` boolean — Whether the current status represents a completed state.
    - `PercentComplete` number, double — Task completion percentage (0-100).
    - `TaskPriorityCode` string — Task priority. Values: None, Low, Medium, High, Urgent.
    - `TaskPriorityName` string — Display name of the task priority.
    - `ViewTaskURL` string — URL to view this task in the Avaza web application.
    - `DateCreated` string, date-time — Date and time the task was created.
    - `DateUpdated` string, date-time — Date and time the task was last updated.
    - `ParentTaskIDFK` integer — Parent task ID if this is a subtask. NULL for root-level tasks.
    - `ParentTaskTitle` string — Title of the parent task (denormalized for display). NULL for root-level tasks.
    - `SubtaskCount` integer — Number of immediate subtasks under this task.
    - `SubtaskProgress` integer — Percentage of subtasks in a complete status (0-100).
    - `FileAttachments` TaskFileAttachmentItem[] — File attachments currently linked to this task.
      - `FileAttachmentIDFK` integer — Foreign key to the FileAttachment record.
      - `AttachmentURL` string — Public URL to download the file.
      - `AttachmentPreviewURL` string — URL for in-browser preview of the file. Empty for non-previewable file types.
  - `TotalCount` integer — Total number of tasks matching the filter criteria.
  - `PageNumber` integer — Current page number (1-based).
  - `PageSize` integer — Number of results per page.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)