List Call Executions

List the call executions of a test run, most recently updated first, with search, status filter, and pagination. Each call includes its transcript, scenario, scores, and call summary

GET https://api.futureagi.com/simulate/run-tests/{run_test_id}/call-executions/

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

run_test_id UUID Required

UUID of the test run whose calls to list.

Query parameters

search string Optional

Case-insensitive match on the call’s phone number or scenario name.

status string Optional

Return only calls with this status: pending, queued, ongoing, analyzing, completed, failed, or cancelled.

limit integer Optional

Calls per page, a positive integer. Defaults to 10.

page integer Optional

Page number, starting at 1. Defaults to 1.

Response

200 OK
count integer

Total calls that match, across all pages.

next string or null

URL of the next page, or null on the last page.

previous string or null

URL of the previous page, or null on the first page.

total_pages integer

Number of pages at the current limit.

current_page integer

The page returned.

results array of objects

Calls on this page, most recently updated first. When a call is rerun with its evaluations (call_and_eval), the earlier attempt stays in the list as a snapshot.

id string

UUID of the call execution, or of the snapshot.

test_execution_id string

UUID of the test execution the call belongs to. Not present on snapshots.

status string

Call status, one of the values accepted by the status filter.

call_type string

Inbound or Outbound.

duration number or null

Call duration in seconds, or null if unknown.

start_time string or null

When the call started, or null if it has not started. Not present on snapshots.

transcript array of objects

The conversation, in order. Empty if no transcript is available.

scenario string or null

Name of the scenario the call ran.

scenario_id string or null

UUID of that scenario.

overall_score number or null

Overall evaluation score, or null if not computed yet.

eval_outputs object

Output of each evaluation that ran on the call. On snapshots, this is the result as stored when the snapshot was taken.

eval_metrics object

Evaluation metric values by metric. Always empty on snapshots.

customer_name string or null

The customer’s phone number for the call.

call_summary string or null

Generated summary of the call.

ended_reason string or null

Why the call ended.

avg_agent_latency integer or null

Average agent response latency in milliseconds.

is_snapshot boolean

true for an earlier attempt kept by a rerun. Snapshots also carry snapshot_timestamp.

rerun_type string or null

call_and_eval on snapshots, null on current calls.

original_call_execution_id string or null

For a snapshot, the UUID of the call it was taken from.

Each call also carries recording URLs, conversation metrics (interruptions, words per minute, talk ratio), chat metrics (tokens, turns), and cost fields when they apply to the call.

Errors

401 Unauthorized Optional

Missing or invalid X-Api-Key or X-Secret-Key headers.

404 Not Found Optional

No test run with this run_test_id in your organization.

500 Internal Server Error Optional

limit or page is not a positive integer, or an unexpected server error occurred.

GET /
Authentication
REQUEST
 
RESPONSE