---
title: "Get event metrics"
method: POST
path: "/v1/events/metrics"
tags: ["events"]
---

# Get event metrics

`POST /v1/events/metrics`

Aggregate what the events carry beyond their count, per time bucket.

Ingestion volume (files, chunks, tokens, bytes, timings), searches by kind
(semantic, reranked, rewritten, agentic, grep) with latency percentiles and
agentic token usage, and chat completions with their prompt, cached, and
completion tokens, hosted tool calls, and turn durations. Buckets with no
events are omitted.

## Query parameters

- `store_identifier` union — Restrict to one store by ID or name; omit to span every store
  - string
  - string, uuid

## Request body

- EventHistogramParams — Time window and bucket size of an event histogram.
  - `start_time` string, date-time — Start time of the histogram
  - `end_time` string, date-time — End time of the histogram
  - `bucket_seconds` integer — Number of seconds in each bucket

## Response `200`

Usage aggregates of the organization's events per time bucket

- EventMetricsResponse
  - `object` 'event_metrics' — The object type of the response
  - `data` EventMetricsBucket[], required — Usage aggregates per time bucket, oldest first
    - `bucket_start` string, date-time, required — Start time of the bucket
    - `bucket_end` string, date-time, required — End time of the bucket
    - `ingestion` EventMetricsIngestion, required — Ingestion volume and timings within one bucket.
      - `files` integer — Files whose ingestion completed
      - `high_quality_files` integer — Files ingested with the high-quality strategy
      - `chunks` integer — Chunks produced
      - `tokens` integer — Tokens embedded during ingestion
      - `bytes` integer — Bytes of source files ingested
      - `avg_ingestion_time` string, duration, nullable — Mean processing time, excluding queueing
      - `avg_queue_time` string, duration, nullable — Mean time files waited before processing
    - `search` EventMetricsSearch, required — Search activity within one bucket, split by kind.
      - `semantic` integer — Plain semantic searches, including the reranked ones
      - `reranked` integer — Semantic searches that applied a reranker
      - `rewritten` integer — Semantic searches that enabled query rewriting
      - `agentic` integer — Agentic searches
      - `grep` integer — Grep searches
      - `avg_search_time` string, duration, nullable — Mean latency of semantic searches
      - `p95_search_time` string, duration, nullable — 95th-percentile latency of semantic searches
      - `avg_agentic_search_time` string, duration, nullable — Mean wall-clock time of agentic searches
      - `agentic_prompt_tokens` integer — Prompt tokens consumed by agentic searches
      - `agentic_completion_tokens` integer — Completion tokens generated by agentic searches
      - `avg_agentic_rounds` number, nullable — Mean rounds an agentic search executed
    - `completion` EventMetricsCompletion, required — Chat completion activity within one bucket.
      - `count` integer — Completion turns across both APIs
      - `responses` integer — Turns created through the Responses API
      - `prompt_tokens` integer — Prompt tokens consumed, including cached ones
      - `cached_tokens` integer — Prompt tokens served from the prompt cache
      - `completion_tokens` integer — Completion tokens generated
      - `tool_calls` integer — Hosted store tool calls executed server-side
      - `function_tool_calls` integer — Client-executed function tool calls the model requested
      - `avg_total_time` string, duration, nullable — Mean wall-clock time of a turn

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/6dac6bb49f72/schema)