---
title: "Get store event histogram"
method: POST
path: "/v1/stores/{store_identifier}/events/histogram"
tags: ["stores"]
---

# Get store event histogram

`POST /v1/stores/{store_identifier}/events/histogram`

Get histogram of store events over time.

Args:
    store_identifier: The ID or name of the store.
    histogram_params: Parameters for histogram generation.

Returns:
    StoreEventHistogramResponse: The event histogram.

## Path parameters

- `store_identifier` union, required — The ID or name of the store
  - string
  - string, uuid

## Request body

- StoreEventHistogramParams — Parameters for getting a histogram of events in a store.
  - `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
  - `event_types` string[], nullable — Restrict the histogram to these event types. When omitted, includes search, agentic_search, grep, completion, and ingestion events.

## Response `200`

Histogram of store events over time

- StoreEventHistogramResponse
  - `object` 'store.histogram' — The object type of the response
  - `data` StoreEventHistogramBucket[], required — The histogram of store events
    - `bucket_start` string, date-time, required — Start time of the bucket
    - `bucket_end` string, date-time, required — End time of the bucket
    - `type` 'inference.embeddings' | 'inference.reranking' | 'model_request' | 'internal_error' | 'store.created' | 'store.deleted' | 'store.updated' | 'store.search' | 'store.search_agent' | 'store.grep' | 'store.web_search' | 'store.file.created' | 'store.file.deleted' | 'store.file.updated' | 'store.file.search' | 'store.question_answer' | 'completion.completed' | 'store.file.completed' | 'store.file.cancelled' | 'store.reingestion.completed' | 'parsing.job.created' | 'parsing.job.deleted' | 'parsing.job.cancelled' | 'parsing.job.completed' | 'extraction.job.created' | 'extraction.job.deleted' | 'extraction.job.cancelled' | 'extraction.job.completed' | 'file.uploaded' | 'file.deleted' | 'file.updated' | 'file.downloaded' | 'api_key.created' | 'api_key.deleted' | 'api_key.updated' | 'api_key.revoked' | 'api_key.rerolled' | 'data_source.created' | 'data_source.updated' | 'data_source.deleted' | 'data_source.oauth2.requested' | 'data_source.oauth2.authorized' | 'data_source.connector.job.completed' | 'auth.invalid_token' | 'auth.success' | 'auth.error', required — Internal type of the event
    - `event_type` 'ingestion' | 'search' | 'agentic_search' | 'grep' | 'completion', required — Event type as exposed by the events listing, e.g. `search` or `completion`
    - `event_count` integer, required — Number of events in the bucket

## 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)