Happy Hour API

Quickstart

Version 0 returns data straight from a limited dataset mainly from restaurants in Chicago. The dataset is constantly being maintened and expanded.

curl https://your-vercel-app.vercel.app/api/happyhours

Best for quick terminal checks or wiring into shell scripts and cron jobs.

Every example hits the same endpoint and returns the full array of happy hours with address, schedule, and deal metadata. No API key, rate limiting, or auth layer yet.

Example Response

Each happy hour entry captures core location details plus the schedule and specials offered.

{
  "id": "uuid",
  "name": "string",
  "neighborhood": "string",
  "address": {
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "lat": number,
    "lng": number
  },
  "days": ["monday", "tuesday", "..."],
  "hours": {
    "start": "HH:mm",
    "end": "HH:mm"
  },
  "deals": [
    { "item": "string", "price": number }
  ],
  "notes": "string | optional"
}

Endpoints

GET /api/happyhours

Returns the full dataset as an array.

Supports future filtering via query params such as ?day=friday or ?neighborhood=logan-square (coming soon).

GET /api/happyhours/:id

Returns a single happy hour by UUID. Stage 1 exposes the entire list only; this route will arrive alongside filtering support.

Roadmap

Filtering by day, neighborhood, and vibe tags.
Geo-aware queries using lat/lng radius search.
Optional API tokens once rate limits go live.