List the project's runs, newest first

List the project’s runs, newest first. The project comes from the credential, so a run of another project is never listed. Page through them with before, which takes the created time of the oldest run the previous page carried.

GET /api/v1/instant-evals

Python

Python

import requests

url = "https://app.langwatch.ai/api/v1/instant-evals"

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

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

print(response.text)

200

{
  "runs": [
    {
      "id": "<string>",
      "name": "<string>",
      "sql": "<string>",
      "parameters": {},
      "questions": [
        {
          "id": "<string>",
          "function": "<string>",
          "kind": "boolean",
          "reads": "<string>",
          "threshold": 123
        }
      ],
      "limit": 0,
      "status": "queued",
      "total": 0,
      "progress": 0,
      "matched": 0,
      "matchedByQuestion": {},
      "failed": 0,
      "skipped": 0,
      "tokens": 0,
      "priceUsd": 123,
      "error": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "startedAt": "<string>",
      "finishedAt": "<string>"
    }
  ]
}

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

limit · integer · default: 20

Runs to list, at most one hundred.

Required range: 1 <= x <= 100

before · string<date-time>

List runs accepted strictly before this instant, as an ISO 8601 timestamp. Half of the list's cursor: pass beforeId with it.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

beforeId · string

The id of the last run of the previous page. Two runs can share an instant, so this is what keeps a page from skipping the others written in the same millisecond.

Required string length: 1 - 200

Response

200 - application/json

Success

runs · object[] · required

The project's runs, newest first.

Show child attributes