Skip to main content
GET
Python

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

Success

scenarioId
string
required
batchRunId
string
required
scenarioRunId
string
required
name
string | null
required
description
string | null
required
status
string
required

Where the run stands. PENDING_EVALUATION means the conversation is over and the judge has decided, but the evaluators the run's suite and plan attach have not been recorded yet, so a required one may still fail the run. Wait for another status before reading the verdict as final.

results
object | null
required
messages
object[]
required
timestamp
number
required
updatedAt
number
required
durationInMs
number
required
platformUrl
string<uri>
required
messagesTruncated
boolean

True when messages holds only the first few messages of a longer conversation. Pass include=messages to read them all.

totalCost
number
note
string | null

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

scenarioVersion
integer | null

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

Last modified on May 19, 2026