Retrieve delivery details by clientId and externalOrderId

get https://developer.api.us.walmart.com/api-proxy/service/supplychain/transportation/v1/daas/deliveries

GET <baseURL>/deliveries?clientId={clientId}&externalOrderId={externalOrderId}

This request retrieves delivery details using clientId and externalOrderId. Call this request to retrieve deliveries details. This request provides order information, delivery details, and the URL to access a delivery's Live Order Tracking. See Live Order Tracking for additional information.

Two requests provide additional information on deliveries. Use of either request is preferential based on the parameter information available.

By the deliveryId as GET {baseURL}/deliveries/{deliveryId}
By the clientId and externalOrderId, as GET {baseURL}/deliveries?clientId={clientId}&externalOrderId={externalOrderId}

After the delivery is booked, this request provides a URL that accesses live order tracking for the delivery in process in this request response. The Live Order Tracking URL routes the user to a Walmart GoLocal-hosted webpage, and this webpage provides live status about the delivery order and delivery driver location. Tracking will end one month after delivery completion. Walmart GoLocal recommends passing this live order tracking URL to end customers in all related communications, such as SMS messages, to provide transparency on the delivery. See Live Order Tracking for additional information.

A batchId field is added to the Get Delivery Details request response. This field is passed back in the API payload once Walmart GoLocal batches that delivery with other deliveries. Implement your system design and operational processes keeping this in mind.

The following fields are available in the response for Get Delivery Details request batchingDetails: routeId, dropSequence, and count. These fields will be returned in the request payload once Walmart GoLocal batches the associated delivery with other deliveries (after trip creation). Implement your system design and operational processes keeping this in mind.

Property Type and Location Preference Validation

For property type and location preference values, the following combinations are allowed:

Enum of locationPreference	HOUSE	APARTMENT	BUSINESS	OTHER	null
FRONT_DOOR	Optional	Optional	Optional	Optional	Not Allowed
BACK_DOOR	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
SIDE_PORCH	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
BUILDING_RECEPTION	Not Allowed	Optional	Optional	Optional	Not Allowed
MAILROOM_OR_PROPERTY_STAFF	Not Allowed	Optional	Optional	Optional	Not Allowed
GARAGE_DOOR	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
NO_PREFERENCE	Optional	Optional	Optional	Optional	Not Allowed

Example

This request retrieves the delivery details of clientId of 2 and externalOrderId of 9202883732:

GET {baseURL}/deliveries?clientId=2&externalOrderId=9202883732

Response (200 OK):

