Skip to main content
POST
Retrieve events based on filters

Authorizations

Authorization
string
header
required

A fine-grained data plane API key (values begin with hh_fgdp_). Rooted at an organization, workspace, or project, it carries the permissions chosen when it was created, and only the operations whose paths begin with /v1/projects/{project_id}/ accept it. Create one in the HoneyHive app under the project's, workspace's, or organization's Settings → API Keys, on the Data Plane tab.

Path Parameters

project_id
string
required

The unique identifier of the project whose events to search

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 but ignored. Results are always ordered by start_time descending.

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