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

# List tasks

> Return backup, restore, snapshot, system, and management tasks.

Returns a paginated list of tasks, including scheduled backups and on-demand restores.

## Headers

<ParamField header="Accept" type="string" default="application/api.clumio.tasks=v1+json">
  Selects version 1 of the tasks resource.
</ParamField>

<ParamField header="X-Clumio-OrganizationalUnit-Context" type="string">
  UUID of the organizational unit in which to perform the request.
</ParamField>

## Query parameters

<ParamField query="limit" type="number">
  Maximum number of tasks returned on each page.
</ParamField>

<ParamField query="start" type="string" default="1">
  Page number. Pages are indexed from `1`.
</ParamField>

<ParamField query="filter" type="string">
  JSON filter. Supported fields include `status`, `category`, `type`, `id`, and timestamps.
</ParamField>

## Response

<ResponseField name="_embedded.items" type="object[]">
  Tasks returned on the current page.
</ResponseField>

<ResponseField name="_embedded.items[].id" type="string">
  Clumio-assigned task ID.
</ResponseField>

<ResponseField name="_embedded.items[].status" type="string">
  Task state, such as `queued`, `in_progress`, `completed`, `failed`, or `aborted`.
</ResponseField>

<ResponseField name="_embedded.items[].progress_percentage" type="number">
  Completion percentage from `0` to `100`.
</ResponseField>

<ResponseField name="_links" type="object">
  HAL pagination links.
</ResponseField>

```json theme={null}
{
  "_embedded": {
    "items": [
      {
        "id": "114",
        "category": "restore",
        "status": "completed",
        "progress_percentage": 100,
        "created_timestamp": "2026-09-16T09:00:00Z"
      }
    ]
  },
  "current_count": 1,
  "start": "1"
}
```

Errors return an `errors` array containing `error_code` and `error_message`.

## Next

* [Discover API resources](/api-reference/discovery)
* [List users](/api-reference/users/list-users)