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

# List Tasks

`GET /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

---

[API](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/versions/86f514b4e920/schema)