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