Get call execution details

Retrieves a specific call execution.

GET https://api.futureagi.com/simulate/call-executions/{call_execution_id}/

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

call_execution_id UUID Required

The call execution ID.

Response

200 OK
id string
UUID of the call execution.
service_provider_call_id string or null
External call ID from the telephony provider.
session_id string or null
Session ID linking this call to a broader conversation.
status string
Call status. One of pending, queued, ongoing, completed, failed, analyzing, or cancelled.
duration number or null
Call duration in seconds.
start_time datetime or null
ISO 8601 timestamp when the call connected.
timestamp datetime
ISO 8601 timestamp when the record was created.
call_type string or null
Inbound or Outbound. null for text agents.
transcript array
Ordered conversation turns.
role string
Speaker: user, assistant, system, tool_calls, or tool_call_result.
content string
Text content of the utterance.
scenario string
Scenario name.
scenario_id string or null
UUID of the scenario.
scenario_columns array
Dataset column values used for this call.
overall_score number or null
Aggregated evaluation score (0-10).
response_time number or null
Average agent response time in seconds.
eval_outputs object or null
Evaluation results keyed by evaluation name.
eval_metrics object or null
Supplementary evaluation metric aggregations.
audio_url string or null
URL to the call audio recording.
recordings object or null
Provider-specific recording URLs and metadata.
customer_name string or null
Simulated customer persona name.
call_summary string or null
AI-generated conversation summary.
ended_reason string or null
Reason the call ended, e.g. customer_hangup, agent_hangup, timeout, error.
simulatorAgentName string or null
Simulator agent name.
simulatorAgentId string or null
UUID of the simulator agent.
agent_definition_used_name string or null
Agent definition name.
agent_definition_used_id string or null
UUID of the agent definition.
tool_outputs object or null
Tool call outputs from the conversation.
rerun_snapshots array
Snapshots from previous reruns.
avg_agent_latency number or null
Average agent response latency in seconds. Voice only.
user_interruption_count integer or null
User interruption count. Voice only.
user_interruption_rate number or null
Proportion of agent turns interrupted by user (0-1). Voice only.
user_wpm number or null
User speaking rate in words per minute. Voice only.
bot_wpm number or null
Agent speaking rate in words per minute. Voice only.
talk_ratio number or null
Agent talk time proportion (0-1). Voice only.
ai_interruption_count integer or null
Agent interruption count. Voice only.
ai_interruption_rate number or null
Proportion of user turns interrupted by agent (0-1). Voice only.
avg_stop_time_after_interruption number or null
Average seconds to stop speaking after interruption. Voice only.
total_tokens integer or null
Total tokens consumed. Text only.
input_tokens integer or null
Input tokens sent to the model. Text only.
output_tokens integer or null
Output tokens generated. Text only.
avg_latency_ms number or null
Average response latency in milliseconds. Text only.
turn_count integer or null
Total conversation turns. Text only.
csat_score number or null
Customer satisfaction score. Text only.
stt_cost number or null
Speech-to-text cost in USD. Voice only.
llm_cost number or null
LLM inference cost in USD.
tts_cost number or null
Text-to-speech cost in USD. Voice only.
storage_cost number or null
Storage cost in USD.
total_cost number or null
Total cost in USD.

Errors

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