--- updatedAt: 2026-04-12T09:24:02.000Z --- # Driver status notification 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 | String | | driverFirstName | Driver’s first name | String | | driverLastName | Driver’s last name | String | | driverPhoneNo | Driver’s phone number | String | # Sample payloads by delivery status ## ENROUTE\_TO\_PICKUP ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:03:46.929Z", "eventId": "3dbbd610-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_PICKUP", "actualDeliveryPickupTime": "1725908620304" } } ``` ## ARRIVED\_AT\_PICKUP ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:03:50.044Z", "eventId": "3f9725c0-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_AT_PICKUP", "actualDeliveryPickupTime": "1725908624330" } } ``` ## DISPATCHED ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:26.788Z", "eventId": "9d046240-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "DISPATCHED", "actualDeliveryPickupTime": "1725908784385" } } ``` ## ENROUTE\_TO\_DROPOFF ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:33.022Z", "eventId": "a0bb9de0-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_DROPOFF", "actualDeliveryPickupTime": "1725908790448" } } ``` ## ARRIVED\_AT\_DROPOFF ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:36.340Z", "eventId": "a2b5e740-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_AT_DROPOFF", "actualDeliveryPickupTime": "1725908794079" } } ``` ## DELIVERED ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-08-23T21:04:42.968Z", "eventId": "51a5c580-6193-11ef-8e16-49386c1678f4" }, "payload": { "customerOrderId": "100000541744685", "orderStatus": "LOADED", "description": "Found a better offer", "minDeliverySlotTime": "2024-08-24T13:00:00Z", "deliveryId": "28a04c11-df87-4473-8f00-af937832be2a", "maxDeliverySlotTime": "2024-08-25T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108923741462824", "driverFirstName": "Test", "driverPhoneNo": "+19314888475", "orderPickupReadyTime": "2024-08-24T13:00:00Z", "actualDeliveryTime": "2024-08-23T21:04:41.409Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "LMD1505", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "DELIVERED", "actualDeliveryPickupTime": "1724447081409" } } ``` ## ENROUTE\_TO\_RETURN ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:01.995Z", "eventId": "1d4a5db0-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_RETURN", "actualDeliveryPickupTime": "1725908999322" } } ``` ## ARRIVED\_TO\_RETURN ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:07.955Z", "eventId": "20d7ca30-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_TO_RETURN", "actualDeliveryPickupTime": "1725909004207" } } ``` ## RETURNED ```json { "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:17.479Z", "eventId": "26850970-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "RETURNED", "actualDeliveryPickupTime": "1725909013887" } } ```