---
title: "GET /simulation/runs/"
method: GET
path: "/sdk/api/v1/simulation/runs/"
tags: ["sdk"]
---

# GET /simulation/runs/

`GET /sdk/api/v1/simulation/runs/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/sdk/api/v1/simulation/runs/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Run-level records with eval scores, scenario metadata, call details.

## Query parameters

- `run_test_name` string
- `execution_id` string, uuid
- `call_execution_id` string, uuid
- `eval_name` string
- `summary` boolean

## Response `200`

OK

- SDKSimulationRunsResponse
  - `status` boolean, required
  - `result` SDKSimulationRunsResult, required
    - `call_execution_id` string, uuid
    - `execution_id` string, uuid
    - `scenario_id` string, uuid
    - `scenario_name` string
    - `status` string
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `duration_seconds` number, nullable
    - `ended_reason` string, nullable
    - `call_summary` string, nullable
    - `total_calls` integer
    - `completed_calls` integer
    - `failed_calls` integer
    - `eval_outputs` object
    - `eval_results` object[]
    - `latency` object
    - `cost` object
    - `call_results` object
    - `eval_explanation_summary` object, nullable
    - `eval_explanation_summary_status` string, nullable
    - `total_pages` integer
    - `current_page` integer
    - `count` integer
    - `results` ExecutionRuns[]
      - `execution_id` string, uuid, required
      - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'cancelling' | 'evaluating': Current status of the test execution
      - `started_at` string, date-time: When the test execution started
      - `completed_at` string, date-time, nullable: When the test execution completed
      - `total_calls` integer: Total number of calls to be made
      - `completed_calls` integer: Number of successfully completed calls
      - `failed_calls` integer: Number of failed calls
      - `eval_results` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)