Get a run | Sarvam API Docs

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

{
  "run_id": "01K5T9C4XR7NB2QJ5WD8HKTM0E",
  "test_suite_id": "01K5T8A2MZQ4VE6XCJ0RDBHW7N",
  "app_id": "clinic-front-desk",
  "app_version": 4,
  "scope": "suite",
  "status": "running",
  "frequency": 2,
  "total_executions": 16,
  "completed_executions": 5,
  "total_pass": 4,
  "created_by": {
    "type": "api_key",
    "id": "sk_live_7f3ab1"
  },
  "created_at": "2026-09-16T05:01:12Z",
  "run_name": "Pre-release check, v4",
  "test_cases": [
    {
      "test_case_id": "01K5T8B7PS3KD9GM1FYX4VQCJ2",
      "test_case_name": "Caller reschedules to the weekend",
      "total_executions": 2,
      "passed": 2
    },
    {
      "test_case_id": "01K5T8C1JW9QA4XT6RZ0NVFD8H",
      "test_case_name": "Caller cancels without identifying themselves",
      "total_executions": 1,
      "passed": 0
    }
  ]
}

The polling endpoint for a queued run. status is created, running, completed or failed; completed_executions against total_executions gives progress. Carries per-test-case pass counts but no transcripts — read a test case’s results for those.

Path parameters

org_idstringRequired

Organization ID

workspace_idstringRequired

Workspace ID

test_suite_idstringRequired

run_idstringRequired

Response

Successful Response

run_idstring

test_suite_idstring

app_idstring

app_versioninteger

scopeenum

statusstring

frequencyinteger

total_executionsinteger

Test cases multiplied by frequency.

completed_executionsinteger

total_passinteger

created_byobject

created_atdatetime

run_namestring or nullOptional

test_caseslist of objectsOptionalDefaults to []

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Path parameters

Headers

Response

Errors