---
title: "Get Engine Performance"
method: GET
path: "/v1/analytics/performance/engine"
tags: ["Analytics", "Analytics - Performance"]
---

# Get Engine Performance

`GET /v1/analytics/performance/engine`

Get engine performance metrics over time.

Query profiling data logged by the engine's profiling infrastructure.
All queries are automatically filtered to your namespace.

**Time Range:**
- Specify `hours` for recent history (e.g., `hours=24` for last 24 hours)
- OR specify `start_date` and `end_date` for custom range
- Defaults to last 24 hours if neither provided

**Grouping:**
- `minute`: High-resolution (for short time ranges)
- `hour`: Standard resolution (default)
- `day`: For longer time ranges
- `week`, `month`: For historical trends

**Response:**
- Time-series metrics (avg, p50, p95, p99 latencies)
- Summary statistics across the entire time range
- All latencies in milliseconds

**Example:**
```bash
GET /v1/analytics/performance/engine?hours=24&group_by=hour
```

## Query parameters

- `hours` integer, nullable — Hours of history (alternative to date range)
- `start_date` string, date-time, nullable — Start date for time range
- `end_date` string, date-time, nullable — End date for time range
- `group_by` string — Time grouping (minute, hour, day, week)

## Response `200`

Successful Response

- EnginePerformanceResponse — Response for engine performance query.
  - `time_range` ApiAnalyticsModelsTimeRange, required — Time range for analytics queries.
    - `start` string, date-time, required — Start time (UTC)
    - `end` string, date-time, required — End time (UTC)
  - `metrics` PerformanceMetric[], required — Time-series performance metrics
    - `time_bucket` string, date-time, required — Time bucket for this metric (hour, day, etc.)
    - `execution_count` integer, required — Number of executions in this period
    - `avg_latency_ms` number, required — Average latency in milliseconds
    - `p50_latency_ms` number, required — 50th percentile (median) latency
    - `p95_latency_ms` number, required — 95th percentile latency
    - `p99_latency_ms` number, required — 99th percentile latency
    - `max_latency_ms` number, required — Maximum latency observed
  - `summary` PerformanceSummary — Summary statistics for performance.
    - `total_executions` integer — Total number of executions
    - `avg_latency_ms` number — Average latency
    - `p50_latency_ms` number — Median latency
    - `p95_latency_ms` number — 95th percentile latency
    - `p99_latency_ms` number — 99th percentile latency
    - `max_latency_ms` number — Maximum latency
    - `total_time_seconds` number — Total time spent across all executions

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/5d4c905106b4/schema)