---
title: "List Order Tasks"
method: GET
path: "/orders/{order_handle}/tasks"
tags: ["Orders"]
---

# List Order Tasks

`GET /orders/{order_handle}/tasks`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/orders/{order_handle}/tasks`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/orders/:order_handle/tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all tasks associated with a specific order.

## Path parameters

- `order_handle` string, required

## Query parameters

- `fulfillment_attempt` integer, nullable

## Response `200`

Successful response

- OrderTaskListResponse
  - `tasks` OrderTaskResponse[], required: List of tasks associated with the order.
    - `label` string, required: Type of task to be created for the order.
    - `task_definition_id` string, nullable: Id of the tasks definition from which this task is picked
    - `description` string, nullable: Description of the task type.
    - `metadata` object, nullable: Additional metadata for the task.
    - `priority` 'none' | 'low' | 'medium' | 'high' | 'null', nullable: Priority of the task. Valid values are none, low, medium, high.
    - `task_id` string, required: Unique identifier for the created task.
    - `status` string, nullable: Status of the task. Valid values are pending, ongoing, completed, cancelled.
    - `created_at` string, required: Timestamp when the task was created.
    - `updated_at` string, nullable: Timestamp when the task was last updated.
    - `attachments` union[], nullable: Attachments associated with the event
      - union
        - ImageAttachmentResponse
          - `type` 'image', required: Type of attachment
          - `url` string, required: Image link
          - `caption` string, nullable: Caption for the image
          - `attachment_id` string, nullable
        - NoteAttachmentResponse
          - `type` 'note', required: Type of attachment
          - `data` string, required: Text for the note
          - `attachment_id` string, nullable
        - SignatureAttachmentResponse
          - `type` 'signature', required: Type of attachment
          - `url` string, required: Signature image link
          - `attachment_id` string, nullable

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `404`: Not Found

---

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