List runs | Sarvam API Docs

import requests
url = "https://apps.sarvam.ai/api/evals/v1/org_id/workspace_id/test-suites/test_suite_id/runs"
headers = {"X-API-Key": "<your-api-key>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "items": [
    {
      "run_id": "01K5T9C4XR7NB2QJ5WD8HKTM0E",
      "test_suite_id": "01K5T8A2MZQ4VE6XCJ0RDBHW7N",
      "app_id": "clinic-front-desk",
      "app_version": 4,
      "scope": "suite",
      "status": "completed",
      "frequency": 2,
      "total_executions": 16,
      "completed_executions": 16,
      "total_pass": 14,
      "created_by": {
        "type": "api_key",
        "id": "sk_live_7f3ab1"
      },
      "created_at": "2026-09-16T05:01:12Z",
      "run_name": "Pre-release check, v4",
      "app_name": "Clinic Front Desk"
    }
  ],
  "total": 12,
  "limit": 20,
  "offset": 0,
  "next_page_uri": null,
  "prev_page_uri": null
}

Newest first. Pass scope to see only whole-suite runs or only single-test-case runs.

Path parameters

org_idstringRequired

Organization ID

workspace_idstringRequired

Workspace ID

test_suite_idstringRequired

Query parameters

scopeenumOptional

Which kind of run to list.

Allowed values:

offsetintegerOptional>=0Defaults to 0

limitintegerOptional1-100Defaults to 20

Response

Successful Response

itemslist of objects

totalinteger

limitinteger

offsetinteger

next_page_uristring or nullOptional

prev_page_uristring or nullOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Path parameters

Headers

Query parameters

Response

Errors