List runs of an experiment

Runs recorded for one experiment, newest first. Page through them with page and pageSize.

GET /api/v1/experiments/runs

List runs of an experiment

Python

import requests

url = "https://app.langwatch.ai/api/v1/experiments/runs"

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

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

print(response.text)

200

{
  "experimentId": "<string>",
  "experimentSlug": "<string>",
  "runs": [
    {
      "experimentId": "<string>",
      "runId": "<string>",
      "workflowVersion": {
        "id": "<string>",
        "version": "<string>",
        "commitMessage": "<string>",
        "author": {
          "name": "<string>",
          "image": "<string>"
        }
      },
      "timestamps": {
        "createdAt": 123,
        "updatedAt": 123,
        "finishedAt": 123,
        "stoppedAt": 123
      },
      "summary": {
        "evaluations": {},
        "datasetCost": 123,
        "evaluationsCost": 123,
        "datasetAverageCost": 123,
        "datasetAverageDuration": 123,
        "evaluationsAverageCost": 123,
        "evaluationsAverageDuration": 123
      },
      "progress": 123,
      "total": 123
    }
  ],
  "pagination": {
    "page": 123,
    "pageSize": 123,
    "totalHits": 123,
    "hasMore": true
  }
}

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

experimentSlug · string

Slug of the experiment whose runs you want

page · integer

1-based page number

Required range: x <= 9007199254740991

pageSize · integer

Runs per page, capped at 200

Required range: x <= 9007199254740991

Response

200

application/json

Success

experimentId · string · required

experimentSlug · string · required

runs · object[] · required

Show child attributes

pagination · object · required

Show child attributes