List Store Events

GET/v1/stores/{store_identifier}/events

Authorization

Authorizationstringrequired

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

Path Parameters

store_identifierstringrequired

The ID or name of the store

Query Parameters

event_typeenumrequired

The type of event to list

Possible values

ingestionsearch

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/stores/{store_identifier}/events

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

Response

JSON

{
  "object": "list",
  "data": [
    {
      "id": "evt_abc123",
      "type": "ingestion",
      "created_at": "2025-01-15T14:30:00.000Z",
      "store_id": "vs_abc123",
      "store_file_id": "vsf_def456",
      "total_time": "PT5.2S",
      "queue_time": "PT1.1S",
      "ingestion_time": "PT4.1S",
      "chunk_count": 42,
      "contextualization": true,
      "mode": "high_quality",
      "filename": "product-docs.pdf"
    },
    {
      "id": "evt_def456",
      "type": "ingestion",
      "created_at": "2025-01-15T14:25:00.000Z",
      "store_id": "vs_abc123",
      "store_file_id": "vsf_ghi789",
      "total_time": "PT2.8S",
      "queue_time": "PT0.5S",
      "ingestion_time": "PT2.3S",
      "chunk_count": 15,
      "contextualization": false,
      "mode": "fast",
      "filename": "faq.md"
    }
  ],
  "pagination": {
    "has_more": true,
    "first_cursor": "eyJpZCI6ImV2dF9hYmMxMjMifQ==",
    "last_cursor": "eyJpZCI6ImV2dF9kZWY0NTYifQ=="
  }
}