Cancelling a Booking
A booking can be cancelled until its trip has started. The money paid from your wallet goes back to the wallet straight away, less the cancellation charge.
Cancellation charges
EazyGo's cancellation charges depend on how long before pickup you cancel, e.g. "less than 24 hours before pickup: 25% of the booking". The tightest matching rule applies, and cancelling well ahead is usually free. Always check with the endpoint below rather than working the charge out yourself.
GET /bookings/{reference}/cancellation
What cancelling now would cost, without cancelling.
{
"success": true,
"data": {
"reference": "EZ7Q2K9P4XMA",
"cancellable": true,
"charge": 165.38,
"refund_to_wallet": 496.12
}
}
charge and refund_to_wallet are null when the booking can't be cancelled any more (already cancelled, or the trip has started or finished).
POST /bookings/{reference}/cancel
Cancels the booking and refunds the wallet. The body is optional: send reason (up to 500 characters) to say why, and it is kept on the booking.
curl -X POST https://eazygo.in/api/agent/v1/bookings/EZ7Q2K9P4XMA/cancel \
-H "Authorization: Bearer $EAZYGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "reason": "Passenger flight cancelled" }'
{
"success": true,
"message": "Booking cancelled. ₹496.12 is back in your wallet.",
"data": {
"reference": "EZ7Q2K9P4XMA",
"status": "cancelled",
"cancellation": {
"reason": "Passenger flight cancelled",
"cancelled_at": "2026-11-18T14:02:11+05:30",
"charge": 165.88
},
"...": "...",
"refunded_to_wallet": 496.12
}
}
Cancelling twice is safe. The second request returns 409 NOT_CANCELLABLE and refunds nothing more.
| HTTP | error |
Meaning |
|---|---|---|
| 404 | BOOKING_NOT_FOUND |
No booking with this reference for this key |
| 409 | NOT_CANCELLABLE |
Already cancelled, or the trip has started or finished |
| 500 | CANCEL_FAILED |
The refund didn't go through, so the booking stays as it was. Try again or contact support |
The passenger, and the driver if one was assigned, are told about the cancellation automatically.