---
updatedAt: 2026-08-04T19:13:51.000Z
---
# Get Simplified Shipping Settings (Deprecated)
This API helps seller to fetch the Simplified Shipping Settings for a seller account and FC level configurations.
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.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Simplified Shipping Settings Management",
"version": "1.0",
"description": "The Simplified Shipping Settings APIs allow sellers to manage all the simplified shipping configuration for better shipping and delivery promise experience. 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"
},
"x-readme": {
"samples-languages": [
"shell"
],
"proxy-enabled": false
},
"servers": [
{
"url": "https://marketplace.walmartapis.com",
"description": "Refers to the URL used for accessing the production server."
},
{
"url": "https://sandbox.walmartapis.com",
"description": "Refers to the URL used for accessing the sandbox server."
}
],
"paths": {
"/v3/settings/shipping/simplifiedshippingsettings": {
"get": {
"tags": [
"Simplified Shipping Settings"
],
"summary": "Get Simplified Shipping Settings (Deprecated)",
"description": "This API helps seller to fetch the Simplified Shipping Settings for a seller account and FC level configurations.\n\nDeprecation 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.
",
"operationId": "getSimplifiedShippingSettings",
"deprecated": true,
"parameters": [
{
"in": "header",
"name": "Authorization",
"description": "Use a Basic Authorization header by Base64-encoding the Client ID and Client Secret obtained in step two of the integration process. Format the credentials as ClientID:ClientSecret before encoding.",
"required": true,
"schema": {
"type": "string"
},
"example": "Basic YzcyOTFjNmItNzI5MC00...."
},
{
"in": "header",
"name": "WM_SEC.ACCESS_TOKEN",
"description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.",
"required": true,
"schema": {
"type": "string"
},
"example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
},
{
"in": "header",
"name": "WM_CONSUMER.CHANNEL.TYPE",
"description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "WM_QOS.CORRELATION_ID",
"description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.",
"required": true,
"schema": {
"type": "string"
},
"example": "b3261d2d-028a-4ef7-8602-633c23200af6"
},
{
"in": "header",
"name": "WM_SVC.NAME",
"description": "Specifies the name of the Walmart service being called.",
"required": true,
"schema": {
"type": "string"
},
"example": "Walmart Marketplace"
}
],
"responses": {
"200": {
"description": "Successful operation",
"headers": {
"Sunset": {
"description": "Indicates the date this API version will be shut down. Consumers must migrate to v2 before this date.",
"schema": {
"type": "string",
"example": "Sat, 27 Mar 2027 00:00:00 GMT"
}
},
"Deprecation": {
"description": "Indicates the API has entered deprecation.",
"schema": {
"type": "string",
"example": "true"
}
}
},
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"simplifiedShippingSettings": {
"type": "object",
"properties": {
"accountConfigs": {
"type": "object",
"properties": {
"shippingPriority": {
"type": "string",
"description": "Shipping priority will help system decide the carrier service for fulfillment in case there are multiple shipping options available for customers with different carrier services in terms of shipping cost and speed.",
"enum": [
"SLOWEST",
"FASTEST"
]
},
"migrateEligibleOffers": {
"type": "boolean",
"description": "Flag used to migrate/not migrate all the eligible offers for a seller."
},
"carrierConfigs": {
"uniqueItems": true,
"type": "array",
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage. ",
"items": {
"type": "object",
"properties": {
"configurations": {
"uniqueItems": true,
"type": "array",
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage.",
"items": {
"type": "object",
"properties": {
"regions": {
"uniqueItems": true,
"type": "array",
"description": "Region configurations specifying shipping coverage by carrier.",
"items": {
"type": "object",
"properties": {
"regionCode": {
"type": "string",
"description": "Region code for covered shipping.",
"enum": [
"C",
"H",
"P",
"A"
]
},
"regionName": {
"type": "string",
"description": "Region name for covered shipping.",
"enum": [
"48 State",
"AK and HI",
"US Protectorates",
"APO/FPO"
]
},
"subRegions": {
"uniqueItems": true,
"type": "array",
"description": "Sub-region configurations covered by this carrier.",
"items": {
"type": "object",
"properties": {
"subRegionCode": {
"type": "string",
"description": "Sub-Region code for covered shipping."
},
"subRegionName": {
"type": "string",
"description": "Sub-Region name for covered shipping."
},
"states": {
"uniqueItems": true,
"type": "array",
"description": "States covered in this sub-region for shipping.",
"items": {
"type": "object",
"properties": {
"stateCode": {
"type": "string",
"description": "State code or covered shipping."
},
"stateName": {
"type": "string",
"description": "State name for covered shipping."
}
},
"description": "States covered in this sub-region for shipping."
}
}
},
"description": "Sub-region configurations covered by this carrier."
}
}
},
"description": "Region configurations specifying shipping coverage by carrier."
}
},
"addressTypes": {
"uniqueItems": true,
"type": "array",
"description": "The address types eligible for shipping within the specified region, sub-region, and states.",
"items": {
"type": "string",
"description": "The address types eligible for shipping within the specified region, sub-region, and states.",
"enum": [
"PO_BOX",
"MILITARY",
"STREET"
]
}
},
"shippingCharge": {
"uniqueItems": true,
"type": "array",
"description": "Shipping charge to be applied for the given carrier service and region.",
"items": {
"type": "object",
"properties": {
"rateModelType": {
"type": "string",
"description": "Type of shipping rate model. PER_SHIPMENT_PRICING: Charges based on item weight (per pound) or quantity per order.",
"enum": [
"PER_SHIPMENT_PRICING"
]
},
"perShippingCharge": {
"required": [
"unitOfMeasure"
],
"type": "object",
"properties": {
"unitOfMeasure": {
"type": "string",
"description": "Unit of measure for shipping charges (For example, LB)."
},
"shippingAndHandling": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Shipping and handling charge amount."
},
"currency": {
"type": "string",
"description": "The type of currency for the charge. Example: USD for US Dollars",
"enum": [
"USD"
]
}
},
"description": "Shipping and Handling Charge"
},
"chargePerWeight": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Charge Per weight, value USD"
},
"currency": {
"type": "string",
"description": "Currency, eg. USD",
"enum": [
"USD"
]
}
},
"description": "Shipping charge per unit weight (amount and currency)."
},
"chargePerItem": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Charge amount per item."
},
"currency": {
"type": "string",
"description": "Currency, eg. USD",
"enum": [
"USD"
]
}
},
"description": "Shipping charge per item."
}
},
"description": "Charge per shipping"
}
},
"description": "Contains an array of Regions, an array of Address Type, Transit Time and Per shipping charge"
}
}
},
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage."
}
},
"carriers": {
"uniqueItems": true,
"type": "array",
"description": "Carrier configurations to use for shipping. Like carrier name and carrier service.",
"items": {
"type": "object",
"properties": {
"carrierName": {
"type": "string",
"description": "Name of the carrier to use for shipping.",
"enum": [
"Fedex",
"UPS",
"USPS"
]
},
"carrierService": {
"type": "string",
"description": "Service name of the carrier to use for shipping",
"enum": [
"UPS_NEXTDAY_AIR",
"USPS_PRIORITY_MAIL",
"USPS_PRIORITY_MAIL_EXPRESS",
"FEDEX_HOME_DELIVERY",
"UPS_2DAY_AIR",
"FEDEX_OVERNIGHT",
"FEDEX_GROUND_ECONOMY",
"FEDEX_EXPRESS",
"FEDEX_2DAY_EXPRESS",
"UPS_3DAY_SELECT",
"UPS_GROUND",
"UPS_SUREPOST",
"USPS_GROUND"
]
}
},
"description": "Carrier configurations to use for shipping. Like carrier name and carrier service."
}
}
},
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage. "
}
}
},
"description": "Account configuration to be set for a seller, comprising of Carrier configurations and Region configurations."
},
"shipNodeConfigs": {
"uniqueItems": true,
"type": "array",
"description": "List of all fulfillment center IDs and their configurations.",
"items": {
"type": "object",
"properties": {
"shipNodes": {
"uniqueItems": true,
"type": "array",
"description": "Array of Fulfillment Center IDs designated as shipping nodes.",
"items": {
"type": "string",
"description": "Fulfillment Center ID used as a shipping node."
}
},
"isOverridden": {
"type": "boolean",
"description": "Indicates whether the Fulfillment Center configuration settings override the account-level settings."
},
"carrierConfigs": {
"uniqueItems": true,
"type": "array",
"description": "Array of Fulfillment Center IDs designated as shipping nodes.",
"items": {
"type": "object",
"properties": {
"configurations": {
"uniqueItems": true,
"type": "array",
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage.",
"items": {
"type": "object",
"properties": {
"regions": {
"uniqueItems": true,
"type": "array",
"description": "Region configurations specifying shipping coverage by carrier.",
"items": {
"type": "object",
"properties": {
"regionCode": {
"type": "string",
"description": "Region code for covered shipping.",
"enum": [
"C",
"H",
"P",
"A"
]
},
"regionName": {
"type": "string",
"description": "Region name for covered shipping.",
"enum": [
"48 State",
"AK and HI",
"US Protectorates",
"APO/FPO"
]
},
"subRegions": {
"uniqueItems": true,
"type": "array",
"description": "Sub-region configurations covered by this carrier.",
"items": {
"type": "object",
"properties": {
"subRegionCode": {
"type": "string",
"description": "Sub-Region code for covered shipping."
},
"subRegionName": {
"type": "string",
"description": "Sub-Region name for covered shipping."
},
"states": {
"uniqueItems": true,
"type": "array",
"description": "States covered in this sub-region for shipping.",
"items": {
"type": "object",
"properties": {
"stateCode": {
"type": "string",
"description": "State code or covered shipping."
},
"stateName": {
"type": "string",
"description": "State name for covered shipping."
}
},
"description": "States covered in this sub-region for shipping."
}
}
},
"description": "Sub-region configurations covered by this carrier."
}
}
},
"description": "Region configurations specifying shipping coverage by carrier."
}
},
"addressTypes": {
"uniqueItems": true,
"type": "array",
"description": "The address types eligible for shipping within the specified region, sub-region, and states.",
"items": {
"type": "string",
"description": "The address types eligible for shipping within the specified region, sub-region, and states.",
"enum": [
"PO_BOX",
"MILITARY",
"STREET"
]
}
},
"shippingCharge": {
"uniqueItems": true,
"type": "array",
"description": "Shipping charge to be applied for the given carrier service and region.",
"items": {
"type": "object",
"properties": {
"rateModelType": {
"type": "string",
"description": "This is the shipping model type. PER_SHIPMENT_PRICING: This model means that you charge shipping based on the weight of your items (per pound), or you charge shipping based on the number of items purchased in an order",
"enum": [
"PER_SHIPMENT_PRICING"
]
},
"perShippingCharge": {
"required": [
"unitOfMeasure"
],
"type": "object",
"properties": {
"unitOfMeasure": {
"type": "string",
"description": "Unit of measure for shipping charges (For example, LB)."
},
"shippingAndHandling": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Shipping and handling charge amount."
},
"currency": {
"type": "string",
"description": "The type of currency for the charge. Example: USD for US Dollars",
"enum": [
"USD"
]
}
},
"description": "Shipping and Handling Charge"
},
"chargePerWeight": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Charge Per weight, value USD"
},
"currency": {
"type": "string",
"description": "Currency, eg. USD",
"enum": [
"USD"
]
}
},
"description": "Shipping charge per unit weight (amount and currency)."
},
"chargePerItem": {
"required": [
"amount",
"currency"
],
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Charge amount per item."
},
"currency": {
"type": "string",
"description": "Currency, eg. USD",
"enum": [
"USD"
]
}
},
"description": "Shipping charge per item."
}
},
"description": "Charge per shipping"
}
},
"description": "Contains an array of Regions, an array of Address Type, Transit Time and Per shipping charge"
}
}
},
"description": "Carrier configurations to use for shipping, including carrier details and corresponding region coverage."
}
},
"carriers": {
"uniqueItems": true,
"type": "array",
"description": "Carrier configurations to use for shipping. Like carrier name and carrier service.",
"items": {
"type": "object",
"properties": {
"carrierName": {
"type": "string",
"description": "Name of the carrier to use for shipping.",
"enum": [
"Fedex",
"UPS",
"USPS"
]
},
"carrierService": {
"type": "string",
"description": "Service name of the carrier to use for shipping",
"enum": [
"UPS_NEXTDAY_AIR",
"USPS_PRIORITY_MAIL",
"USPS_PRIORITY_MAIL_EXPRESS",
"FEDEX_HOME_DELIVERY",
"UPS_2DAY_AIR",
"FEDEX_OVERNIGHT",
"FEDEX_GROUND_ECONOMY",
"FEDEX_EXPRESS",
"FEDEX_2DAY_EXPRESS",
"UPS_3DAY_SELECT",
"UPS_GROUND",
"UPS_SUREPOST",
"USPS_GROUND"
]
}
},
"description": "Carrier configurations to use for shipping. Like carrier name and carrier service."
}
}
},
"description": "Array of Fulfillment Center IDs designated as shipping nodes."
}
}
},
"description": "List of all fulfillment center IDs and their configurations."
}
}
},
"description": "Simplified Shipping Settings"
}
}
}
},
"examples": {
"Sample Response": {
"value": {
"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"
}
}
}
}
]
}
]
}
]
}
}
},
"Sample - Settings Not Present": {
"value": {
"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": {}
}
]
}
}
}
}
}
}
}
}
}
}
}
```