---
title: "List Tasks"
method: GET
path: "/api/v1/tasks"
---

# List Tasks

`GET /api/v1/tasks`

List tasks, optionally filtered by status, cell_id, and/or claim owner.

When ``limit`` or ``offset`` query params are provided the response is a
paginated envelope (``{tasks, total, limit, offset}``).  Without them,
the legacy flat list is returned for backward compatibility, capped at
``_LIST_TASKS_HARD_CAP`` items and accompanied by a ``Deprecation``
header asking callers to pass explicit pagination.

Args:
    request: FastAPI request.
    status: If provided, only tasks with this status are returned.
    cell_id: If provided, only tasks in this cell are returned.
    tenant: Tenant scope override.
    claimed_by_session: If provided, only tasks claimed by this parent
        orchestrator session are returned.
    limit: Maximum number of tasks to return (max 500).  Triggers
        paginated response when present.
    offset: Number of tasks to skip.  Triggers paginated response
        when present.

Returns:
    Paginated response **or** plain list of TaskResponse dicts (capped
    at ``_LIST_TASKS_HARD_CAP``).

## Query parameters

- `status` string, nullable
- `cell_id` string, nullable
- `tenant` string, nullable
- `claimed_by_session` string, nullable
- `parent_session_id` string, nullable
- `limit` integer, nullable
- `offset` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `403` — Tenant scope access denied
- `404` — Resource not found or tenant mismatch
- `422` — Validation Error

## Changes

> 15 revisions in range; 7 could not be searched.

- **2026-07-26** `2a1299ef19fa` — 3 info
  - removed `#/components/schemas/PaginatedTasksResponse, subschema #2` from the response body `anyOf` list for the response status `200`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/api/v1/tasks/get.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)