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

# List Tasks

`GET /v1/research/tasks`

List research tasks for the authenticated user.

## Query parameters

- `status` 'running' | 'succeeded' | 'failed', nullable — Filter by task status: running, succeeded, or failed.
- `page_size` integer, nullable
- `cursor` string, nullable

## Response `200`

Successful Response

- TaskListResponse
  - `tasks` TaskListItem[], required
    - `task_id` string, required — Unique identifier for this task
    - `query` string, required — Task or research query submitted by the caller
    - `status` 'running' | 'succeeded' | 'failed', required — Lightweight task status for list views, derived from stored task state: 'succeeded' (results are retrievable), 'failed' (terminal with no retrievable results), or 'running' (everything else). Because it is computed without a live workflow lookup, 'running' also covers queued tasks and the brief window before a finished workflow is reconciled in the database. Call GET /v1/{browsing,research}/tasks/{id} for the authoritative queued/running/succeeded/failed status of a single task.
    - `created_at` string, date-time, required — When the task was created
    - `view_url` string, required — URL to view this task in the API platform dashboard
    - `rejection_reason` 'insufficient_prepaid_balance' | 'budget_exceeded' | 'subscription_inactive'
  - `total` integer — Total count of all tasks (running + succeeded + failed)
  - `filtered_total` integer — Count of tasks matching the current filter
  - `summary` TaskListSummary — Summary counts of one-time tasks by lightweight list status.
    - `running` integer, required — Number of tasks still running
    - `succeeded` integer, required — Number of tasks with retrievable results
    - `failed` integer, required — Number of terminal tasks without retrievable results
  - `page_size` integer, nullable — Requested page size (null if returning all)
  - `has_more` boolean — Whether more results exist after this page
  - `prev_cursor` string, nullable — Cursor for previous page
  - `next_cursor` string, nullable — Cursor for next page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/yutori/apis/fastapi.md) · [All operations](https://skmtc.dev/yutori/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yutori/fastapi/revisions/ef669f82d5bc/schema)