Driver status notifications report key milestones in a last‑mile delivery: pickup, transit, drop‑off, and returns. Walmart sends a JSON payload to your destination URL for each status change. Use these events to update order tracking, notify customers, and reconcile delivery Service Level Agreements (SLAs).
Event metadata
Event type: DRIVER_STATUS
Event version: V1
Resource name: ORDER
Supported delivery statuses (deliveryStatus)
Value
When it occurs
Typical use
ENROUTE_TO_PICKUP
Driver is heading to the pickup location.
Show driver ETA to pickup; prep order.
ARRIVED_AT_PICKUP
Driver has arrived at the pickup location.
Signal handoff to driver.
DISPATCHED
Driver departed pickup with order.
Start customer tracking; mark order as on the way.
ENROUTE_TO_DROPOFF
In transit to customer.
Update customer ETA.
ARRIVED_AT_DROPOFF
Driver reached the drop‑off location.
Prepare for delivery confirmation.
DELIVERED
Delivery completed.
Close shipment; trigger post‑delivery flows.
ENROUTE_TO_RETURN
Driver is returning undelivered items.
Inform customer and ops; start exception flow.
ARRIVED_TO_RETURN
Driver arrived at the return location.
Receive returned goods.
RETURNED
Return to facility is complete.
Reconcile inventory and refund if applicable.
Response parameters
Name
Description
Type
source
Metadata about the event
Object
eventType
Event for which the notification is received. Example: DRIVER_STATUS
String
eventTime
Timestamp of when the event occurred in ISO 8601 UTC
String
eventId
Unique identifier for the event
String
eventFilters
Reserved for future use; may be null
Object or null
payload
Event-specific details
Object
partnerId
Seller’s partner ID
String
sellerId
Seller’s account identifier
String
purchaseOrderId
A unique identifier associated with the seller’s purchase order
String
customerOrderId
A unique identifier associated with the sales order for a specified customer
String
orderDate
The date the customer submitted the sales order
String
orderStatus
Current order status. Example: LOADED
String
deliveryId
Unique delivery identifier
String
deliveryStatus
Driver status value. Refer to the Supported delivery statuses table.
String (enum)
orderPickupReadyTime
Earliest time the order is ready for pickup. ZonedDateTime. ISO 8601 UTC
String
minDeliverySlotTime
Start of promised delivery window. ZonedDateTime. ISO 8601 UTC
String
maxDeliverySlotTime
End of promised delivery window. ZonedDateTime. ISO 8601 UTC
String
actualDeliveryPickupTime
Time the driver picked up the order in epoch milliseconds
Long
actualDeliveryTime
Time the delivery was completed. ZonedDateTime. ISO 8601 UTC if present
String
undeliverableReasons
If not delivered, reason details. The reason that was selected during the return creation
String
reasonCode
Exception code when not delivered. Example: 3P629, LMD1505
String
description
Human‑readable reason. Example: Can't Access, Found a better offer
