Get Stage Breakdown

curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/retrievers/{retriever_id}/stages \
  --header 'Authorization: <authorization>' \
  --header 'X-Namespace: <x-namespace>'

{
  "retriever_id": "<string>",
  "stages": [
    {
      "stage_name": "<string>",
      "stage_type": "<string>",
      "execution_count": 123,
      "avg_latency_ms": 123,
      "p95_latency_ms": 123,
      "avg_documents_in": 123,
      "avg_documents_out": 123
    }
  ],
  "total_latency_ms": 123
}

Retriever

Get Stage Breakdown

Get stage-level performance breakdown.

Analyzes individual stage performance to identify bottlenecks:

Stage execution times
Document flow (in/out)
Stage-level latency distribution

Use Cases:

Identify slow stages in retrieval pipeline
Optimize stage ordering
Debug pipeline bottlenecks
Understand document reduction rates

Example:

curl -X GET "https://api.mixpeek.com/v1/analytics/retrievers/ret_abc123/stages?hours=24" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Namespace: your-namespace"

GET

analytics

retrievers

{retriever_id}

stages

Get Stage Breakdown

curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/retrievers/{retriever_id}/stages \
  --header 'Authorization: <authorization>' \
  --header 'X-Namespace: <x-namespace>'

{
  "retriever_id": "<string>",
  "stages": [
    {
      "stage_name": "<string>",
      "stage_type": "<string>",
      "execution_count": 123,
      "avg_latency_ms": 123,
      "p95_latency_ms": 123,
      "avg_documents_in": 123,
      "avg_documents_out": 123
    }
  ],
  "total_latency_ms": 123
}

Headers

Authorization

string

required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

X-Namespace

string

required

REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'

Path Parameters

retriever_id

string

required

Query Parameters

hours

integer

default:24

Hours of history

Required range: 1 <= x <= 720

Response

Successful Response

Stage breakdown response.

retriever_id

string

required

Retriever identifier

stages

StagePerformanceMetrics · object[]

required

Stage metrics

Show child attributes

stages.stage_name

string

required

Name of the stage

stages.stage_type

string

required

Type of the stage

stages.execution_count

integer

required

Number of executions

stages.avg_latency_ms

number

required

Average latency

stages.p95_latency_ms

number

required

P95 latency

stages.avg_documents_in

number

required

Average documents input

stages.avg_documents_out

number

required

Average documents output

total_latency_ms

number

required

Total pipeline latency

Get Retriever Performance Get Retriever Signals

⌘I

Health

Organizations

Namespaces

Buckets

Feature Extractors

Collections

Retrievers

Taxonomies

Clusters

Templates

Analytics

Resource Search

Inference

Agent Sessions

Tasks

Webhooks

Notifications

Triggers

Get Stage Breakdown

Headers

Path Parameters

Query Parameters

Response