---
title: "Search Events"
method: POST
path: "/v0/search/search_events"
tags: ["V0", "Search", "HAS_MCP_EQUIVALENT"]
---

# Search Events

`POST /v0/search/search_events`

## Request

- Base URL: `https://api.ultralayer.ai`
- URL: `https://api.ultralayer.ai/v0/search/search_events`
- Auth: HTTP bearer

Search for events semantically (or not). Various filters available: timestamp, occurrence, event type, symbols, and more.

## Request body

- EventSearchParams
  - `query` string, nullable
  - `start_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601
  - `end_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601; null=realtime
  - `event_type` string, nullable
  - `symbols` string[], nullable: Match any.
  - `limit` integer
  - `developments_per_event` integer
  - `include_future_developments` boolean: Include future occurrence times relative to end_timestamp or now.
  - `detail` 'full' | 'essential': essential:minimal; full:all.

## Response `200`

Events at detail=full.

- EventFromDB[]
  - `event_id` integer, required: Logical identifier for the event.
  - `name` string, required: Name of the event.
  - `description` string, required: Description of the event.
  - `event_type` string, required: Type of the event.
  - `recent_developments` DevelopmentSummary[], required: Most recent developments for this event (count controlled by developments_per_event param), ordered by occurrence_timestamp descending.
    - `development_id` integer, required: Logical identifier for the development across updates.
    - `timestamp` string, date-time, required: Canonical backtest system timestamp of this development version.
    - `occurrence_timestamp` string, date-time, required: Actual (estimate of) real world time that the development took place.
    - `occurrence_timestamp_confidence_score` number, required: Confidence score in estimate of occurrence_timestamp.
    - `name` string, required: Name of the development.
    - `description` string, required: Description of the development.
    - `development_type` string, required: Type of the development.
    - `occurrence_status` string, required: Status of the real world occurrence.
    - `importance_score` number, required: LLM heuristic of general development importance.
    - `surprise_score` number, required: LLM heuristic of how surprising the development is to the market.
    - `confidence_score` number, required: LLM heuristic of its confidence in everything it presents.
    - `event_ids` integer[], required: Raw list of event IDs this development is associated with.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ultralayer/apis/ultralayer-api.md) · [All operations](https://skmtc.dev/ultralayer/apis/ultralayer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ultralayer/apis/ultralayer-api/revisions/4185459222be?raw)