Skip to Content
Mixedbread

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.

GET
/v1/events

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Api key to access Mixedbreads API

Query Parameters

limit?Limit

Maximum number of items to return per page (1-100)

Range1 <= value <= 100
Default20
after?|

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 Total

Whether to include total count in response (expensive operation)

Defaultfalse
filter_before?|

Time to filter events before

filter_after?|

Time to filter events after

event_type*Event Type

The type of event to list

Value in"ingestion""search""agentic_search""grep""completion""qa"
store_identifier?||

Restrict to one store by ID or name; omit to span every store

Response Body

The organization's events of the requested type, newest first

application/json
  1. response
pagination*

Response model for cursor-based pagination.

object?Object

The object type of the response

Default"list"
data*array<|||||>

The list of events

Example Request
cURL
curl 'https://api.mixedbread.com/v1/events?event_type=completion&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example Response
{
  "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=="
  }
}