API Documentation

Base URL: http://localhost:4000/api

Auth

{ "email": "admin@stadiumos.ai", "password": "StadiumOS2026!" }

Returns access token, refresh token, and user profile.

{ "name": "Visitor", "email": "visitor@example.com", "password": "StrongPass2026!", "role": "VISITOR" }

GET /health — returns API status.
GET /dashboard — returns realtime KPIs, incidents, crowd zones, parking, vendors, tickets, and AI insights.
GET /modules/:name — module-specific operating data.
GET /incidents?page=1&limit=20 — paginated incidents.

Creates an incident and returns AI analysis.

{ "title": "Blocked exit", "location": "Gate C", "description": "Queue is blocking the accessible exit lane." }

{ "message": "Where should section 126 enter?", "language": "en" }

{ "qrCode": "QR-EXAMPLE" }

Searches operational data.

Connect to ws://localhost:4000.

Message format:

{ "type": "snapshot", "data": {} }