1. On Demand
MOVER BUSINESS API
  • Orders
    • On Demand
      • Estimate / Coverage
        POST
      • Create Order (On Demand)
        POST
      • Status
        GET
      • Partner Location
        GET
      • Invoice
        GET
      • Cancel
        POST
    • Standard Delivery
      • Dispatch Order(s)
      • Order(s) Status
      • Cancel Order
  • Webhooks
    • On Demand
      • Trip Level
        • OrderCreated
        • TripStarted
        • BillGenerated
        • PartnerAssigned
        • Cancelled
        • TripEnded
      • Location Point Level
        • Arrived
        • Delivered
        • Return Started
        • Returned To Origin
        • Cancelled
        • Liquidated
      • Webhook (Legacy)
    • Standard
      • InTransit
      • Arrived
      • Delivered
      • Return Started
      • Returned To Origin
      • Cancelled
      • Liquidated
  1. On Demand

Cancel

POST
https://api.boxnmove.com/business/cancel-order
Cancel an order before a delivery partner has picked up the package.
Post Pick up the order is not cancellable.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Body Params application/json

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.boxnmove.com/business/cancel-order' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "OrderId": "XYZZZZZ",
    "CancelReason": "Package is not ready."
}'
Response Response Example
200 - Success
{
    "order": {
        "OrderId": "XYZZZZZ",
        "StatusId": 8,
        "DriverId": 88727,
        "RiderId": 167267,
        "PickUpLatitude": 28.621888080271027,
        "DropOffLatitude": 28.570856965608034,
        "DropOffLongitude": 77.31377564370632,
        "PickUpLongitude": 77.38637801259756,
        "PickUpAddress": "81, Block E, Sector 63, Noida, Hazratpur Wajidpur, Uttar Pradesh 201301, India",
        "DropOffAddress": "06, FC8, Film City, Sector 16A, Noida, Uttar Pradesh 201301, India",
        "NeedHelper": 0,
        "DriverHelperFees": 0,
        "CouponCode": null,
        "Amount": 160,
        "TotalDistance": 12129,
        "PickupOtp": "6992",
        "DropOffOtp": "7055",
        "VehicleId": 5,
        "CreatedAt": 1716392574,
        "UpdatedAt": 1716395389,
        "DriverDeviceId": "88727",
        "VehicleNumberPlate": "DLxxxxx577",
        "VehicleName": "Bike",
        "RiderName": "Jhon Doe",
        "DriverName": "Mark Finn",
        "DriverMobile": "9999999999",
        "RiderMobile": "9999999999",
        "PickUpTripId": "xxxxxxxx",
        "DropOffTripId": "xxxxxxx",
        "GoodsTypeId": 1,
        "PickUpContactNo": "xxxxxxx",
        "PickUpContactName": "xxxxxxx",
        "RecieverContactNo": "99999999999",
        "RecieverContactName": "xxxxxx",
        "PickupTrackingUrl": "https://api.boxnmove.com/track/order/XXXXXXX",
        "DropOffTrackingUrl": "https://api.boxnmove.com/track/order/XXXXXXX",
        "EstimatedJourneyTime": 1350,
        "ActualJourneyTime": 2164,
        "ActualAmount": 160,
        "PaymentMode": 2,
        "ActualJourneyDistance": 11662,
        "ReceivedPaymentMode": 2,
        "DriverTip": 0,
        "PaymentStatus": 1,
        "AmountReceived": 160,
        "CancelReason": "Package is not ready.",
        "CancelledBy": 1232,
        "DiscountAmount": 0,
        "MoverCommission": 0,
        "DriverReward": 0,
        "DropOffTripStartAt": "2024-05-22T15:53:30.716769",
        "ZoneId": 2,
        "PricingId": 0,
        "IsOutStation": 0,
        "DestinationPolyline": "wmumDsoiwME`BvDP~H\\jCH~FXhG\\vI^vCRbCDfI^fJd@bIZN@?LSfGk@rQxGP~OVjFLjMTnDFAgLp@@BvGA`DM|KGnFOpHO|JIlD[vHAx@Dv@ZxBl@jBdAjB|D~FxAxBpC~D~A~B|BlDr@bAlC~DnGdJvE~GhAdBvDpFxAzBvClEb@x@`HbKbCnDbGdJrBzCnDdFd@t@hBbCfDlFfCvD`GtI`AxAV\\lB|CfD|Eh@t@fAzATb@nArBh@z@vEfHdG`Jv@lAnC`ElFbId@p@zLnQx@rArAlB|@lAlBpC`DvEn@|@tHxJfFtGfCxDx@xAN^FTRdAlAnIZpDXvARrATjCp@hIBVCFIHKBO?IGKOg@oFs@F_Df@c@T{@n@mAx@cEjCgL~HeAn@",
        "PickupPolyline": "_jvmDoigwMxAFjKd@@O?I@QNoBDmATgIRqHPoDFSVe@lCJFCFUPoDgCK}FU?WLmEPkGZwK~Lf@HuCzFV",
        "DestinationArrivalBy": "2024-05-22T16:15:10.680386",
        "PickupArrivalBy": "2024-05-22T15:50:56.792024",
        "NoOfStops": 0,
        "OrderPlacedAt": "2024-05-22T15:42:54.023166",
        "OrderCompletedAt": "2024-05-22T16:29:49.020173",
        "ArrivedAtPickupAt": "2024-05-22T15:51:07",
        "ExitFromPickupAt": "2024-05-22T15:53:30.716772",
        "FreeLoadingSeconds": 1500,
        "TripStartedAt": "2024-05-22T15:53:30.716772",
        "TripEndedAt": "2024-05-22T16:29:35.288871",
        "ArrivedAtDropAt": "2024-05-22T16:29:14",
        "ExitFromDropAt": null,
        "DriverPickupLat": null,
        "DriverPickupLng": null,
        "DriverDropLat": null,
        "DriverDropLng": null,
        "FareRecalculated": 0,
        "MinsSpentAtPickup": 2,
        "MinsSpentAtDrop": 0,
        "TotalMinsSpent": 2,
        "ChargeableWaitMins": 0,
        "ChargePerWaitMin": 2,
        "ExtraKmGone": -12,
        "ChargePerExtraKm": 0,
        "WaitingCharge": 0,
        "ExtraKmCharge": 0,
        "CashbackGiven": 0,
        "CashbackAmount": 0,
        "WalletPay": 0,
        "PriceAgreed": 0,
        "IsInsured": false,
        "GoodsValue": 0,
        "PremiumAmount": 0
    },
    "tolls": [],
    "stops": []
}
Modified at 2026-01-23 13:18:46
Previous
Invoice
Next
Dispatch Order(s)
Built with