Get Simplified Shipping Settings (Deprecated)
Deprecation notice: We heard your feedback and are making Simplified Shipping Settings (SSS) more flexible, giving you the ability to rate shop across carrier services. As we prepare for this launch, the current SSS v1 APIs are temporarily deprecated. API support will be restored with the upcoming release on August 31st. In the meantime, you can continue to manage your Simplified Shipping Settings through the Seller Center UI.
Use this API to override configurations for one or more fulfillment centers.
Overview
The Get Simplified Shipping Settings API helps sellers and approved solution providers retrieve Simplified Shipping Settings configurations, including the default setup and any custom configurations. This API provides full visibility into active carrier methods, regional coverage, and shipping charges, enabling partners to validate setup, ensure alignment with business rules, and power downstream integrations. The Get Simplified Shipping Settings API serves as a reliable source of truth for understanding how delivery promises are being generated under Simplified Shipping Settings.
Functionality
The Get Simplified Shipping Settings API returns the following shipping configurations for Simplified Shipping Settings:
- Account-level shipping settings
- Fulfillment center overrides (if any)
- Carrier and service configurations
- Geographic coverage (regions, subregions, states)
- Address types (for example,
STREET, PO_BOX,MILITARY) - Shipping charge models (per shipment, per weight, per item)
- Shipping priority and migration flags
Endpoint
GET <https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings>Sample request
curl --request GET \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings \ --header 'accept: application/json'Modify your code
- Replace
<YourAccessToken>with yourWM_SEC.ACCESS_TOKEN. - Supply a new
GUID for WM_QOS.CORRELATION_ID.
200- Sample response
{ "simplifiedShippingSettings": { "accountConfigs": { "shippingPriority": "FASTEST", "migrateFreeShippingOffers": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 2, "currency": "USD" }, "chargePerWeight": { "amount": 5, "currency": "USD" } } } } ] } ] }, "shipNodeConfigs": [ { "shipNodes": [ "884069491409248257" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] }, { "shipNodes": [ "10011355840", "856191970194255873", "883645272636612609", "10011340", "738626175162052609", "738624394650644481", "738625470982942721" ], "isOverridden": false }, { "shipNodes": [ "832541431719002113" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] } ] } ] }
}200 – Sample response settings not present
{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "simplifiedShippingSettings", "description": "Simplified Shipping Settings not found for given partnerPk", "info": "Simplified Shipping Settings not found for given partnerPk", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}Result
A successful call returns a HTTP 200 OK status and shows the following:
- Your account-level rule (
accountConfigs). - Any fulfillment-center overrides (
shipNodeConfigs).
Next step
Pull a new order with GET https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}.
Updated 14 days ago