Driver App API

Base: https://dev-api.metaonus.in/driver/*

Authentication

Method	Endpoint	Description
POST	/user-auth/login	Send OTP to phone
POST	/user-auth/otp-verify	Verify OTP, receive tokens
POST	/user-auth/set-pin	Set 4-digit PIN (first login)
POST	/user-auth/get-pin	Quick login with PIN
POST	/user-auth/get-forgotten-pin	Request PIN reset OTP
POST	/user-auth/verify-change-pin-otp	Verify PIN reset OTP
POST	/user-auth/change-pin	Set new PIN after reset
POST	/user-auth/refresh-token	Refresh access token

Profile

Method	Endpoint	Description
GET	/user-auth/profile	Get driver profile
POST	/user-auth/update-phone	Update phone number

Bus & Trips

Method	Endpoint	Description
GET	/bus-tracking/get-assigned-bus	Get assigned bus
GET	/bus-tracking/trips	Get today's trips
GET	/bus-tracking/trips/{tripId}	Get trip details with stops
GET	/bus-tracking/trips/{tripId}/stops	Get stops for a trip
PUT	/bus-tracking/bus-stops/reorder	Reorder stops on a trip

Trip Actions

Method	Endpoint	Description
POST	/bus-tracking/trips/{tripId}/start	Start a trip
POST	/bus-tracking/trips/{tripId}/pause	Pause a trip
POST	/bus-tracking/trips/{tripId}/resume	Resume a paused trip
POST	/bus-tracking/trips/{tripId}/end	End a trip

Students

Method	Endpoint	Description
GET	/bus-tracking/get-assigned-students	Get all assigned students
GET	/bus-tracking/trips/{tripId}/students	Get students for a trip (optionally filtered by stop)
POST	/bus-tracking/trips/{tripId}/students/mark	Mark student status (boarded/absent/alighted/no_show)

Incidents

Method	Endpoint	Description
POST	/bus-tracking/incidents	Report an incident
GET	/bus-tracking/incidents	Get incident history

Tracking

Method	Endpoint	Description
POST	/bus-tracking/update-location	Push current GPS location
POST	/bus-tracking/batch-locations	Batch upload buffered location updates