API Documentation

Courier Status Update

post https://yourwebhook.com/courier_update

This webhook delivers real-time updates on each delivery, based on information provided by the integrated Dispatch partner.

Courier Status Updates

Webhook events are triggered based on the following conditions. Early in the delivery process, events may be infrequent but become more regular after an order is assigned. The same status enum may be sent with updated details:

  • Courier co-ordinates change
  • pickupTimeETA or deliveryTimeETA changes by more than 60 seconds
  • Delivery status changes (e.g., DELIVERY_CREATED → EN_ROUTE_TO_PICKUP)
  • A courier is reassigned
ⓘ Requires Integrated Dispatch
A Dispatch provider needs to be integrated in a customer location for courier status updates to be received

Definitions

The various attributes delivered with Courier status updates are listed in the link below;

▶ See Courier Status Update Model

Courier Statuses

For a full list of all courier status values, see the link below;

▶ See All Courier Statuses

Example Courier Status Updates

{
    "orderId": "651142e93c54c5405****6a3",
    "channelOrderId": "T8****28",
    "status": 87,
    "deliveryTime": "YYYY-MM-DDT08:36:46.SSSSSSZ",
    "courierName": "DRIVER NAME",
    "coordinates": {
        "coordinates": [
            -4.294259666220875,
            55.78873945318564
        ]
    },
    "courierId": "9B******HK",
    "dispatchPartner": "COURIERAPP"
}

{
    "orderId": "651142e93c54c5405****6a3",
    "channelOrderId": "T8****29",
    "status": 87,
    "deliveryTime": "YYYY-MM-DDT08:36:46.SSSSSSZ",
    "courierName": "DRIVER NAME",
    "coordinates": {
        "coordinates": [
            -4.294259666220875,
            55.78873945318564
        ]
    },
    "courierId": "9B******HL",
    "dispatchPartner": "UBERDAAS",
    "multipleDrivers": true
}

Response format

OK
Language