List Events

GET/v1/events

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.

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Query Parameters

event_typeenumrequired

The type of event to list

Possible values

ingestionsearchagentic_searchgrepcompletionqa

store_identifierstring

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

limitintegerdefault: 20

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

Constraints

•Minimum: 1•Maximum: 100

afterstring

Cursor for forward pagination - get items after this position. Use last_cursor from previous response.

beforestring

Cursor for backward pagination - get items before this position. Use first_cursor from previous response.

include_totalbooleandefault: false

Whether to include total count in response (expensive operation)

filter_beforestring(date-time)

Only return events created before this timestamp

filter_afterstring(date-time)

Only return events created after this timestamp

Response Body

objectstringdefault: list

The object type of the response

Request

cURL

GET/v1/events

curl 'https://api.mixedbread.com/v1/events?event_type=completion&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

JSON

{
  "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=="
  }
}