Get a single simulation run by its ID

Get a single simulation run by its ID

GET /api/simulation-runs/{scenarioRunId}

Python

Python

import requests

url = "https://app.langwatch.ai/api/simulation-runs/{scenarioRunId}"

headers = {"X-Auth-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "scenarioId": "<string>",
  "batchRunId": "<string>",
  "scenarioRunId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "status": "<string>",
  "results": {
    "verdict": "<string>",
    "reasoning": "<string>",
    "metCriteria": [
      "<string>"
    ],
    "unmetCriteria": [
      "<string>"
    ],
    "error": "<string>"
  },
  "messages": [
    {
      "role": "<string>",
      "content": "<string>"
    }
  ],
  "timestamp": 123,
  "updatedAt": 123,
  "durationInMs": 123,
  "note": "<string>",
  "scenarioVersion": 123,
  "platformUrl": "<string>",
  "totalCost": 123
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

scenarioRunId · string · required

Response

200

application/json

Success

scenarioId · string · required

batchRunId · string · required

scenarioRunId · string · required

name · string | null · required

description · string | null · required

status · string · required

results · object | null · required

Show child attributes

messages · object[] · required

Show child attributes

timestamp · number · required

updatedAt · number · required

durationInMs · number · required

note · string | null · required

One short line saying why the run was started, as given when it was queued. Null on a run started without one.

scenarioVersion · integer | null · required

The version of the scenario at the moment the run was queued. Null on runs recorded before versions existed.

platformUrl · string<uri> · required

totalCost · number