THE NIGHTLIFE LAYER FOR INDIA · PUBLIC API

BUILD ON the layer.

One API for events, tickets, RSVP, café orders, walls, and coordination — across every city HYPEHAUS is live in. If you're building anything for Indian nightlife, you're building on us.

LIVE · https://api.hypehaus.orgREST/JSON · IST · paisa
WHY BUILD ON US

FOUR THINGS YOU DON'T HAVE TO build.

01
ONE ECOSYSTEM
Every event, ticket, org, and consumer lives in one graph. When you build with us you inherit the whole city.
02
INDIA-FIRST
UPI + Razorpay Route settlement. Rupees + paisa. Mumbai + Bangalore live. Delhi/Goa/Pune next.
03
THREE WALLS
Chat/walls private. Debrief only in aggregate (k≥10). Safety schema isolated. Your integration inherits these guarantees.
04
OFFLINE-FIRST GATE
HMAC-signed manifest cached at T-6h. Basement-safe scanning. Idempotency by minute.
ENDPOINTS · GROUPED BY SUBSYSTEM

WHAT YOU CAN call.

EVENTS
City events feed · publish · retrieve · attach media.
GET
/v1/events?city=MUMBAI
Live public event feed for a city (circles + cards).
← { "events": [ { "id": "evt_…", "title": "…", "startsAt": "…", "hero": "…" } ] }
PUBLIC
GET
/v1/events/{id}
One event · phases + fee lines + org.
PUBLIC
POST
/v1/events
Publish an event (org partners only).
API KEY
RSVP · WAITLIST
FIFO with auto-promotion when a spot opens.
POST
/v1/rsvp/join
Join RSVP or waitlist for an event.
→ { "eventId": "evt_…", "capacity": 200, "rsvpMode": "WAITLIST_ONLY" }
OAUTH USER
POST
/v1/rsvp/leave
Leave · promotes waitlist head automatically.
OAUTH USER
GET
/v1/rsvp/roster?eventId=…
Roster (org-side only).
API KEY
POST
/v1/rsvp/promote
Promote waitlist head (org-side).
API KEY
TICKETS · WALLET
HMAC-signed manifest · gate scanning · Apple/Google Wallet passes.
POST
/v1/tickets/mint
Mint a ticket after payment (org-side).
API KEY
GET
/v1/tickets/{id}/pass.pkpass
Download signed Apple Wallet pass.
OAUTH USER
POST
/v1/tickets/{id}/scan
Gate scan (offline-queued, idempotent by minute).
API KEY
CAFÉ ORDERS
Table QR ordering · KDS · split-bill.
POST
/v1/cafe/orders
Place a table order (KOT fires at capture).
OAUTH USER
GET
/v1/cafe/orders/{id}
Order ladder (PLACED → ACCEPTED → FIRING → SERVED).
OAUTH USER
POST
/v1/cafe/orders/{id}/split
Compute + assign split rows (canon §3.13).
OAUTH USER
MODERATION
Creator posts + campaigns · founder-side review queue.
POST
/v1/moderation/submit
Submit a post / campaign / event-hero for review.
API KEY
CITY WAITLIST
Cities without an app-live yet still collect demand.
POST
/v1/waitlist/join
Add a person to a city waitlist (dedupes by contact).
→ { "role": "CONSUMER", "city": "MUMBAI", "email": "…", "phone": "…" }
PUBLIC
GET
/v1/waitlist/totals
Per-city totals (sim + real).
PUBLIC
COORDINATION
Multi-terminal task coordination (Claude protocol) — public read.
POST
/api/coordination/sessions
Register a terminal.
PUBLIC
GET
/api/coordination/tasks?status=OPEN
Task queue.
PUBLIC
POST
/api/coordination/tasks
Post a task.
PUBLIC
GET
/api/coordination/messages
Live message stream.
PUBLIC
AUTH · THREE MODELS

HOW YOU identify.

PUBLIC
No auth. Rate-limited by IP. Anyone can call.
API KEY
Server-to-server. Bearer token issued after partner approval. Scoped per org.
OAUTH USER
End-user OAuth via HYPEHAUS Login (WebAuthn passkey or phone OTP).
PRICING · THREE TIERS

WHAT YOU pay.

One-line pricing. Start free, upgrade when you need write endpoints or webhooks. Enterprise for city-scale partners.

SANDBOX
FREE
forever · verified email
·All PUBLIC endpoints (city feed, waitlist, events read)
·Rate-limited: 60 requests / minute
·No API key required
·Perfect for prototypes and hackathons
REQUESTS · MONTH
10k
WEBHOOKS
0
SUPPORT
Discord community
START BUILDING →
BEST FIT · 90% OF PARTNERS
PARTNER · PRO
₹8,999
per month · billed monthly · INR
·Everything in Sandbox, plus
·API key with API_KEY scope (server-to-server)
·Ticket mint + café order write endpoints
·Webhook subscriptions (event.published, ticket.minted, order.served)
·OAuth user tokens for consumer-side flows
·99.9% SLA · Mumbai edge · <200ms p95
REQUESTS · MONTH
1M
WEBHOOKS
20 endpoints
SUPPORT
Slack + 4-hour response
REQUEST ACCESS →
ENTERPRISE
CUSTOM
city-scale partners · annual contract
·Everything in Pro, plus
·Volume-priced beyond 1M/month
·Dedicated org account + IP allowlist
·Private preview on new endpoints
·Co-marketing (feature on hypehaus.org city pages)
·Named engineer + call within 1 hour
REQUESTS · MONTH
unlimited
WEBHOOKS
unlimited
SUPPORT
1-hour SLA · direct line
TALK TO US →
SAMPLE · THREE LINES

YOU CAN INTEGRATE IN one afternoon.

~ / hypehaus-partner
# 1. Get the city feed (public)
$ curl https://api.hypehaus.org/v1/events?city=MUMBAI

# 2. RSVP a user (server-side, exchange for HYPEHAUS user token first)
$ curl -X POST https://api.hypehaus.org/v1/rsvp/join \
    -H "Authorization: Bearer $HH_USER_TOKEN" \
    -H "content-type: application/json" \
    -d '{ "eventId": "evt_xxx", "capacity": 200, "rsvpMode": "WAITLIST_ONLY" }'

# 3. Mint a ticket after Razorpay capture (partner key)
$ curl -X POST https://api.hypehaus.org/v1/tickets/mint \
    -H "Authorization: Bearer $HH_PARTNER_KEY" \
    -H "content-type: application/json" \
    -d '{ "eventId": "evt_xxx", "phaseId": "ph_xxx", "holderAccountId": "acc_xxx" }'
PARTNER · REQUEST ACCESS

TELL US WHAT YOU'RE building.

One line about your company and what you'd use HYPEHAUS for. If it's a good fit, we'll email you an API key + onboarding call within 48 hours.

COMPANY
YOUR NAME · CONTACT
EMAIL
PHONE · OPTIONAL
WHAT ARE YOU BUILDING · ONE LINE
WHICH SUBSYSTEMS · TAP TO SELECT
EXPECTED VOLUME · OPTIONAL
ANYTHING ELSE · OPTIONAL