Get test executions

Lists test executions for a test run.

GET https://api.futureagi.com/simulate/run-tests/{run_test_id}/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 executions to retrieve.

Query parameters

search string Optional

Case-insensitive partial match on execution status or scenario name.

status string Optional

Filter by execution status. Accepted values: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED.

limit integer Optional

Number of records per page. Defaults to 10. Must be a positive integer.

page integer Optional

Page number to retrieve. Defaults to 1.

Response

200 OK
count integer

Total matching executions across all pages.

next string or null

URL to the next page, or null if on the last page.

previous string or null

URL to the previous page, or null if on the first page.

results array of objects

Array of test execution objects for the current page.

id string

UUID of the test execution.

run_test string

UUID of the parent test run.

status string

One of PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED.

started_at string or null

ISO 8601 timestamp when execution began, or null if not yet started.

completed_at string or null

ISO 8601 timestamp when execution finished, or null if still running.

total_scenarios integer

Number of scenarios in this execution.

total_calls integer

Total simulation calls scheduled across all scenarios.

completed_calls integer

Number of successfully completed calls.

failed_calls integer

Number of failed calls.

duration_seconds number or null

Elapsed time in seconds, or null if not yet completed.

success_rate number or null

Percentage of successful calls, or null if no calls processed.

scenario_ids array of string

Scenario UUIDs included in this execution.

simulator_agent_name string or null

Name of the simulator agent used, or null if default.

agent_definition_used_name string or null

Name of the tested agent definition, or null if deleted.

created_at string

ISO 8601 creation timestamp.

Errors

401 Unauthorized Optional

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

404 Not Found Optional

No test run found with the specified run_test_id.

500 Internal Server Error Optional

Unexpected server error. Contact support if it persists.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE