Skip to main content
POST
/
event
/
search
Search events with filtering and pagination
curl --request POST \
  --url https://demo.enneo.ai/api/mind/event/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "key": "e.status",
      "comparator": "in",
      "values": [
        "open",
        "closed"
      ]
    },
    {
      "key": "e.createdAt",
      "comparator": "between",
      "from": "2023-01-01",
      "to": "2023-12-31"
    },
    {
      "key": "q",
      "comparator": "equal",
      "value": "abc"
    }
  ]
}
'
{
  "events": [
    {
      "id": 3665,
      "type": "ticketUpdated",
      "subType": null,
      "status": "closed",
      "data": null,
      "user": {
        "id": 2,
        "email": "[email protected]",
        "gender": "female",
        "firstName": "Alice",
        "lastName": "Anderson",
        "companyIds": [
          1
        ],
        "image": null,
        "type": "user"
      },
      "createdAt": "2026-01-13 18:28:51",
      "activity": "closed the ticket",
      "ticketId": 8,
      "details": [
        {
          "label": "Event ID",
          "value": "3665",
          "tooltip": null,
          "url": null,
          "type": "string"
        },
        {
          "label": "Event type",
          "value": "ticketUpdated",
          "tooltip": null,
          "url": null,
          "type": "string"
        },
        {
          "label": "Duration (s)",
          "value": "0.018",
          "tooltip": null,
          "url": null,
          "type": "string"
        },
        {
          "label": "Trace-ID",
          "value": "ee0897510b4f0ef773dd007d2e6dda66",
          "tooltip": null,
          "url": "https://signoz.enneo.ai/trace/ee0897510b4f0ef773dd007d2e6dda66",
          "type": "string"
        }
      ],
      "tabs": [],
      "showToUser": true,
      "eventTraces": []
    }
  ],
  "pagination": {
    "total": 3,
    "offset": 0,
    "limit": 1
  }
}

Authorizations

​
Authorization
string
header
required

JWT-based authentication

Query Parameters

​
offset
integer
default:0

Pagination offset

​
limit
integer
default:20

Number of items to return (max 100)

Required range: x <= 100
​
orderByField
enum<string>
default:e.createdAt

Field to sort by (only indexed fields are supported)

Available options:
e.id,
e.type,
e.subType,
e.contractId,
e.ticketId,
e.status,
e.createdAt,
e.createdBy
​
orderByDirection
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
includeTraces
boolean
default:true

Whether to include event traces in the response

​
format
enum<string>
default:formatted

Response format. 'formatted' returns processed events with typed data and transformations. 'raw' returns raw database objects with JSON fields decoded but without additional postprocessing.

Available options:
formatted,
raw

Body

application/json

Filters for searching events

​
filters
object[]

Array of filter objects for searching events. Supported filter fields (indexed fields only): e.id, e.type, e.subType, e.contractId, e.ticketId, e.status, e.createdAt, e.createdBy Note: e.subType can only be used in combination with e.type due to the way the database is indexed. Supported comparators: - "=" (equals) - "!=" (not equals) - ">" (greater than) - "<" (less than) - ">=" (greater than or equal) - "<=" (less than or equal) - "in" (in list, use with 'values' array) - "between" (between range, use with 'from' and 'to') Special key 'q': - A filter with key 'q' will search across all JSON data fields (data, outcome, hookOutcome) - Example: {"key":"q","comparator":"equal","value":"abc"} searches for "abc" in all JSON fields - Must be used with at least one other non-LIKE filter (e.g. status, id, date) - An exception will be thrown if used without other non-LIKE filters - The 'value' parameter is required Special date values for date comparisons: - "CURRENT_TIME" - Current time - "CURRENT_DATE" - Current date - "-1 DAY" - Yesterday - "1 DAY" - Tomorrow - "-1 HOUR" - One hour ago - "1 HOUR" - One hour from now Example: - {"filters":[{"key":"e.ticketId","value":"8","comparator":"="},{"key":"e.type","values":["TicketUpdated"],"comparator":"in"}]}

Response

Successful operation

​
events
object[]
​
pagination
object