List runs for an experiment

Retrieve a paginated list of runs for an experiment

GET /v1/experiments/{experiment_id}/runs

Try it

200

{
  "data": [
    {
      "dataset_example_id": "<string>",
      "output": "<unknown>",
      "repetition_number": 123,
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "experiment_id": "<string>",
      "trace_id": "<string>",
      "error": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Path Parameters

experiment_id · string · required

Query Parameters

cursor · string | null

Cursor for pagination (base64-encoded experiment run ID)

limit · integer | null

The max number of experiment runs to return at a time. If not specified, returns all results.

Required range: x > 0

Response

200

application/json

Experiment runs retrieved successfully

data · ExperimentRun · object[] · required

Show child attributes

data. dataset_example_id · string · required

The ID of the dataset example used in the experiment run

data. output · any · required

The output of the experiment task

data. repetition_number · integer · required

The repetition number of the experiment run

data. start_time · string<date-time> · required

The start time of the experiment run

data. end_time · string<date-time> · required

The end time of the experiment run

data. id · string · required

The ID of the experiment run

data. experiment_id · string · required

The ID of the experiment

data. trace_id · string | null

The ID of the corresponding trace (if one exists)

data. error · string | null

Optional error message if the experiment run encountered an error

next_cursor · string | null · required