Skip to main content
GET
/
runs
/
{run_id}
Get run
curl --request GET \
  --url https://api.coval.dev/v1/runs/{run_id} \
  --header 'X-API-Key: <api-key>'
{
  "run": {
    "name": "runs/5BhqoFdXSuk6IcugFvkXeU",
    "run_id": "5BhqoFdXSuk6IcugFvkXeU",
    "status": "COMPLETED",
    "create_time": "2025-10-14T12:00:00Z",
    "update_time": "2025-10-14T12:15:00Z",
    "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
    "persona_id": "hL4kL0nQr3ySt6vX9zAcDd",
    "test_set_id": "aB1cD2eF",
    "tags": [
      "regression",
      "v2.1"
    ],
    "progress": {
      "total_test_cases": 10,
      "completed_test_cases": 10,
      "failed_test_cases": 0,
      "in_progress_test_cases": 0
    },
    "results": {
      "output_ids": [
        "sim_output_1",
        "sim_output_2"
      ],
      "metrics": {
        "availability": {
          "mean": 0.95,
          "min": 0.85,
          "max": 1
        }
      }
    },
    "metadata": {
      "campaign_id": "q4_2025"
    }
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

run_id
string
required

Unique identifier for the run

Required string length: 22

Response

Run details

run
object
required