list_runs

List the project's recent test runs, newest first.

List the project's recent runs, newest first.

Request

GET /api/v1/ops/projects/{project}/runs?limit=20[&status=]

Parameter	In	Type	Required	Description
project	path	string	yes	The project's public id.
limit	query	integer	no	Max runs to return (default 20).
status	query	string	no	Only runs with this status (e.g. failed, running, passed).

cURL

curl -H "Authorization: Bearer $TESTVIBE_API_KEY" \
  "$TESTVIBE_SERVER/api/v1/ops/projects/$PROJECT/runs?limit=5&status=failed"

CLI

testvibe runs list --status failed

MCP

Tool list_runs — { "limit": 5, "status": "failed" } (both optional).

Response

[
  {
    "runId": 214,
    "status": "passed",
    "featureId": 12,
    "featureName": "Login Functionality",
    "config": "Default",
    "createdUtc": "2026-06-10T16:02:11Z",
    "finishedUtc": "2026-06-10T16:02:54Z"
  },
  {
    "runId": 213,
    "status": "failed",
    "featureId": 15,
    "featureName": "Checkout",
    "config": "Mobile",
    "createdUtc": "2026-06-10T15:40:03Z",
    "finishedUtc": "2026-06-10T15:40:41Z"
  }
]

It's a lightweight listing — fetch the full digest for one run with get_run.

Errors

HTTP	When
404 not_found	No such project in this workspace.