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

# Get incomplete runs for an experiment

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

Get runs that need to be completed for this experiment.

Returns all incomplete runs, including both missing runs (not yet attempted)
and failed runs (attempted but have errors).

Args:
    experiment_id: The ID of the experiment
    cursor: Cursor for pagination
    limit: Maximum number of results to return

Returns:
    Paginated list of incomplete runs grouped by dataset example,
    with repetition numbers that need to be run

## Path parameters

- `experiment_id` string, required

## Query parameters

- `cursor` string, nullable — Cursor for pagination
- `limit` integer — Maximum number of examples with incomplete runs to return

## Response `200`

Incomplete runs retrieved successfully

- GetIncompleteExperimentRunsResponseBody
  - `data` IncompleteExperimentRun[], required
    - `dataset_example` DatasetExample, required
      - `id` string, required
      - `node_id` string, required
      - `input` object, required
      - `output` object, required
      - `metadata` object, required
      - `updated_at` string, date-time, required
      - `source` DatasetExampleSource
        - `span_id` string, required
        - `span_node_id` string, required
    - `repetition_numbers` integer[], required — List of repetition numbers that need to be run
  - `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/a14d8ad6f708/schema)