---
title: "List tasks with given status"
method: GET
path: "/task/list/status/{status}"
tags: ["task"]
---

# List tasks with given status

`GET /task/list/status/{status}`

Returns an array with all tasks in the system with the given status, either 'active', 'deactivated', or 'in_preparation'.

## Path parameters

- `status` string, required

## Query parameters

- `api_key` string

## Response `200`

A list of tasks with the given status

- DataList
  - `data` DataListData
    - `dataset` DataListDataDataset[]
      - `did` string — The dataset ID
      - `name` string — The dataset name
      - `status` string — The dataset status, either in_preparation, active, or deactivated
      - `format` string — The data format of the dataset, e.g. ARFF
      - `quality` DataListDataQuality[]
        - `name` string — The name of the property
        - `value` string — The value of the property

## Other responses

- `482` — No tasks available. There are no tasks in the system with the given status.

## Changes

- **2018-09-18** `4df86fe63217` — 1 info
  - the `query` request parameter `api_key` became optional
- **2018-01-17** `2209d99ea36e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openml/apis/openml-api/changes/task/list/status/:status/get.md)

---

[API](https://skmtc.dev/openml/apis/openml-api.md) · [All operations](https://skmtc.dev/openml/apis/openml-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openml/openml-api/revisions/4df86fe63217/schema)