Kuvo API

v1.0.0 Running

Browse Outlets

VIEW/outletsView all outlets and order from any

UI Pages

APP/customer/Customer mobile ordering
APP/cashier/Cashier POS interface
APP/kitchen/Kitchen display system
APP/owner/Owner dashboard
APP/owner/signup.htmlOwner registration (signup)
APP/manager/Multi-outlet manager dashboard
APP/admin/Platform admin dashboard
APP/admin/command-center.htmlPlatform admin command center
APP/order/Customer order status lookup

Health & Info

GET/api/health

Customer APIs

GET/api/outlets/abc123/menuDemo Cafe menu
GET/api/outlets/abc123/menu?type=takeawayTakeaway prices
POST/api/ordersCreate order (POST)
GET/api/orders/7ptSample order
GET/api/orders/7pt/qrOrder QR code

Cashier APIs

POST/api/cashier/login+919876543211 / password
GET/api/cashier/ordersRequires auth token
POST/api/cashier/ordersCreate POS order
PUT/api/cashier/orders/{id}/statusUpdate status

Kitchen APIs

POST/api/kitchen/loginOutlet ID + PIN
GET/api/kitchen/countersGet outlet counters
GET/api/kitchen/orders?status=pending,preparing&counter_id=1
PUT/api/kitchen/orders/{id}/statusUpdate order status
GET/api/kitchen/statsToday's stats
GET/api/kitchen/surgeSurge detection

Kiosk APIs

POST/api/kiosk/validate-qrValidate order QR
POST/api/kiosk/print-tokenMark token printed
POST/api/kiosk/heartbeatDevice heartbeat
GET/api/owner/outlets/{id}/kiosksList outlet kiosks
POST/api/owner/outlets/{id}/kiosksRegister kiosk

Owner APIs

POST/api/owner/signupRegister new owner
POST/api/owner/send-otpSend phone OTP
POST/api/owner/verify-otpVerify phone OTP
POST/api/owner/auth/loginowner@demo.com / password
POST/api/owner/refreshRefresh token
GET/api/owner/auth/meGet current owner
GET/api/owner/outletsRequires auth token
GET/api/owner/outlets/{id}/menuOutlet menu
POST/api/owner/outlets/{id}/menuAdd item
PUT/api/owner/outlets/{id}/menu/{item_id}Update item
GET/api/owner/outlets/{id}/analyticsAnalytics

Manager APIs

POST/api/manager/loginManager phone + password
POST/api/manager/refreshRefresh token
GET/api/manager/outletsGet assigned outlets
GET/api/manager/dashboardManager dashboard stats

Platform Admin APIs

POST/api/platform/loginadmin@kuvo.com / password
GET/api/platform/dashboardRequires admin token
GET/api/platform/outletsList all outlets
POST/api/platform/outletsCreate outlet
GET/api/admin/outlets/pendingPending approval outlets
POST/api/admin/outlets/{id}/approveApprove outlet
POST/api/admin/outlets/{id}/rejectReject outlet

Test Credentials

Owner: owner@demo.com / password

Cashier: +919876543211 / password

Platform Admin: admin@kuvo.com / password

Demo Outlet ID: abc123