{ "deliveries": { "clientId": "49304", "secondaryClientId": "2", "clientName": "XYZ Store", "secondaryClientName": "XYZ Store", "externalOrderId": "10208877499-208925547882099", "deliveryMethod": "SCHEDULED_DELIVERY", "orderPickupReadyTime": "2024-09-11T11:00:00Z", "orderPickupDueTime": "2024-09-12T00:00:00Z", "minDeliverySlotTime": "2024-09-11T11:00:00Z", "maxDeliverySlotTime": "2024-09-11T13:00:00Z", "requestedMinDeliverySlotTime": "2024-09-11T11:00:00Z", "requestedMaxDeliverySlotTime": "2024-09-11T13:00:00Z", "estimatedDeliveryPickupTime": "2024-09-11T10:45:00Z", "estimatedDeliveryTime": "2024-09-11T12:07:17Z", "status": "DELIVERED", "actualDeliveryPickupTime": "2024-09-11T11:28:36.646Z", "actualDeliveryTime": "2024-09-11T11:31:53.408Z", "createTime": "2025-10-29T22:11:42.827083763Z", "trackingURL": "https://deliverytracking.walmart.com/0017fcb6-9f7a-49bb-b23c-46d390712345", "customer": { "firstName": "John", "lastName": "Doe", "email": "[email protected]", "phone": { "countryCode": "1", "number": "(650) 8375000" }, "maskedPhone": { "countryCode": "1", "number": "(234) 5678901" } }, "communicationPreferences": { "customerNotifications": { "allowAll": true } }, "addOnServices": { "returnable": false, "attendedDelivery": false, "proofOfDelivery": true, "captureSignatureProof": false, "capturePhotoProof": true, "chainOfCustody": true, "isDropOffOTPRequired": false }, "pickupDetails": { "pickupPointId": "100681", "externalPickupPointId": "6315", "name": "XYZ Store", "address": { "line1": "1 W California Ave.", "line2": "Apt 10", "city": "Sunnyvale", "state": "CA", "zipCode": "94086", "countryCode": "US" }, "latLong": { "lat": 39.123456, "lng": -120.123456 }, "phone": { "countryCode": "1", "number": "4085551234" } }, "instructions": [ { "instructionText": "Ring bell when arriving", "instructionType": "CUSTOMER" } ], "deliveryDetails": { "address": { "line1": "853 W California Ave", "line2": "Apt 10", "city": "Sunnyvale", "state": "CA", "zipCode": "94086", "countryCode": "US" }, "latLong": { "type": "CUSTOMER_PINDROP", "lat": 37.12345, "lng": -122.12345 }, "propertyDetails": { "gateCode": "C-1278", "propertyType": "BUSINESS", "locationPreference": "BUILDING_RECEPTION" } }, "scanDetails": [ { "scanDetail": [ { "scanId": "W1321433777-1" } ], "scanType": "CODE128" } ], "associateScans": [ { "scanDetail": { "scanId": "21", "scanType": "CODE128" } }, { "scanCapturedAt": "UPDATE_REQUESTED", "scanSource": "CLIENT", "scanType": "CODE128", "scanDetail": [ { "scanId": "L-685337", "timeStamp": "2024-09-11T10:58:46.417044167Z" }, { "scanCapturedAt": "ENROUTE_TO_DROPOFF", "scanSource": "DRIVER", "scanType": "CODE128", "scanDetail": [ { "scanId": "L-685337", "timeStamp": "2024-09-11T11:05:12.631Z", "latLong": { "lat": 38.123456, "lng": -92.123456 } } ] }, { "scanCapturedAt": "DELIVERED", "scanSource": "DRIVER", "scanType": "CODE128", "scanDetail": [ { "scanId": "L-685337", "timeStamp": "2024-09-11T11:28:55.087Z", "latLong": { "lat": 39.123456, "lng": -80.123456 } } ] } ] } ], "orderManifest": { "summary": { "totalItems": 1, "orderSize": "S", "dimensions": [ { "length": 15.69, "width": 8.69, "height": 4.63, "unitOfMeasure": "IN" } ], "totalOrderWeight": { "unitOfMeasure": "LB", "measurementValue": 1.2 }, "totalValueOfItems": { "currencyAmount": 36.45, "currencyUnit": "USD" }, "specialHandlingAttributes": { "hasHazmatItems": false, "hasAlcoholItems": false, "hasColdchainItems": false, "hasFragileItems": false, "hasPharmacyItems": false } }, "itemDetails": [ { "quantity": 1, "itemId": "990360697", "itemDescription": "Widget", "itemWeight": { "unitOfMeasure": "LB", "measurementValue": 2.2 }, "dimensions": [ { "length": 15.69, "width": 8.69, "height": 4.63, "unitOfMeasure": "IN" } ] } ] }, "dispatcherDetails": { "firstName": "John", "lastName": "Doe", "phone": { "countryCode": "1", "number": "4085551234" }, "maskedPhone": { "countryCode": "1", "number": "(650) 8375000" }, "vehicle": { "color": "Red", "make": "Ford", "model": "Taurus" }, "parking": { "bay": "4" } }, "externalRef": { "batchingDetails": { "batchId": "bca845c9-2072-4ab8-a80c-c0b48bfcf533", "routeId": "20240911-100681-0743", "dropSequence": "1", "count": "2" } }, "proofOfDelivery": { "proofType": "DELIVERY_PHOTO", "proofUrl": "http://images.delivery.walmart.com/d27f3bd1-68ae-4da6-9799-91674f370a42.jpeg", "mimeType": "image/jpeg" }, "deliveryPriority": "REGULAR", "isTestDelivery": false, "specialInstructions": {}, "otpDetails": { "pickupOTP": "W12286" }, "deliveryId": "0017fcb6-9f7a-49bb-b23c-46d390712345" }
}