Get Call Execution Details — API

Retrieve details of a specific call execution by UUID, including provider call ID, metrics, and full execution data.

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.
simulator_agent_name string or null
Simulator agent name.
simulator_agent_id 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.
provider string or null
Telephony or chat provider used for this call, e.g. vapi, retell.
phone_number string or null
Phone number dialed for this call. Voice only.
simulation_call_type string or null
Simulation mode: voice or text.
processing_skipped boolean or null
Whether post-call processing was skipped.
processing_skip_reason string or null
Reason processing was skipped, if applicable.
is_snapshot boolean
Whether this record is a rerun snapshot rather than the live call.
snapshot_timestamp datetime or null
Timestamp when the snapshot was taken.
rerun_type string or null
Type of the most recent rerun: eval_only or call_and_eval. null if never rerun.
original_call_execution_id string or null
UUID of the original call execution this is a snapshot of.
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.
agent_talk_percentage number or null
Percentage of conversation time the agent was talking (0-100). Voice only.
csat_score number or null
Customer satisfaction score. Text only.
customer_cost_cents integer or null
Cost of the call in cents as reported by the customer’s telephony provider.
customer_cost_breakdown object or null
Detailed cost breakdown from the customer’s provider.
customer_latency_metrics object or null
Latency metrics as reported by the customer’s provider.
customer_call_id string or null
Call ID assigned by the customer’s telephony provider.
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