> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dalyenergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tasks

> List tasks with pagination and optional filtering by status, type, or date range

# GET /tasks

Retrieve a paginated list of async tasks in the workspace. Use this to monitor queued jobs, review historical task outcomes, or build operational dashboards.

## Notes

* Supports filtering by `status` (pending, queued, running, completed, failed, cancelled) and `task_type` (energy\_model, shading\_scene\_create, workflow, etc.).
* Date range filtering is available via `created_after` and `created_before` query parameters (ISO 8601 format, e.g. `2026-03-01`).
* Pagination defaults to `page=1` and `page_size=50`. Maximum page size is 1000.
* Response includes `tasks` (array), `total` (count), `page`, and `pageSize` fields.
* Read-only endpoint; does not require write access.
* Use [GET /tasks/{task_id}](/api-reference/endpoints/task-status) to fetch full details for a specific task.