List a suite's runs

GET
/v1/tests/{id}/runs

A suite's runs, newest first, each with how many cases passed, failed or were refused. Pass cursor for the next page.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The suite id.

Query Parameters

cursor?string

The nextCursor of the previous page.

Lengthlength <= 512
limit?integer

How many items to return, 1–100. Default 25.

Range1 <= value <= 100

Response Body

A page of the suite's runs, newest first

application/json
  1. response
runs*array<>
nextCursor*string|null
Example Request
curl "https://api.vlayers.ai/v1/tests/$SUITE_ID/runs" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "runs": [    {      "id": "0192f5fa-e3f2-7d40-8f90-0123456789ab",      "suiteId": "0192f5f8-c1d0-7b2e-8d7e-8f9012345678",      "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012",      "status": "queued",      "quoteMaxUsd": 1.2,      "cases": 3,      "passed": 0,      "failed": 0,      "refused": 0,      "createdBy": "user_2abc",      "createdAt": "2026-10-20T15:04:05.000Z",      "finishedAt": null,      "expiresAt": "2026-10-20T15:04:05.000Z"    }  ],  "nextCursor": null}