--- title: "List events for a store" method: GET path: "/v1/stores/{store_identifier}/events" tags: ["stores"] --- # List events for a store `GET /v1/stores/{store_identifier}/events` List events for a store. Args: store_identifier: The ID or name of the store. options: The pagination options. Returns: StoreEventListResponse: The list of events for the store. ## Path parameters - `store_identifier` union, required — The ID or name of the store - string - string, uuid ## Query parameters - `limit` integer — Maximum number of items to return per page (1-100) - `after` string, nullable — Cursor for forward pagination - get items after this position. Use last_cursor from previous response. - `before` string, nullable — Cursor for backward pagination - get items before this position. Use first_cursor from previous response. - `include_total` boolean — Whether to include total count in response (expensive operation) - `filter_before` string, date-time, nullable — Time to filter events before - `filter_after` string, date-time, nullable — Time to filter events after - `event_type` 'ingestion' | 'search' | 'agentic_search' | 'grep', required — The type of event to list ## Response `200` The list of events for the store - StoreEventListResponse - `pagination` CursorPaginationResponse, required — Response model for cursor-based pagination. - `has_more` boolean, required — Contextual direction-aware flag: True if more items exist in the requested pagination direction. For 'after': more items after this page. For 'before': more items before this page. - `first_cursor` string, nullable, required — Cursor of the first item in this page. Use for backward pagination. None if page is empty. - `last_cursor` string, nullable, required — Cursor of the last item in this page. Use for forward pagination. None if page is empty. - `total` integer, nullable — Total number of items available across all pages. Only included when include_total=true was requested. Expensive operation - use sparingly. - `object` 'list' — The object type of the response - `data` union[], required — The list of store events - union - StoreIngestionEvent — Represents an ingestion event in a vector store. - `id` string, uuid, required — Unique identifier for the event - `created_at` string, date-time, required — Timestamp when the event was created - `type` 'ingestion' - `store_id` string, uuid, required — ID of the vector store - `store_file_id` string, required — ID of the vector store file - `total_time` string, duration, required — Total time taken to ingest the file, including queue time - `queue_time` string, duration, required — Time spent in the queue - `ingestion_time` string, duration, required — Time taken to ingest the file, excluding queue time - `chunk_count` integer, required — Number of chunks ingested - `contextualization` boolean, required — Whether contextualization was used - `mode` 'fast' | 'high_quality', required — Strategy for adding a file to a store. - `filename` string, nullable — Name of the file if the event is tied to a file - StoreSearchEvent — Represents a search event in a vector store. - `id` string, uuid, required — Unique identifier for the event - `created_at` string, date-time, required — Timestamp when the event was created - `type` 'search' - `store_ids` string[], required — IDs of the vector stores searched - `search_time` string, duration — Time taken to search the vector store - `query` string, nullable — Query used to search the vector store - `rewritten_query` string, nullable — Rewritten query if query rewriting was enabled - `rewritten_filters` union — Filters used after query rewriting - SearchFilterOutput — Represents a filter with AND, OR, and NOT conditions. - `all` union[], nullable — List of conditions or filters to be ANDed together - … - `any` union[], nullable — List of conditions or filters to be ORed together - … - `none` union[], nullable — List of conditions or filters to be NOTed - … - SearchFilterCondition — Represents a condition with a field, operator, and value. - `key` string, required — The field to apply the condition on - `value` string, required — The value to compare against - `operator` 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'like' | 'contains' | 'starts_with' | 'not_like' | 'regex', required — Operator for a filter condition. - union[] - union - … - `rewrite_rank_by` string, nullable — Metadata field used for ranking - `rewrite_rank_direction` 'asc' | 'desc', nullable — Ranking direction - `rewrite_rank_mode` 'post_search' | 'metadata', nullable — Ranking mode - `rerank` boolean — Whether to rerank the results - `filters` union — Metadata filters submitted with the search request - SearchFilterOutput — Represents a filter with AND, OR, and NOT conditions. - `all` union[], nullable — List of conditions or filters to be ANDed together - … - `any` union[], nullable — List of conditions or filters to be ORed together - … - `none` union[], nullable — List of conditions or filters to be NOTed - … - SearchFilterCondition — Represents a condition with a field, operator, and value. - `key` string, required — The field to apply the condition on - `value` string, required — The value to compare against - `operator` 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'like' | 'contains' | 'starts_with' | 'not_like' | 'regex', required — Operator for a filter condition. - union[] - union - … - `results` StoreSearchEventResult[] — Chunks returned by the search - `store_id` string, required — ID of the store the chunk belongs to - `file_id` string, nullable — ID of the file the chunk belongs to - `filename` string, nullable — Name of the file the chunk belongs to - `chunk_index` integer, required — Index of the chunk within its file - `score` number, required — Final score assigned to the chunk - `first_stage_position` integer, nullable — Position of the chunk in the first-stage ranking - `first_stage_source` 'dense' | 'sparse' | 'both', nullable — Which first-stage retriever surfaced the chunk - StoreAgenticSearchEvent — Represents an agentic search trace in a vector store. Unlike StoreSearchEvent, this captures the full sequence of tool calls the agent issued (name, arguments, result) so developers can inspect what the agent did, along with the token usage. - `id` string, uuid, required — Unique identifier for the event - `created_at` string, date-time, required — Timestamp when the event was created - `type` 'agentic_search' - `store_ids` string[], required — IDs of the vector stores searched - `started_at` string, date-time, required — Time when the agentic search began - `search_time` string, duration — Total wall-clock time of the agent loop - `query` string, nullable — Original query submitted by the user - `instructions` string, nullable — Custom instructions provided with the agentic search, if any - `ranking_strategy` string, nullable — Agent-submitted explanation of how chunks were ranked - `rounds_executed` integer — Number of search rounds the agent executed - `filters` union — Metadata filters submitted with the search request - SearchFilterOutput — Represents a filter with AND, OR, and NOT conditions. - `all` union[], nullable — List of conditions or filters to be ANDed together - … - `any` union[], nullable — List of conditions or filters to be ORed together - … - `none` union[], nullable — List of conditions or filters to be NOTed - … - SearchFilterCondition — Represents a condition with a field, operator, and value. - `key` string, required — The field to apply the condition on - `value` string, required — The value to compare against - `operator` 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'like' | 'contains' | 'starts_with' | 'not_like' | 'regex', required — Operator for a filter condition. - union[] - union - … - `token_usage` AgenticSearchTokenUsage — Token usage for LLM calls made during an agentic search. - `prompt_tokens` integer — Number of prompt tokens consumed - `completion_tokens` integer — Number of completion tokens generated - `total_tokens` integer — Total tokens consumed (prompt + completion) - `tool_calls` AgenticToolCall[] — Ordered tool calls issued by the agent - `tool_call_id` string, required — Unique identifier for the tool call (gen_ai.tool.call.id) - `tool_name` string, required — Name of the tool invoked (gen_ai.tool.name) - `tool_type` 'function' | 'extension' | 'datastore' — Category of the tool (gen_ai.tool.type) - `started_at` string, date-time, required — Time when the tool call began - `duration` string, duration, required — Time taken to execute the tool call - `arguments` object, nullable — Arguments passed to the tool (gen_ai.tool.call.arguments) - `result` object, nullable — Result returned to the model (gen_ai.tool.call.result). None if the tool errored. - `error` string, nullable — Error message if the tool call failed - `error_kind` 'provider' | 'agent', nullable — Failure classification when the tool call errored: `provider` is an infrastructure failure outside the agent's control, `agent` is feedback the agent received and can recover from. - `results` StoreSearchEventResult[] — Chunks returned by the agentic search - `store_id` string, required — ID of the store the chunk belongs to - `file_id` string, nullable — ID of the file the chunk belongs to - `filename` string, nullable — Name of the file the chunk belongs to - `chunk_index` integer, required — Index of the chunk within its file - `score` number, required — Final score assigned to the chunk - `first_stage_position` integer, nullable — Position of the chunk in the first-stage ranking - `first_stage_source` 'dense' | 'sparse' | 'both', nullable — Which first-stage retriever surfaced the chunk - StoreGrepEvent — Represents a grep event in a vector store. Grep matches chunks against a regular expression rather than running a semantic search, so it has no ranking, rewrite, or rerank fields. - `id` string, uuid, required — Unique identifier for the event - `created_at` string, date-time, required — Timestamp when the event was created - `type` 'grep' - `store_ids` string[], required — IDs of the vector stores grepped - `pattern` string, nullable — Regular expression matched against chunk text - `case_sensitive` boolean — Whether the pattern was matched case-sensitively - `search_time` string, duration — Time taken to grep the vector store - `filters` union — Metadata filters submitted with the grep request - SearchFilterOutput — Represents a filter with AND, OR, and NOT conditions. - `all` union[], nullable — List of conditions or filters to be ANDed together - … - `any` union[], nullable — List of conditions or filters to be ORed together - … - `none` union[], nullable — List of conditions or filters to be NOTed - … - SearchFilterCondition — Represents a condition with a field, operator, and value. - `key` string, required — The field to apply the condition on - `value` string, required — The value to compare against - `operator` 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'like' | 'contains' | 'starts_with' | 'not_like' | 'regex', required — Operator for a filter condition. - union[] - union - … - `results` StoreSearchEventResult[] — Chunks that matched the pattern - `store_id` string, required — ID of the store the chunk belongs to - `file_id` string, nullable — ID of the file the chunk belongs to - `filename` string, nullable — Name of the file the chunk belongs to - `chunk_index` integer, required — Index of the chunk within its file - `score` number, required — Final score assigned to the chunk - `first_stage_position` integer, nullable — Position of the chunk in the first-stage ranking - `first_stage_source` 'dense' | 'sparse' | 'both', nullable — Which first-stage retriever surfaced the chunk ## 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/f66774ddecfc/schema)