Guides
My Account

Get Simplified Shipping Settings

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 your WM_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 12 days ago