Get Test Execution Details

Retrieve a test execution by UUID with paginated call executions. Supports search, filters, and row grouping. Returns status, call counts, eval scores, and transcripts.

GET https://api.futureagi.com/simulate/test-executions/{test_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

test_execution_id UUID Required

The test execution ID.

Query parameters

search string Optional

Filter call executions by phone number or scenario name.

page integer Optional

Page number. Defaults to 1.

limit integer Optional

Number of call executions per page. Defaults to 30.

filters string Optional

JSON-encoded array of filter objects. Each object must contain a column_id and a filter_config object.

Structure:

[
  {
    "column_id": "<column>",
    "filter_config": {
      "filter_type": "<type>",
      "filter_op": "<operator>",
      "filter_value": "<value>"
    }
  }
]

column_id values: status, timestamp, call_execution_id, overall_score, response_time, call_type, scenario, or an eval config UUID.

filter_type values: text, number, datetime, boolean, list.

filter_op values: equals, not_equals, contains, not_contains, greater_than, less_than, greater_than_or_equal, less_than_or_equal, between, not_in_between, in.

filter_value: A string, number, ISO 8601 datetime string, or array (for between / in operators).

Example — filter by status:

[{"column_id":"status","filter_config":{"filter_type":"text","filter_op":"equals","filter_value":"completed"}}]

Example — filter by score range:

[{"column_id":"overall_score","filter_config":{"filter_type":"number","filter_op":"between","filter_value":[50,90]}}]
row_groups string Optional

JSON-encoded array of column IDs to group by, e.g. ["scenario"].

group_keys string Optional

JSON-encoded group key values to drill into. Used with row_groups.

Response

200 OK
count integer
Total number of call executions.
next string or null
URL for the next page, or null if on the last page.
previous string or null
URL for the previous page, or null if on the first page.
total_pages integer
Total number of pages.
current_page integer
Current page number.
results array
Paginated list of call execution objects.
id string
UUID of the call execution.
status string
Call status: pending, queued, ongoing, completed, failed, analyzing, or cancelled.
duration number
Duration in seconds.
transcript array
Conversation transcript.
overall_score number
Aggregate eval score.
eval_outputs object
Eval results per configured eval.
scenario string
Scenario name.
created_at datetime
ISO 8601 creation timestamp.
column_order array
Column configuration for the test execution grid.
id string
UUID of the column.
column_name string
Display name of the column.
visible boolean
Whether the column is visible.
data_type string
Data type of the column.
type string
scenario_dataset_column, evaluation, or tool_evaluation.
scenario_id string or null
UUID of the associated scenario, if applicable.
dataset_id string
UUID of the associated dataset.
eval_config object or null
Eval configuration details, if applicable.
status string
Test execution status: pending, running, completed, failed, cancelled, cancelling, or evaluating.
error_messages array
List of error message strings, if any.
provider string
Agent provider name (e.g. vapi, prompt).
agent_type string
voice or text.

Errors

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