---
title: "Special events discovery (read-only). Hits the SpecialEvent model directly — these live outside provider_custom_services and are invisible to /services/search. Filters by: - public event (active + business with a publicly eligible branch) - upcoming active occurrence - optional token matching on title / description - optional max distance from origin if coords supplied"
method: POST
path: "/events/search"
tags: ["WellFred public API"]
---

# Special events discovery (read-only). Hits the SpecialEvent model directly — these live outside provider_custom_services and are invisible to /services/search. Filters by: - public event (active + business with a publicly eligible branch) - upcoming active occurrence - optional token matching on title / description - optional max distance from origin if coords supplied

`POST /events/search`

## Request

- Base URL: `https://app.wellfred.com/api/agent`
- URL: `https://app.wellfred.com/api/agent/events/search`
- Auth: none declared

## Request body

- object
  - `amenities` string[], nullable
  - `term` string, nullable
  - `limit` integer, nullable
  - `origin` object
    - `lat` number, nullable
    - `lng` number, nullable
  - `maxDistanceKm` number, nullable

## Response `200`

- object
  - `success` boolean, required
  - `message` string, required
  - `searchMode` 'strict' | 'discovery', required
  - `strongResultCount` integer, required
  - `requestedAmenities` unknown[], required
    - unknown
  - `amenityScope` 'registered_on_same_public_occurrence_branch', required
  - `events` unknown[], required
    - unknown

## Other responses

- `422`: Validation error

---

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