Driver events endpoint
What does it do?
The driver events endpoint allows you to give the customer live updates during their trip, such as alerting them that the driver has set off to pick them up, or that they have arrived at the pickup location.
It is important to note that driver assignments are not driver events: a driver may be assigned to a ride at any time, but an event should be triggered at the correct time in relation to the booking.
Customer view of a driver event:
Why use it?
Driver events are proven to have a positive impact on customer experience, therefore your quality score will improve if you do this.
Providing driver events also helps in the event of a customer dispute. Should a customer contact us to report their driver being late, or not showing up. We'll have all the information we need to resolve the matter without needing to contact you for evidence.
Who is it for?
This endpoint is aimed at our partners who are connected to us via API and have their own driver app.
If you use our Booking.com driver app then you may disregard this, as you’re already sending us driver events.
How does it work?
The driver events endpoint allows supply partners to push the driver events for the booking. Driver events are the series of sequence while starting from driver location to pickup customer and till the time trip gets completed.
There are five types of events to be pushed:
Parameter |
Description |
DRIVER_DEPARTED_TO_PICKUP |
Driver has started the job and is on their way to the pickup location. |
DRIVER_ARRIVED_AT_PICKUP |
Driver has arrived at the pickup location and is ready to meet the customer. |
DRIVER_SUBMITTED_CUSTOMER_NO_SHOW |
Driver has waited the allotted waiting time, has made reasonable attempt to contact the customer per our commercial agreement and is unable to start the ride. |
DRIVER_DEPARTED_TO_DROPOFF |
Driver has collected the customer and is on their way to the dropoff location. |
DRIVER_ARRIVED_AT_DROPOFF |
Driver has completed the ride and has dropped off the customer. |
Very Important: Latitude and Longitude are two essential fields for all bookings. No driver events should be sent without them.
How do I get started?
Click here to access our documentation on driver events and share it with your developers.