---
title: "Get Field Performance"
method: GET
path: "/v1/analytics/namespaces/fields/performance"
tags: ["Analytics", "Analytics - Namespaces"]
---

# Get Field Performance

`GET /v1/analytics/namespaces/fields/performance`

Analyze field performance correlation.

Shows which metadata fields correlate with slow queries, helping identify
fields that would benefit most from indexing.

**Use Cases:**
- Identify fields causing performance issues
- Quantify indexing impact potential
- Prioritize index creation
- Monitor field usage patterns

**Response Includes:**
- Field usage count
- Latency statistics (avg, P50, P95, P99, max)
- Index priority score (usage × latency)
- Sorted by priority score

**Index Priority Score:**
Higher scores indicate fields where indexing would have greatest impact.
Score = (query count) × (average latency)

**Example:**
```bash
curl -X GET "https://api.mixpeek.com/v1/analytics/namespaces/fields/performance?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Namespace: your-namespace"
```

## Query parameters

- `days` integer — Days of history to analyze
- `limit` integer — Maximum fields to return

## Response `200`

Successful Response

- FieldPerformanceResponse — Response for field performance correlation endpoint.
  - `namespace_id` string, required — Namespace ID analyzed
  - `time_range_days` integer, required — Number of days analyzed
  - `fields` FieldPerformanceMetrics[], required — Field performance metrics
    - `field_name` string, required — Metadata field name
    - `usage_count` integer, required — Number of times field was queried
    - `avg_latency_ms` number, required — Average latency when field is used
    - `p50_latency_ms` number, required — 50th percentile 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
    - `index_priority_score` number, required — Priority score for indexing (usage_count * avg_latency)
  - `total_fields` integer, required — Total fields analyzed

## 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/220a3b263fda/schema)
