---
title: "List ScenarioRuns."
method: GET
path: "/v1/scenarios/runs"
tags: ["Scenario"]
---

# List ScenarioRuns.

`GET /v1/scenarios/runs`

List all ScenarioRuns matching filter.

## Query parameters

- `name` string
- `state` string
- `benchmark_run_id` string
- `scenario_id` string
- `search` string
- `limit` integer
- `starting_after` string
- `include_total_count` boolean

## Response `200`

OK

- ScenarioRunListView
  - `runs` ScenarioRunView[], required — List of ScenarioRuns matching filter.
    - `id` string, required — ID of the ScenarioRun.
    - `name` string, nullable — Optional name of ScenarioRun.
    - `scenario_id` string, required — ID of the Scenario that has been run.
    - `devbox_id` string, required — ID of the Devbox on which the Scenario is running.
    - `benchmark_run_id` string, nullable — ID of the BenchmarkRun that this Scenario is associated with, if any.
    - `scoring_contract_result` ScoringContractResultView — A ScoringContractResultView represents the result of running all scoring functions on a given input context.
      - `score` number, float, required — Total score for all scoring contracts. This will be a value between 0 and 1.
      - `scoring_function_results` ScoringFunctionResultView[], required — List of all individual scoring function results.
        - `score` number, float, required — Final score for the given scoring function.
        - `scoring_function_name` string, required — Scoring function name that ran.
        - `output` string, required — Log output of the scoring function.
        - `state` 'unknown' | 'complete' | 'error', required
    - `start_time_ms` integer — The time that the scenario started
    - `duration_ms` integer, nullable — Duration scenario took to run.
    - `state` 'running' | 'scoring' | 'scored' | 'completed' | 'canceled' | 'timeout' | 'failed', required
    - `metadata` object, required — User defined metadata to attach to the scenario run for organization.
    - `purpose` string, nullable — Purpose of the ScenarioRun.
    - `environment_variables` object, nullable — Environment variables used to run the scenario.
    - `secrets_provided` object, nullable — User secrets used to run the scenario.
  - `has_more` boolean, required
  - `total_count` integer, nullable

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/e9dc776053e4/schema)