Get Test Execution KPIs

Retrieve KPI metrics for a test execution. Returns avg score, response time, call connection rate, latency, WPM, interruption rates, and per-eval averages.

GET https://api.futureagi.com/simulate/test-executions/{test_execution_id}/kpis/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Path parameters

test_execution_id UUID Required

The test execution ID. Response fields vary by agent type (voice vs. text).

Response

200 OK
total_calls integer
Total call executions.
avg_score number
Average evaluation score across completed calls.
avg_response number
Average response time in seconds.
calls_attempted integer
Total calls initiated.
connected_calls integer
Calls that connected.
calls_connected_percentage number
Percentage of calls that connected.
failed_calls integer
Calls that failed.
total_duration integer
Combined duration in seconds.
agent_type string
voice or text.
is_inbound boolean or null
true for inbound, false for outbound. null for text agents.
scenario_graphs object
Per-scenario performance data.
avg_agent_latency number
Average agent latency in seconds. Voice only.
avg_user_interruption_count number
Average user interruptions per call. Voice only.
avg_user_interruption_rate number
Average user interruption rate (0-1). Voice only.
avg_user_wpm number
Average user words per minute. Voice only.
avg_bot_wpm number
Average agent words per minute. Voice only.
avg_talk_ratio number
Average agent talk ratio (0-1). Voice only.
avg_ai_interruption_count number
Average agent interruptions per call. Voice only.
avg_ai_interruption_rate number
Average agent interruption rate (0-1). Voice only.
avg_stop_time_after_interruption number
Average seconds to stop after interruption. Voice only.
agent_talk_percentage number
Agent talk time percentage (0-100). Voice only.
customer_talk_percentage number
Customer talk time percentage (0-100). Voice only.
avg_total_tokens number
Average total tokens per call. Text only.
avg_input_tokens number
Average input tokens per call. Text only.
avg_output_tokens number
Average output tokens per call. Text only.
avg_chat_latency_ms number
Average latency in milliseconds. Text only.
avg_turn_count number
Average turns per call. Text only.
avg_csat_score number
Average CSAT score. Text only.
avg_[metric_name] number
Dynamic average for each configured eval metric.

Errors

401 Unauthorized Optional
Invalid or missing credentials.
404 Not Found Optional
Test execution not found.
500 Internal Server Error Optional
Unexpected server error.
GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE