---
title: "Get runs by flow(s)"
method: GET
path: "/run/list/flow/{ids}"
tags: ["run"]
---

# Get runs by flow(s)

`GET /run/list/flow/{ids}`

Returns an array with all runs generated by the given flow(s).

## Path parameters

- `ids` string, required

## Query parameters

- `api_key` string, required

## Response `200`

A list of runs descriptions

- RunList
  - `runs` object
    - `run` object[]
      - `run_id` string — The run ID
      - `task_id` string — The ID of the task solved by this run
      - `setup_id` string — Ignore (internal representation of the parameter setting)
      - `flow_id` string — The ID of the flow used in this run
      - `uploader` string — The ID of the person uploading this run
      - `error_message` string — Error message generated by the run (if any)

## Other responses

- `510` — Please provide at least task, flow or setup, uploader or run, to filter results, or limit the number of responses. The number of runs is huge. Please limit the result space.
- `511` — Input not safe. The input parameters (task_id, setup_id, flow_id, run_id, uploader_id) did not meet the constraints (comma separated list of integers).
- `512` — There where no results. Check whether there are runs under the given constraint.
- `513` — Too many results. Given the constraints, there were still too many results. Please add more filters.

## Changes

- **2018-01-17** `2209d99ea36e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openml/apis/openml-api/changes/run/list/flow/:ids/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/2209d99ea36e/schema)