simulate

get/simulate/v3/call-executions/{call_execution_id}/

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/simulate/v3/call-executions/{call_execution_id}/
  • Auth: one of:
    • API key in header X-Api-Key
    • API key in header X-Secret-Key

Response

OK

idstring uuid
service_provider_call_idstring
session_idstring
timestampstring date-time
call_typestring
status'pending' | 'queued' | 'ongoing' | 'completed' | 'failed' | 'analyzing' | 'cancelled'

Current status of the call

durationstring
duration_secondsinteger nullable

Duration of the call in seconds

start_timestring
transcriptstring
scenariostring
overall_scorestring
response_timestring
response_time_msinteger nullable

Average response time in milliseconds

audio_urlstring uri
customer_namestring
eval_outputsstring
eval_metricsobject

Get evaluation metrics in a format suitable for the UI

scenario_columnsstring
ended_reasonstring nullable

Reason why the call ended

simulator_agent_namestring
simulator_agent_idstring uuid
agent_definition_used_namestring
agent_definition_used_idstring uuid
call_summarystring nullable

Call summary from the service

recordingsstring
test_execution_idstring uuid
scenario_idstring
source_scenario_keystring
trial_indexstring
harness_outcome_statusstring
scenario_graphstring
scenario_graph_idstring
avg_agent_latencyinteger
avg_agent_latency_msinteger nullable

Average agent latency in milliseconds (time taken by agent to respond after user's pause)

user_interruption_countinteger nullable

Number of times user interrupted the AI

user_interruption_ratenumber nullable

Rate of user interruptions (interruptions per minute)

user_wpmnumber nullable

User's words per minute

bot_wpmnumber nullable

Bot's words per minute

talk_rationumber nullable

Ratio of bot speaking time to user speaking time

ai_interruption_countinteger nullable

Number of times AI interrupted the user

ai_interruption_ratenumber nullable

Rate of AI interruptions (interruptions per minute)

avg_stop_time_after_interruptioninteger
total_tokensstring
input_tokensstring
output_tokensstring
avg_latency_msstring
turn_countstring
agent_talk_percentagestring
csat_scorestring
processing_skippedstring
processing_skip_reasonstring
rerun_snapshotsstring
is_snapshotstring
snapshot_timestampstring
rerun_typestring
original_call_execution_idstring
tool_outputsobject nullable

Tool evaluation output - separate from standard evaluations

cost_centsinteger nullable

Cost of the call in cents

customer_cost_centsinteger nullable

Total customer-reported cost in cents

customer_cost_breakdownobject nullable

Detailed cost breakdown from customer call data

customer_latency_metricsobject nullable

Latency metrics from customer call data

customer_call_idstring nullable

Customer call ID if available

simulation_call_type'voice' | 'text'

Type of simulation call

providerstring
phone_numberstring nullable

Phone number called (null for TEXT/chat simulations)

goalstring required
scenario_detailsstring nullable required
ideal_outcomestring nullable required
conversation_branchstring nullable required
personastring nullable required
sub_goalsstring[] required
outcome'queued' | 'in_progress' | 'passed' | 'failed' | 'inconclusive' | 'error' required
scoring_status'not_applicable' | 'pending' | 'succeeded' | 'failed' | 'timed_out' required
csat_status'not_applicable' | 'pending' | 'succeeded' | 'failed' | 'timed_out' | 'skipped' required
csat_reasonstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.