---
title: "Get run description"
method: GET
path: "/run/{id}"
tags: ["run"]
---

# Get run description

`GET /run/{id}`

Returns information about a run. The information includes the name, information about the creator, dependencies, parameters, run instructions and more.

## Path parameters

- `id` number, required

## Query parameters

- `api_key` string

## Response `200`

A run description

- Run
  - `run_description` RunRunDescription
    - `id` string — ID of the run, a positive integer
    - `uploader` string — The uploader of the run
    - `uploader_name` string — The name of the uploader of the run
    - `task_id` string — The id of the task solved by this run
    - `task_type` string — The type of task solved by this run (e.g., classification)
    - `task_evaluation_measure` string — The evaluation measure that is supposed to be optimized in the task, if any
    - `flow_id` string — The id of the flow used in this run
    - `flow_name` string — The name of the flow used in this run
    - `setup_string` string — Configuration of the flow as a string, to be interpreted by the flow, its library, or command line interface.
    - `tag` string[] — Tags added by OpenML users. Includes study tags in the form `study_1`
    - `parameter_setting` RunRunDescriptionParameterSetting[]
      - `name` string — The name of the parameter
      - `value` string — The value of the parameter used
    - `input_data` RunRunDescriptionInputData — The input data for this run.
      - `dataset` RunRunDescriptionInputDataDataset
        - `did` string — The id of the dataset
        - `name` string — The name of the dataset
        - `url` string — The download url of the dataset
    - `output_data` RunRunDescriptionOutputData — The data generated by this run.
      - `file` RunRunDescriptionOutputDataFile[]
        - `did` string — The id of the uploaded file
        - `file_id` string — The reference id of the uploaded file, for downloading afterward
        - `name` string — The name of the uploaded file (e.g., description, predictions, model,...)
      - `evaluation` RunRunDescriptionOutputDataEvaluation[]
        - `name` string — The name of the evaluation measure
        - `flow_id` string — The id of the code used to compute this evaluation method
        - `value` string — The result of the evaluation
        - `array_data` string — For composite evaluation measures (e.g. per-class measures, confusion matrix), a string (JSON) representation of the evaluation.

## Other responses

- `412` — Precondition failed. An error code and message are returned. 220 - Please provide run ID. In order to view run details, please provide the run ID. 221 - Run not found. The run ID was invalid, run does not exist (anymore).

---

[API](https://skmtc.net/openml/apis/openml-api.md) · [All operations](https://skmtc.net/openml/apis/openml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openml/openml-api/versions/263d3d6ee586/schema)