---
title: "Search events with a validated Boolean filter tree"
method: POST
path: "/organizations/{organizationId}/events/search"
tags: ["Events"]
---

# Search events with a validated Boolean filter tree

`POST /organizations/{organizationId}/events/search`

## Request

- Base URL: `https://api.chatdna.co/agent-push-kit/v1`
- URL: `https://api.chatdna.co/agent-push-kit/v1/organizations/{organizationId}/events/search`
- Auth: HTTP bearer

## Path parameters

- `organizationId` string, required

## Request body

- SearchEventsInput
  - `filter` union, required
    - FilterGroup
      - `operator` 'AND' | 'OR', required
      - `children` EventFilter[], required
    - FilterNot
      - `operator` 'NOT', required
      - `child` EventFilter, required (recursive)
    - TextFilterCondition
      - `field` 'service' | 'type' | 'title' | 'body', required
      - `comparison` 'equals' | 'contains', required
      - `value` string, required
    - TimeFilterCondition
      - `field` 'createdAt', required
      - `comparison` 'before' | 'after' | 'onOrBefore' | 'onOrAfter' | 'equals', required
      - `value` string, date-time, required
  - `cursor` string
  - `limit` integer

## Response `201`

Event page

- EventPage
  - `events` EventSummary[], required
    - `id` string, required
    - `type` string, required
    - `title` string, required
    - `body` string, required
    - `externalId` string, nullable
    - `actionUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `service` ServiceSummary, required
      - `id` string, required
      - `name` string, required
      - `displayName` string, required
  - `nextCursor` string, nullable

## Other responses

- `400`: Invalid request
- `401`: Missing, invalid, or revoked credentials
- `404`: The resource is absent or outside the current user's customer accounts

---

[API](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api.md) · [All operations](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api/revisions/f522c3cf50bf?raw)