Skip to main content
POST
/
v1
/
events
/
search
Retrieve events based on filters
curl --request POST \
  --url https://api.dp1.us.honeyhive.ai/v1/events/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "field": "<string>",
      "operator": "exists",
      "value": "<string>",
      "type": "string"
    }
  ],
  "limit": 500,
  "page": 2,
  "ignore_order": true,
  "evaluation_id": "<string>"
}
'
{
  "events": [
    {
      "project": "<string>",
      "project_id": "<string>",
      "source": "<string>",
      "event_name": "<string>",
      "event_type": "model",
      "event_id": "<string>",
      "session_id": "<string>",
      "parent_id": "<string>",
      "children_ids": [
        "<string>"
      ],
      "config": {},
      "inputs": {},
      "outputs": {},
      "error": "<string>",
      "start_time": 123,
      "end_time": 123,
      "duration": 123,
      "metadata": {},
      "feedback": {},
      "metrics": {},
      "user_properties": {}
    }
  ],
  "count": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.honeyhive.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for POST /v1/events/search

filters
object[]

Array of filter criteria to apply

dateRange
object
limit
integer

Limit number of results (default 1000, max 1000)

Required range: 1 <= x <= 1000
page
integer

Page number of results (default 1)

Required range: x >= 1
ignore_order
boolean

Deprecated: accepted for SDK back-compat but treated as a no-op. Pagination requires a stable ORDER BY to produce consistent pages, and with the 1000-row cap skipping the sort is not worth the inconsistency. The route always orders by start_time DESC.

evaluation_id
string

Filter by evaluation/experiment run ID

Response

200 - application/json

Success

Response for POST /v1/events/search and POST /v1/events/export

events
object[]
required
count
number
required