---
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`

## Request

- Base URL: `https://api.mixedbread.com`
- URL: `https://api.mixedbread.com/v1/stores/{store_identifier}/events/histogram`
- Auth: HTTP bearer

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, ingestion, and qa 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.copied' | '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' | 'store.decision' | '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' | 'qa', 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

## Changes

- **2026-10-31** `9179fec93d29`: 1 warning
  - added the new `store.decision` enum value to the `data/items/type` response property for the response status `200`
- **2026-09-15** `957bf8ec8df8`: 1 warning
  - added the new `store.copied` enum value to the `data/items/type` response property for the response status `200`
- **2026-08-27** `d2ebbe3adcaa`: 1 warning, 1 info
  - added the new `qa` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `qa` enum value to the request property `event_types/anyOf[subschema #1]/items/`
- **2026-08-22** `6dac6bb49f72`: 2 info
  - added the new `completion` enum value to the request property `event_types/anyOf[subschema #1]/items/`
  - added the required property `data/items/event_type` to the response with the `200` status
- **2026-08-13** `d47e1d852549`: 1 warning, 1 info
  - added the new `completion.completed` enum value to the `data/items/type` response property for the response status `200`
  - removed the `response.completed` enum value from the `data/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/stores/:store_identifier/events/histogram/post.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) - [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) - [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/da24b4f7e983?raw)