---
title: "Search For Events"
method: POST
path: "/events/search"
tags: ["events"]
---

# Search For Events

`POST /events/search`

Search for events using the hybrid discovery agent (DB + Web).
Returns a STREAM of NDJSON (Newline Delimited JSON) events.

Event Types:
- {"type": "status", "msg": "...", "step": "..."}
- {"type": "result", "data": [...events...]}
- {"type": "error", "msg": "..."}

- **force_refresh**: If True, bypasses local cache and triggers a fresh web scrape.

## Query parameters

- `user_id` string, nullable

## Request body

- EventSearchRequest
  - `query` string, required
  - `force_refresh` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/imperfect/apis/imperfect-api.md) · [All operations](https://skmtc.dev/imperfect/apis/imperfect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imperfect/imperfect-api/revisions/cc2293a44257/schema)