Cancel a ride
cancel_rideCancels a BinaSmart ride that has not started yet. A cancellation cannot be undone. Needs the ride id and the rider phone used to book.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ride_id": "<ride_id>",
"rider_phone": "<rider_phone>"
},
"name": "cancel_ride"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ride_id | Yes | Ride id returned by request_ride | |
| rider_phone | Yes | Ethiopian phone number used to book the ride, in the form 09xxxxxxxx or +2519xxxxxxxx |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | How to use or present this result | |
| test | No | true for a reviewer test booking (no driver is sent) | |
| tier | No | Vehicle tier | |
| driver | No | Assigned driver, null until one is assigned | |
| pickup | No | Pickup place | |
| status | No | dispatching, assigned, arriving, arrived, ontrip, completed, cancelled, or test_booking | |
| dropoff | No | Drop-off place | |
| ride_id | No | Ride id (needed for get_ride_status and cancel_ride) | |
| fare_etb | No | Fixed fare in birr | |
| source_url | No | bina.et page this result comes from; cite it | |
| requested_at | No | When the ride was requested (ISO time) | |
| tracking_url | No | Live tracking page | |
| payment_method | No | cash, telebirr or chapa | |
| payment_status | No | Payment status |