Skip to main content
GET
/
api
/
simulation-runs
Python
import requests

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

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

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

print(response.text)
{
  "runs": [
    {
      "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,
      "platformUrl": "<string>",
      "totalCost": 123
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

Query Parameters

scenarioSetId
string
batchRunId
string
limit
integer
default:20
Required range: x <= 100
cursor
string

Response

Success

runs
object[]
required
hasMore
boolean
nextCursor
string