Skip to main content
GET
/
api
/
evaluations
/
v3
/
runs
/
{runId}
Python
import requests

url = "https://app.langwatch.ai/api/evaluations/v3/runs/{runId}"

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

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

print(response.text)
{
  "runId": "<string>",
  "progress": 123,
  "total": 123,
  "startedAt": 123,
  "finishedAt": 123,
  "summary": {
    "runId": "<string>",
    "totalCells": 123,
    "completedCells": 123,
    "failedCells": 123,
    "duration": 123,
    "runUrl": "<string>"
  },
  "error": "<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.

Path Parameters

runId
string
required

The run ID returned from POST /api/evaluations/v3/{slug}/run

Response

Run status

runId
string
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
stopped
progress
integer
required

Number of cells completed

total
integer
required

Total number of cells

startedAt
integer

Unix timestamp when run started

finishedAt
integer

Unix timestamp when run finished (only present when completed/failed/stopped)

summary
object

Execution summary (only present when completed)

error
string

Error message (only present when failed)