---
title: "List Tasks"
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# List Tasks

`GET /tasks`

List tasks with optional filtering, sorting, and pagination.

## Query parameters

- `status` 'queued' | 'created' | 'running' | 'cancelling' | 'paused' | 'completed' | 'failed' | 'cancelled'
- `query` string, nullable — Search in task description.
- `orderBy` 'id' | 'createdAt' | 'finishedAt' | 'status', nullable
- `orderByDirection` 'asc' | 'desc'
- `page` integer
- `pageSize` integer

## Response `200`

Successful Response

- PaginatedResultTaskListItem
  - `items` TaskListItem[], required — The paginated items
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `agentId` integer
    - `llmModel` string, required — The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
    - `task` string, required
    - `maxSteps` integer
    - `temperature` number
    - `reasoning` boolean
    - `accessibility` boolean
    - `vision` boolean
    - `executionTimeout` integer
    - `credentials` PackageCredentials[]
      - `packageName` string, required
      - `credentialNames` string[], required
    - `apps` string[]
    - `files` string[]
    - `outputSchema` object, nullable
    - `vpnCountry` 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA'
    - `subagentModel` string — LLM model used by sub-agent roles: executor, app_opener, structured_output
    - `stealth` boolean
    - `continueOnFailure` boolean
    - `memoryNamespace` string — Memory namespace for cross-task personalization
    - `id` string, uuid, required
    - `status` 'queued' | 'created' | 'running' | 'cancelling' | 'paused' | 'completed' | 'failed' | 'cancelled', required
    - `deviceId` string, uuid, required
    - `displayId` integer, required
    - `tmpDevice` boolean, required
    - `dispatchedAt` string, date-time, nullable
    - `claimedAt` string, date-time, nullable
    - `cancelRequestedAt` string, date-time, nullable
    - `streamUrl` string, nullable
    - `succeeded` boolean, nullable
    - `message` string, nullable
    - `output` object, nullable
    - `steps` integer, nullable
    - `finishedAt` string, date-time, nullable
    - `creditsUsed` number, nullable
    - `userId` string, required
  - `pagination` PaginationMeta, required — Pagination metadata.
    - `page` integer, required — Current page number (1-based)
    - `pageSize` integer, required — Number of items per page
    - `total` integer, required — Total number of items
    - `pages` integer, required — Total number of pages
    - `hasNext` boolean, required — Whether there is a next page
    - `hasPrev` boolean, required — Whether there is a previous page

## Other responses

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

---

[API](https://skmtc.net/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.net/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/versions/7f577998739b/schema)