An order
Market availability: US | CA | CL
Call this endpoint to retrieve detailed information about a specific order. You can view the order's items, customer details, and current status. For example, you might query a single order to troubleshoot a fulfillment issue or confirm specific line item quantities.
Note: This page describes an example using only the required parameters and inputs for getting an order. For a full list of customization options and additional capabilities, refer to the Walmart Orders API Reference.
Endpoint
GET https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}Function
Use this API to provide shipment details such as:
- Order line number
- Shipment status
- Shipped quantity
- Carrier name
- Shipping method
- Tracking number
- Tracking URL
- Ship date and time
- Return center address, when applicable
Sample request
curl --request POST \ --url https://marketplace.walmartapis.com/v3/orders/purchaseOrderId/shipping \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "orderShipment": { "processMode": "string", "orderLines": { "orderLine": [ { "lineNumber": "string", "shipFromCountry": "CA", "intentToCancelOverride": "string", "sellerOrderId": "string", "sellerOrderNo": "string", "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "asn": { "packageASN": "string", "palletASN": "string" }, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "trackingInfo": { "shipDateTime": "2026-09-22T20:13:07.650Z", "carrierName": { "otherCarrier": "string", "carrier": "string" }, "methodCode": "string", "trackingNumber": "string", "trackingURL": "string", "packageStatus": "string", "shipmentNo": "string", "actualDeliveryDateTime": "2026-09-22T20:13:07.650Z" }, "returnCenterAddress": { "name": "string", "address1": "string", "address2": "string", "city": "string", "state": "string", "postalCode": "string", "country": "string", "dayPhone": "string", "emailId": "string" }, "currentTrackingInfo": { "trackingNumber": "string" } } ] } } ] }, "shipments": [ { "shipmentLines": [ { "primeLineNo": "string", "shipmentLineNo": "string", "quantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "shipFromCountry": "MX" } ], "carrier": "string", "trackingNumber": "string", "trackingURL": "string" } ] }
}
'Modify your code
Include Walmart authentication headers
Sample responses
application/json
200 Sample 1 - US
{ "order": { "purchaseOrderId": "129102916237229", "customerOrderId": "100001181176622", "customerEmailId": "[email protected]", "orderDate": 1769624177756, "shippingInfo": { "phone": "5103295632", "estimatedDeliveryDate": 1770235200000, "estimatedShipDate": 1769749200000, "methodCode": "Standard", "postalAddress": { "name": "Test buynow", "address1": "2476 Barlow Ave", "address2": null, "city": "San Jose", "state": "CA", "postalCode": "95122", "country": "USA", "addressType": "RESIDENTIAL" }, "carrierMethodName": null }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "Woodland Scenics MG759 Model Graphics Stripes Black Dry Transfer Decals", "sku": "00967044927635SKU", "condition": "New" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 20 }, "tax": null, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "USD", "amount": 1 }, "tax": null, "isDiscount": null, "discountType": null }, { "chargeType": "FEE", "chargeName": "Fee", "chargeAmount": { "currency": "USD", "amount": 0 }, "tax": { "taxName": "Prepaid MTS Surcharge 911, Prepaid MTS Surcharge 988, Prepaid MTS Surcharge Local", "taxAmount": { "currency": "USD", "amount": 1.82 } }, "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "statusDate": 1769668173000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1769668173000, "carrierName": { "otherCarrier": null, "carrier": "FedEx" }, "methodCode": "Standard", "carrierMethodCode": null, "trackingNumber": "101323906104", "trackingURL": "https://example.com/track?number=794644792798", "packageStatus": null, "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "DELIVERY", "shipMethod": "STANDARD", "storeId": null, "pickUpDateTime": 1769976000000, "pickUpBy": null, "shippingProgramType": "THREE_TO_FIVE_DAY", "shippingSLA": "3", "shippingConfigSource": "SELLER", "predictedShipNodeName": null } } ] }, "shipNode": { "type": "SellerFulfilled", "name": "lmpshipchecktemplate", "id": "758636536954859521" } }
}
200 Sample 2 - MX
{ "order": { "purchaseOrderId": "609005296419679", "customerOrderId": "900000030239877", "customerEmailId": "[email protected]", "orderDate": 1740044217202, "shippingInfo": { "phone": "4086073423", "estimatedDeliveryDate": 1740772800000, "estimatedShipDate": 1740775800000, "postalAddress": { "name": "Jane Smith", "address1": "La Calma", "address2": "100", "address3": "PERIODISTA", "address4": "MIGUEL HIDALGO", "city": "CIUDAD DE MEXICO", "state": "DISTRITO FEDERAL", "postalCode": "11220", "country": "MX", "addressType": null }, "carrierMethodName": null }, "totalLines": "1", "totalQuantity": "2", "orderLines": { "orderLine": [ { "primeLineNumber": "1", "coLineNumber": "1", "item": { "upc": "00718802140481", "offerId": "570A6DB4E9AC33A5AFF318EBF08ACD88", "productName": "E2EAuto_07188021404816AccElectronics", "sku": "SKU-07188021404816", "condition": "New", "imageUrl": "https://example.com/images/mock-product-image.jpg", "unitPrice": { "currency": "MXN", "amount": 18 }, "unitPriceWithoutTax": { "currency": "MXN", "amount": 15.52 } }, "charges": { "charge": [ { "chargeType": "SHIPPING", "chargeAmount": { "currency": "MXN", "amount": 3.44 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "MXN", "amount": 0.56 } }, "taxDetails": [ { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "MXN", "amount": 0.56 } } ], "isDiscount": null, "discountType": null }, { "chargeType": "PRODUCT", "chargeAmount": { "currency": "MXN", "amount": 31.04 }, "tax": { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 4.96 } }, "taxDetails": [ { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 4.96 } } ], "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": null, "trackingInfo": null, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "shippingMethod": "STANDARD", "soPrimeLineSubLineNo": "900000030239877-1-1", "promiseDeliveryDate": "2025-02-28T20:00:00.000+0000", "isMSIEnabled": "N", "seller": { "id": "10000012345", "name": "Sample Marketplace Account", "shipNodeType": "SellerFulfilled" }, "isWFSEnabled": "N", "fulfillmentType": "S2H" } ] }, "shipments": [ { "shipmentLines": [ { "primeLineNo": "1", "shipmentLineNo": "1", "quantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "shipFromCountry": "MX" } ], "shipmentNo": "245e287c-571f-47fb-a9b9-81735b018abb", "status": "Shipped", "packageNo": "245e287c-571f-47fb-a9b9-81735b018abb", "isSellerOwnedShipment": "Y", "carrier": "MX-FDX-GROUND2 Sun", "trackingNumber": "987465364732", "shipmentAdditionalDate": { "expectedShipmentShippedDate": "2025-02-22T10:27:53.000+0000", "shipmentShippedDate": "2025-02-20T10:27:50.000+0000" }, "trackingURL": "https://example.com/track?number=794644792798" } ], "orderTotal": { "currency": "MXN", "amount": 40 } }
}{ "order": { "purchaseOrderId": "1796277083022", "customerOrderId": "5281956426648", "customerEmailId": "[email protected]", "orderType": "REPLACEMENT", "originalCustomerOrderID": "1234567891234", "orderDate": 1568466571000, "shippingInfo": { "phone": "3155598681", "estimatedDeliveryDate": 1569438000000, "estimatedShipDate": 1568700000000, "methodCode": "Value", "postalAddress": { "name": "Kathryn Cole", "address1": "3258BWarners rd", "address2": "Garage", "city": "Warners", "state": "NY", "postalCode": "13164", "country": "USA", "addressType": "RESIDENTIAL" } }, "orderLines": { "orderLine": [ { "lineNumber": "4", "item": { "productName": "Beba Bean Pee-pee Teepee Airplane - Blue - Laundry Bag", "sku": "test1" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 10 }, "tax": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 0.8 } }, "taxAndOtherFees": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 0.8 } } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "statusDate": 1568466647000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Created", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": "xyz", "trackingInfo": { "shipDateTime": 1241715945678, "carrierName": { "otherCarrier": "xyz", "carrier": "FED_EX" }, "methodCode": "Standard", "carrierMethodCode": 19, "trackingNumber": "001792410114462199", "trackingURL": "http://www.fedex.com/Tracking?action=track=english=us=x=001792410114462199" }, "returnCenterAddress": { "name": "xyz", "address1": "xyz", "address2": "xyz", "city": "Sunnyvale", "state": "CA", "postalCode": "123", "country": "CA", "dayPhone": "9999999", "emailId": "[email protected]" } } ] }, "refund": { "refundId": "123", "refundComments": "xyz", "refundCharges": { "refundCharge": [ { "refundReason": "INCORRECT_ITEM_RECEIVED", "charge": { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 798 }, "tax": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 798 } }, "taxAndOtherFees": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 798 } } } } ] } }, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "VALUE", "storeId": "xyz", "pickUpDateTime": 1568919600000, "pickUpBy": "xyz", "shippingProgramType": "THREE_TO_FIVE_DAY" } } ] }, "shipNode": { "type": "3PLFulfilled", "name": "xyz", "id": "123" } }
}200 Sample 3 - CA
{ "order": { "purchaseOrderId": "309006997003225", "customerOrderId": "701741532133507", "customerEmailId": "[email protected]", "orderDate": 1741532134508, "shippingInfo": { "phone": "6657555657", "estimatedDeliveryDate": 1742065200000, "estimatedShipDate": 1741672800000, "methodCode": "Standard", "postalAddress": { "name": "geetha kunchepu", "address1": "3354 Innes Road", "address2": null, "city": "Ottawa", "state": "ON", "postalCode": "K1C 1T1", "country": "CA", "addressType": "RESIDENTIAL" }, "carrierMethodName": null }, "orderLines": { "orderLine": [ { "lineNumber": "1", "shipFromCountry": "CA", "item": { "productName": "ANIMALPEDIGREEtwo", "sku": "EDF07661449630550" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CAD", "amount": 401 }, "tax": { "taxName": "HST", "taxAmount": { "currency": "CAD", "amount": 52.13 } }, "isDiscount": false, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "SHIPPING", "chargeAmount": { "currency": "CAD", "amount": 2.5 }, "tax": { "taxName": "QST", "taxAmount": { "currency": "CAD", "amount": 0.38 } }, "isDiscount": false, "discountType": null }, { "chargeType": "PRODUCT", "chargeName": "ITEM_PRICE_AFTER_DISCOUNT", "chargeAmount": { "currency": "CAD", "amount": 401 }, "tax": { "taxAmount": { "currency": "CAD", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CAD", "amount": 52.13 }, "tax": { "taxAmount": { "currency": "CAD", "amount": 0 } }, "isDiscount": false, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1741811861000, "carrierName": { "otherCarrier": null, "carrier": "LETTERMAIL" }, "methodCode": "Standard", "carrierMethodCode": null, "trackingURL": null, "packageStatus": "Shipped", "shipmentNo": "fc5122b4-5ca0-4032-9b35-e5f7696950e8", "actualDeliveryDateTime": 16725225600000 }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "STANDARD", "storeId": null, "offerId": "46067EC8F029354ABC1668C9AFCCD106", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10011361291", "predictedShipNodeName": "seller.onboarding.test.ad.2008 - 10011361291 - MP" } } ] } }
}{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.GMP_ORDER_API", "description": "Invalid request content.", "info": "Request content is not valid.", "severity": "ERROR", "category": "DATA" } ]
}200 Sample 4 - CL
{ "order": { "purchaseOrderId": "P100650592", "customerOrderId": "2582530000022", "isWCPOrder": true, "orderDate": 1740683830000, "shippingInfo": { "phone": "+56567657687", "estimatedDeliveryDate": 1741215600000, "estimatedShipDate": 1740722400000, "methodCode": "STANDARD", "postalAddress": { "name": "user chile", "address1": "Rosario Sur", "address2": "615", "city": "Las Condes", "state": "Región Metropolitana", "country": "CL", "addressType": null }, "carrierMethodName": null }, "orderSummary": { "totalAmount": { "amount": 268143.5, "currency": "CLP" }, "orderSubTotal": [ { "subTotalType": "SHIPPING", "totalAmount": { "amount": 2504, "currency": "CLP" } }, { "subTotalType": "TAX", "totalAmount": { "amount": 8500.5, "currency": "CLP" } }, { "subTotalType": "PRODUCT", "totalAmount": { "amount": 257139, "currency": "CLP" } }, { "subTotalType": "DISCOUNT", "totalAmount": { "amount": 0, "currency": "CLP" } } ] }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "Category Translation ByGTIN", "sku": "S23053108130613" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CLP", "amount": 114284 }, "tax": { "taxName": "IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 14477.32 } }, "isDiscount": null, "discountType": null }, { "chargeType": "COMMISSION", "chargeName": "Commission", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "CLP", "amount": 5008 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 634.68 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CLP", "amount": 15112 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "DISCOUNT", "chargeName": "DISCOUNT", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "4" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Acknowledged", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "4" }, "cancellationReason": null, "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingURL": null, "packageStatus": null, "shipmentNo": "778510292_1", "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null }, { "status": "Cancelled", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": "", "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingURL": null, "packageStatus": null, "shipmentNo": null, "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "Seller", "shipMethod": "STANDARD", "storeId": "10900069993", "offerId": "5BCA7D78D4F035C6844D032D81FECA08", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10900069993", "predictedShipNodeName": "TestWFS_Sept1" } }, { "lineNumber": "2", "item": { "productName": "Bicicleta Guayacan Aro 27.5 Negro/Amarillo 2", "sku": "SKU98764786095340" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CLP", "amount": 17639 }, "tax": { "taxName": "IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 3351 } }, "isDiscount": null, "discountType": null }, { "chargeType": "COMMISSION", "chargeName": "Commission", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CLP", "amount": 3351 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "DISCOUNT", "chargeName": "DISCOUNT", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "5" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Acknowledged", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "5" }, "cancellationReason": null, "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingURL": null, "packageStatus": null, "shipmentNo": "779510292_1", "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null }, { "status": "Cancelled", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": "", "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingURL": null, "packageStatus": null, "shipmentNo": null, "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "Seller", "shipMethod": "STANDARD", "storeId": "10900069993", "offerId": "C101C8B5182632CDA23B42E15C2B845E", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10900069993", "predictedShipNodeName": "TestWFS_Sept1" } } ] } }
}400
{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.GMP_ORDER_API", "description": "Invalid request content.", "info": "Request content is not valid.", "severity": "ERROR", "category": "DATA" } ]
}401
{ "errors": [ { "code": "UNAUTHORIZED.GMP_ORDER_API", "description": "Unauthorized request.", "info": "Authentication failed. Verify your credentials.", "severity": "ERROR", "category": "APPLICATION" } ]
}403
{ "errors": [ { "code": "FORBIDDEN.GMP_ORDER_API", "description": "Access denied.", "info": "You do not have permission to perform this action.", "severity": "ERROR", "category": "APPLICATION" } ]
}404
{ "errors": [ { "code": "NOT_FOUND.GMP_ORDER_API", "description": "Resource not found.", "info": "The requested purchase order was not found.", "severity": "ERROR", "category": "DATA" } ]
}429
{ "code": "REQUEST_THRESHOLD_VIOLATED", "description": "Too many requests in a given amount of time.", "info": "You have exceeded the rate limit for this API. Retry after the time indicated in the Retry-After header.", "severity": "ERROR", "category": "SYSTEM", "causes": [], "errorIdentifiers": {}, "field": "RateLimitExceeded"
}500
{ "errors": [ { "code": "INTERNAL_SERVER_ERROR.GMP_ORDER_API", "description": "An internal server error occurred.", "info": "Retry the request. If the issue persists, contact support.", "severity": "ERROR", "category": "SYSTEM" } ]
}application/problem+json
400 - SWW Label Failed — Hazmat Item Ineligible For USPS Priority Mail (Non- Retryable, LS-1010)
{ "type": "https://developer.walmart.com/errors/sww-label-failure", "title": "SWW label creation failed", "status": 400, "detail": "Your shipment contains dangerous goods or hazardous material that cannot be shipped with priority services. Select another service to ship this order, or submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}400 - SWW Label Failed - OOC Enrolled Seller Missing Required Fields (Non-Retryable, LH-4022)
{ "type": "https://developer.walmart.com/errors/sww-label-failure", "title": "SWW label creation failed", "status": 400, "detail": "A Ship With Walmart label cannot be generated for this shipment. The seller is enrolled in Out Of Country (Cross Border Trade) but required fields (Harmonized System code, country of origin, or product URL) are missing or are invalid. Correct the order details or submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}500 - SWW Label Failed - Carrier API Failure For This Cross Border Trade Order (Retryable, LS-3101)
{ "type": "https://developer.walmart.com/errors/sww-label-failure/retryable", "title": "SWW label creation failed — Retryable", "status": 500, "detail": "SWW label cannot be generated for this Cross Border Trade order due to a carrier API failure. This error may be transient so try again. If the error persists, submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}500 - SWW Label Failed - The Shipment Is Ineligible For The Cross Border Trade Carrier Label (Non-Retryable, LS-3101)
{ "type": "https://developer.walmart.com/errors/sww-label-failure/non-retryable", "title": "SWW label creation failed — Non-Retryable", "status": 500, "detail": "SWW label cannot be generated for this Cross Border Trade enrolled order. Eligible reasons: carrier ineligibility, hazmat restrictions, or shipment dimensions exceeding carrier limits. Submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}
Result
A successful 200 response confirms that the shipment update was accepted and the order was updated.
In Sample 1-US, order line 1 is returned with status shipped. The shipped quantity is 2, the unit of measurement is EACH, the carrier is FedEx, the method code is Standard, and the response includes a tracking number and tracking URL. The response also includes the seller-fulfilled ship node.
In Sample 2-MX, the response shows a Mexico order with total lines and total quantity. The order line status is Shipped, and the shipments array includes the shipment number, package number, carrier, tracking number, shipped dates, and tracking URL. The response also includes order total information in MXN.
In Sample 3-CA, the response shows a Canada order with shipFromCountry set to CA. The order line status is Shipped, the shipped quantity is 1, and tracking information includes the carrier, package status, shipment number, and actual delivery date time. The response includes charge and tax details in CAD.
In Sample 4-CL, the response shows a Chile order with two order lines. Each order line includes a Shipped status and a Cancelled status. The shipped statuses include tracking numbers, tracking URLs, and shipment numbers. The cancelled statuses include PRICE_ERROR as the cancellation reason. The response includes order summary amounts in CLP.
For error responses, use the status code and error body to determine the next action:
- 400: The request body is invalid. Review the shipment request content and confirm that required fields, formats, and values are correct.
- 401: Authentication failed. Verify the credentials and authorization headers used by your integration.
- 403: Access is denied. Confirm that the seller account has permission to ship the order.
- 404: The purchase order was not found. Confirm that the purchase order ID in the endpoint path is correct.
- 429: The request exceeded the API rate limit. Retry after the time indicated in the Retry-After header.
- 500: A system error occurred. Retry the request. If the issue continues, contact support.
Next Steps
- Add the
purchaseOrderIdto the request path. - Include the required Walmart authentication headers.
- Parse the returned
orderobject into your OMS screens or downstream workflow. - Use
orderLineStatusesandtrackingInfoto determine shipment progress. - Handle regional currency and address differences in your application logic.
- Add error handling for invalid requests, authentication failures, missing orders, rate limiting, or server errors.
Updated about 1 month ago

