Skip to main content
GET
/
v1
/
simulations
/
{simulation_id}
Get simulation
curl --request GET \
  --url https://api.coval.dev/v1/simulations/{simulation_id} \
  --header 'X-API-Key: <api-key>'
{
  "simulation": {
    "name": "simulations/abc123xyz789",
    "simulation_id": "abc123xyz789",
    "run_id": "abc123xyz789",
    "status": "COMPLETED",
    "create_time": "2025-10-14T12:00:00Z",
    "has_audio": true,
    "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
    "persona_id": "hL4kL0nQr3ySt6vX9zAcDd",
    "test_set_id": "aB1cD2eF",
    "test_case_id": "test_xyz123",
    "error_message": "Simulation failed to run.",
    "mutation_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "mutation_name": "GPT-4 Fast VAD",
    "transcript": [
      {
        "role": "assistant",
        "content": "Hello! How can I help you today?",
        "start_timestamp": "0.0",
        "end_timestamp": "2.5",
        "start_offset": 0,
        "end_offset": 2500
      }
    ]
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication.

Path Parameters

simulation_id
string
required

The simulation ID

Required string length: 22 - 27

Response

Simulation resource

simulation
object
required