---
title: "List runs for an experiment"
method: GET
path: "/v1/experiments/{experiment_id}/runs"
tags: ["experiments"]
---

# List runs for an experiment

`GET /v1/experiments/{experiment_id}/runs`

Retrieve a paginated list of runs for an experiment

## Path parameters

- `experiment_id` string, required

## Query parameters

- `cursor` string, nullable — Cursor for pagination (base64-encoded experiment run ID)
- `limit` integer, nullable — The max number of experiment runs to return at a time. If not specified, returns all results.

## Response `200`

Experiment runs retrieved successfully

- ListExperimentRunsResponseBody
  - `data` ExperimentRun[], required
    - `dataset_example_id` string, required — The ID of the dataset example used in the experiment run
    - `output` unknown, required
    - `repetition_number` integer, required — The repetition number of the experiment run
    - `start_time` string, date-time, required — The start time of the experiment run
    - `end_time` string, date-time, required — The end time of the experiment run
    - `trace_id` string, nullable — The ID of the corresponding trace (if one exists)
    - `error` string, nullable — Optional error message if the experiment run encountered an error
    - `id` string, required — The ID of the experiment run
    - `experiment_id` string, required — The ID of the experiment
  - `next_cursor` string, nullable, required

## Other responses

- `403` — Forbidden
- `404` — Experiment not found
- `422` — Invalid cursor format

---

[API](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/versions/5339b2afd3a2/schema)