Register a new driver and their vehicle in the Atithi system.

Admin: Approve or reject a pending driver registration.

Update a driver's personal or vehicle details. Only provide fields you want to change.

Replace a driver's entire weekly schedule. All existing entries are replaced.

Update a driver's current real-time location.

Add a Verified driver to a hotel's preferred driver list. Caller must be a Hotel Manager for that hotel.

Remove a driver from a hotel's preferred driver list. Caller must be a Hotel Manager for that hotel.

Calculate distance and estimated fare in INR for a ride based on pickup, drop-off, passenger count, and vehicle type. Present this fare to the guest for confirmation before calling create_booking().

Create a new guest ride booking with passenger count and estimated fare. Returns booking_id. Then call get_next_driver() to begin driver search.

Get the next best available driver for a booking. Searches Preferred Pool first, then Global Pool, matching passenger seating capacity. Returns driver & full vehicle contact info.

Record a driver's response to a booking call. Updates driver score. Returns next_action: RIDE_STARTED or GET_NEXT_DRIVER.

Record a 30-second timeout or dropped voice call for a driver. Automatically logs 'No Response' and returns next_action: GET_NEXT_DRIVER.

Mark a booking as completed when the guest reaches the destination. Frees the driver and awards +10 score.

Cancel a booking. If cancelled by Driver, applies a -20 score penalty. If no driver was found, set cancelled_by to 'No Driver Available'.

Get full profile, vehicle info, and performance score for a driver.

Get the current status and full details of a booking, including assigned driver info.

List all currently available Verified drivers. Optionally filter by current location.

Get all preferred drivers for a hotel, sorted by driver score.

Get the full call attempt history for a booking, ordered by attempt number.

Get all available pickup/drop locations. Optionally filter by location type.