---
title: "GET /simulation/metrics/"
method: GET
path: "/sdk/api/v1/simulation/metrics/"
tags: ["sdk"]
---

# GET /simulation/metrics/

`GET /sdk/api/v1/simulation/metrics/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/sdk/api/v1/simulation/metrics/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Aggregated system metrics: latency (by subsystem), cost, conversation metrics.

## Query parameters

- `run_test_name` string
- `execution_id` string, uuid
- `call_execution_id` string, uuid

## Response `200`

OK

- SDKSimulationMetricsResponse
  - `status` boolean, required
  - `result` SDKSimulationMetricsResult, required
    - `call_execution_id` string, uuid
    - `execution_id` string, uuid
    - `status` string
    - `duration_seconds` number, nullable
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `total_calls` integer
    - `completed_calls` integer
    - `failed_calls` integer
    - `latency` object
    - `cost` object
    - `conversation` object
    - `chat_metrics` object, nullable
    - `metrics` object
    - `total_pages` integer
    - `current_page` integer
    - `count` integer
    - `results` ExecutionMetrics[]
      - `execution_id` string, uuid, required
      - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'cancelling' | 'evaluating': Current status of the test execution
      - `started_at` string, date-time: When the test execution started
      - `completed_at` string, date-time, nullable: When the test execution completed
      - `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
      - `metrics` string

## Other responses

- `400`: Bad Request
- `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)