Developer API & Mobile Integration
Single source of truth REST API serving the Next.js web application and the forthcoming Flutter Android/iOS mobile apps. Enforces strict server-side RBAC, ISO-8601 UTC timestamps, and standardized JSON envelopes.
Bearer + Cookie Auth
Stateless JWT Bearer header for Flutter clients alongside HTTP-only secure cookies for web browsers.
UTC ISO-8601
All timestamps stored and returned in UTC (e.g. 2026-09-20T04:30:00Z). Frontends localise to user timezone.
Standard Envelopes
Predictable payload shape: { success, data, error, meta } for unified client error handling.
API Endpoints Reference
/api/v1/auth/request-otpAuthenticationRequest 6-digit OTP for Indian phone number
Production v1 endpoint.
/api/v1/auth/verify-otpAuthenticationVerify OTP and obtain JWT Bearer token
Production v1 endpoint.
/api/v1/programsProgramsList all 11 database-driven English programs
Production v1 endpoint.
/api/v1/tutorsTutorsSearch & filter approved tutors
Production v1 endpoint.
programSlug(string)accent(string)search(string)/api/v1/availability/slotsBooking EngineGenerate 25-minute bookable slots for a tutor
Production v1 endpoint.
tutorId(string)*requireddate(string)*required/api/v1/bookings/hold-slotBooking EngineReserve a 10-minute hold on a slot during checkout
Production v1 endpoint.
/api/v1/bookings/confirmBooking EngineConfirm a booking and consume 1 credit (FIFO)
Production v1 endpoint.
/api/v1/sessions/{id}/tokenLive 25-Min SessionObtain authorized live session token (-10m to +10m window)
Production v1 endpoint.
id(string)*required/api/v1/feedback/{bookingId}Tutor FeedbackSubmit structured post-session tutor feedback (within 24h SLA)
Production v1 endpoint.
bookingId(string)*required/api/v1/payments/create-orderPayments & CreditsCreate Razorpay order for ₹99 trial or session package
Production v1 endpoint.
