---
title: "List the tasks for the given Workflow ID and filter parameters"
method: GET
path: "/workflow/{workflowId}/tasks"
tags: ["workflows"]
---

# List the tasks for the given Workflow ID and filter parameters

`GET /workflow/{workflowId}/tasks`

## Path parameters

- `workflowId` string, required

## Query parameters

- `workspaceId` integer
- `max` integer
- `offset` integer
- `sortBy` string
- `sortDir` string
- `search` string

## Response `200`

OK

- ListTasksResponse
  - `tasks` DescribeTaskResponse[]
    - `task` Task
      - `attempt` integer
      - `cloudZone` string
      - `complete` string, date-time
      - `container` string
      - `cost` number
      - `cpus` integer
      - `dateCreated` string, date-time, nullable
      - `disk` integer
      - `duration` integer
      - `env` string
      - `errorAction` string
      - `errorMessage` string, nullable
      - `executor` string
      - `exit` integer
      - `exitStatus` integer
      - `gpuMetrics` GpuMetrics
        - `active_time` integer
        - `avg_mem` integer
        - `avg_mem_bw_util` number, double
        - `driver` string
        - `mem` integer
        - `name` string
        - `pct` number, double
        - `pct_mem` number, double
        - `peak` number, double
        - `peak_mem` number, double
        - `peak_mem_bw_util` number, double
        - `peak_mem_used` integer
      - `hash` string
      - `id` integer, nullable
      - `invCtxt` integer
      - `lastUpdated` string, date-time, nullable
      - `logStreamId` string
      - `machineType` string
      - `memory` integer
      - `module` string[]
      - `name` string
      - `nativeId` string
      - `numSpotInterruptions` integer
      - `pcpu` number, double
      - `peakRss` integer
      - `peakVmem` integer
      - `pmem` number, double
      - `priceModel` 'standard' | 'spot'
      - `process` string
      - `queue` string
      - `rchar` integer
      - `readBytes` integer
      - `realtime` integer
      - `resourceAllocation` ResourceAllocation
        - `acceleratorCount` integer
        - `acceleratorName` string
        - `acceleratorType` string
        - `cpuShares` integer
        - `memoryMiB` integer
        - `time` string
      - `rss` integer
      - `scratch` string
      - `script` string
      - `start` string, date-time
      - `status` 'NEW' | 'SUBMITTED' | 'RUNNING' | 'CACHED' | 'COMPLETED' | 'FAILED' | 'ABORTED', required
      - `submit` string, date-time
      - `syscr` integer
      - `syscw` integer
      - `tag` string
      - `taskId` integer, required
      - `time` integer
      - `vmem` integer
      - `volCtxt` integer
      - `wchar` integer
      - `workdir` string
      - `writeBytes` integer
  - `total` integer

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

---

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