---
title: "GET /simulate/api/test-executions/"
method: GET
path: "/simulate/api/test-executions/"
tags: ["simulate"]
---

# GET /simulate/api/test-executions/

`GET /simulate/api/test-executions/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/test-executions/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Get paginated list of test executions for the user's organization
Query Parameters:
- search: search string to filter test executions by run test name
- status: filter by execution status
- limit: number of items per page (default: 10)
- page: page number (default: 1)

## Query parameters

- `search` string
- `status` string
- `page` integer
- `limit` integer

## Response `200`

OK

- TestExecution[]
  - `id` string, uuid
  - `run_test` string, uuid, required: The run test being executed
  - `run_test_name` string
  - `agent_definition_name` string
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'cancelling' | 'evaluating': Current status of the test execution
  - `error_reason` string, nullable
  - `started_at` string, date-time: When the test execution started
  - `completed_at` string, date-time, nullable: When the test execution completed
  - `total_scenarios` integer: Total number of scenarios in this execution
  - `total_calls` integer: Total number of calls to be made
  - `completed_calls` integer: Number of successfully completed calls
  - `failed_calls` integer: Number of failed calls
  - `execution_metadata` object: Additional metadata about the execution
  - `duration_seconds` string
  - `success_rate` string
  - `calls` CallExecution[]
    - `id` string, uuid
    - `phone_number` string, nullable: Phone number called (null for TEXT/chat simulations)
    - `service_provider_call_id` string
    - `status` 'pending' | 'queued' | 'ongoing' | 'completed' | 'failed' | 'analyzing' | 'cancelled': Current status of the call
    - `started_at` string, date-time, nullable: When the call started
    - `completed_at` string, date-time, nullable: When the call completed
    - `duration_seconds` integer, nullable: Duration of the call in seconds
    - `recording_url` string, uri, nullable: URL to the call recording
    - `cost_cents` integer, nullable: Cost of the call in cents
    - `call_metadata` object: Additional metadata about the call
    - `error_message` string, nullable: Error message if the call failed
    - `scenario_name` string
    - `transcripts` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `provider_call_data` object, nullable: Complete call data from the provider. Format: dict[provider_name, data] where provider_name must be from SupportedProviders
    - `stereo_recording_url` string, uri, nullable: Stereo recording URL from Vapi
    - `ended_reason` string, nullable: Reason why the call ended
    - `stt_cost_cents` integer, nullable: STT cost in cents
    - `llm_cost_cents` integer, nullable: LLM cost in cents
    - `tts_cost_cents` integer, nullable: TTS cost in cents
    - `overall_score` number, nullable: Overall call performance score
    - `response_time_ms` integer, nullable: Average response time in milliseconds
    - `response_time_seconds` string
    - `assistant_id` string, nullable: Assistant ID used for the call (system side)
    - `customer_number` string, nullable: Customer phone number (E.164 format)
    - `call_type` string, nullable: Type of call (e.g., outboundPhoneCall)
    - `ended_at` string, date-time, nullable: When the call ended
    - `analysis_data` object, nullable: Call analysis data from the service provider
    - `evaluation_data` object, nullable: Call evaluation data from the service provider
    - `message_count` integer, nullable: Number of messages in the call
    - `transcript_available` boolean: Whether transcript is available
    - `recording_available` boolean: Whether recording is available
    - `eval_outputs` object, nullable: Evaluation output
    - `error_localizer_tasks` CallExecutionErrorLocalizerTask[]: Get error localizer tasks for this call execution.
      - `task_id` string, required
      - `eval_config_id` string, nullable, required
      - `status` string, required
      - `eval_result` object, nullable, required
      - `eval_explanation` string, nullable
      - `input_data` object, nullable
      - `input_keys` string[]
      - `input_types` object, nullable
      - `rule_prompt` string, nullable
      - `error_analysis` object, nullable
      - `selected_input_key` string, nullable
      - `error_message` string, nullable
      - `created_at` string, nullable
      - `updated_at` string, nullable
    - `call_summary` string, nullable: Call summary from the service
    - `agent_version` string, uuid, nullable
    - `customer_cost_cents` integer, nullable: Total customer-reported cost in cents
    - `system_metrics` string
    - `cost_breakdown` string
    - `customer_call_id` string, nullable: Customer call ID if available
    - `simulation_call_type` 'voice' | 'text': Type of simulation call
    - `processing_skipped` string
    - `processing_skip_reason` string
  - `created_at` string, date-time
  - `scenario_ids` object: List of scenario IDs that were executed in this run
  - `simulator_agent_name` string
  - `simulator_agent_id` string, uuid
  - `agent_definition_used_name` string
  - `agent_definition_used_id` string, uuid
  - `calls_attempted` string
  - `calls_connected_percentage` string

## Other responses

- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)