events

Find upcoming Austin events from Yeehaw's sourced, deduplicated store. Structured filter over the events table; events more than 24h past are filtered. Every record carries a `source` attribution and a `confidence` score. Pass `id` to fetch one event by id; it ignores date_range and all other filters.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Fetch one event by id; ignores date_range and other filters when set."
    },
    "query": {
      "type": "string",
      "description": "Free-text keyword match against event titles."
    },
    "category": {
      "type": "string",
      "description": "Category slug (e.g. music, sports, civic)."
    },
    "neighborhood": {
      "type": "string",
      "description": "Austin neighborhood slug. One of: downtown, east-austin, hyde-park, mueller, rainey-street, south-congress, the-domain, zilker. Common shorthands (east, domain, soco, rainey) are accepted."
    },
    "date_range": {
      "type": "string",
      "description": "Required unless `id` is set. e.g. today, tonight, this_weekend, next_7_days, or an ISO date range."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum ticket price in USD. price_max=0 returns only events with a known $0 price. Most events have no listed price (sparse upstream data) — for price_max>0 those are still returned and the response states how many were not price-filtered."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, default 20, clamped to 50.",
      "default": 20
    }
  }
}

Inspectable State: report Yeehaw's operational state in one call (no input) — event counts, last successful ingest per source vs cadence, cron health, open circuit breakers, recent error tail, and coverage gaps.

{
  "type": "object",
  "properties": {}
}