List Events
List your organization's search, grep, ingestion, question answering, and chat completion events across all stores, with pagination and time filters.
Lists one type of event across every store of the organization. Store activity is recorded as search, agentic_search, grep, ingestion, and qa events; chat activity as completion events, one per turn of the Chat Completions or Responses API, carrying the model generations and hosted store tool calls the turn issued. Pass store_identifier to narrow the listing to one store; without it, events tied to no store (such as completions that never called a store tool) are included as well. The event shapes are the same as on the store events endpoint.
A question answering request produces a single qa event covering both its retrieval and its answer generation. That retrieval is not listed again under event_type=search or event_type=agentic_search, so a qa request is counted once rather than appearing as both a search and an answer.
ApiKeyAuthAuthorizationBearer <token>Api key to access Mixedbreads API
limit?LimitMaximum number of items to return per page (1-100)
1 <= value <= 10020after?|Cursor for forward pagination - get items after this position. Use last_cursor from previous response.
before?|Cursor for backward pagination - get items before this position. Use first_cursor from previous response.
include_total?Include TotalWhether to include total count in response (expensive operation)
falsefilter_before?|Time to filter events before
filter_after?|Time to filter events after
event_type*Event TypeThe type of event to list
"ingestion""search""agentic_search""grep""completion""qa"store_identifier?||Restrict to one store by ID or name; omit to span every store
The organization's events of the requested type, newest first
application/json- response
pagination*Response model for cursor-based pagination.
object?ObjectThe object type of the response
"list"data*array<|||||>The list of events
curl 'https://api.mixedbread.com/v1/events?event_type=completion&limit=20' \
-H 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"id": "evt_abc123",
"type": "completion",
"created_at": "2025-01-15T14:30:04.000Z",
"store_ids": [
"vs_abc123"
],
"completion_id": "chatcmpl_9f2c1",
"endpoint": "chat_completions",
"model": "toast-1",
"title": "Refund policy",
"previous_completion_id": null,
"root_completion_id": "chatcmpl_9f2c1",
"persisted": true,
"finish_reason": "stop",
"started_at": "2025-01-15T14:30:00.000Z",
"total_time": "PT4.2S",
"user_message": "What is the refund window for annual plans?",
"answer": "Annual plans can be refunded within 30 days of purchase <cite i=\"0\"/>.",
"token_usage": {
"prompt_tokens": 1840,
"completion_tokens": 96,
"total_tokens": 1936
},
"tool_calls": [
{
"tool_call_id": "generation-1",
"tool_name": "generation",
"tool_type": "function",
"started_at": "2025-01-15T14:30:00.000Z",
"duration": "PT1.1S",
"arguments": {
"messages_count": 2,
"model": "toast-1"
},
"result": {
"content": null,
"tool_calls": [
{
"id": "call_1",
"name": "store_search"
}
],
"usage": {
"prompt_tokens": 900,
"completion_tokens": 24
}
}
},
{
"tool_call_id": "ss_7d1e",
"tool_name": "store_search",
"tool_type": "datastore",
"started_at": "2025-01-15T14:30:01.100Z",
"duration": "PT0.6S",
"arguments": {
"queries": [
"refund window annual plan"
]
},
"result": {
"result_count": 1,
"results": [
{
"store_id": "vs_abc123",
"file_id": "file_4b2a",
"filename": "billing-faq.md",
"chunk_index": 3,
"score": 0.91
}
]
}
},
{
"tool_call_id": "generation-2",
"tool_name": "generation",
"tool_type": "function",
"started_at": "2025-01-15T14:30:01.700Z",
"duration": "PT2.5S",
"arguments": {
"messages_count": 4,
"model": "toast-1"
},
"result": {
"content": "Annual plans can be refunded within 30 days of purchase <cite i=\"0\"/>.",
"tool_calls": [],
"usage": {
"prompt_tokens": 940,
"completion_tokens": 72
}
}
}
]
}
],
"pagination": {
"has_more": false,
"first_cursor": "eyJpZCI6ImV2dF9hYmMxMjMifQ==",
"last_cursor": "eyJpZCI6ImV2dF9hYmMxMjMifQ=="
}
}