Get shipping template details
Overview
The Get Shipping Template Details API gives you specific shipping configurations for a single shipping template.
Endpoint
GET <https://marketplace.walmartapis.com/v3/settings/shipping/templates/{templateId}> Function
This API helps you:
- View full shipping template settings
- Inspect shipping methods and rate models
- Review geographic coverage (such as regions, subregions, states)
- Validate the international template settings
- Confirm fulfillment center associations (for fulfillments centers outside of the U.S.)
- Audit tiered and per-shipment pricing information
- Review creation and modification timestamps
Sample request
{ "id": "2025071999000032275", "name": "Custom Ground Shipping", "type": "CUSTOM", "rateModelType": "PER_SHIPMENT_PRICING", "status": "ACTIVE", "createdDate": 1748275227413, "modifiedDate": 1748275227413, "shippingMethods": [ { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "subRegionName": "Northeast", "states": [ { "stateCode": "PA", "stateName": "Pennsylvania", "stateSubregions": [ { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" } ] }, { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_METRO" } ] } ] }, { "subRegionCode": "SE", "subRegionName": "Southeast", "states": [ { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "GA", "stateName": "Georgia" } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 5, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 4.99, "currency": "USD" }, "chargePerWeight": { "amount": 0.50, "currency": "USD" }, "chargePerItem": { "amount": 0.00, "currency": "USD" } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "subRegionName": "West", "states": [ { "stateCode": "CA", "stateName": "California" }, { "stateCode": "WA", "stateName": "Washington" } ] } ] } ], "addressTypes": [ "PO_BOX" ], "transitTime": 7, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 6.99, "currency": "USD" }, "chargePerWeight": { "amount": 0.75, "currency": "USD" }, "chargePerItem": { "amount": 1.00, "currency": "USD" } } } ] }, { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0.00, "currency": "USD" }, "chargePerWeight": { "amount": 0.00, "currency": "USD" }, "chargePerItem": { "amount": 0.00, "currency": "USD" } } } ] } ]
}
import uuid
import requests template_id = "REPLACE_WITH_TEMPLATE_ID"
url = f"https://marketplace.walmartapis.com/v3/settings/shipping/templates/{template_id}" headers = { "WM_QOS.CORRELATION_ID": str(uuid.uuid4()), "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "REDACTED_ACCESS_TOKEN", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json",
} response = requests.get(url, headers=headers, timeout=30)
print("Status:", response.status_code)
print(response.text)
response.raise_for_status()Modify your code
Add an authentication header
Include a valid OAuth access token:
\--header 'Authorization: Bearer <ACCESS_TOKEN>'Authentication is required for all Marketplace API calls. Each request header must include:
- Your authorization
WM_SEC.ACCESS_TOKENWM_QOS.CORRELATION_IDWM_SVC.NAME
Environment selection
If you’re using the sandbox, update the base URL accordingly.
Sample response
{ "id": "91235658274476033", "name": "Next Day servc test", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingType": "INTERNATIONAL", "fcDetails": { "countryName": "India", "isoCountryCode": "IN", "fulfillmentCenterIds": [ "677435283530285057" ] }, "shippingMethods": [ { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 10, "tieredShippingCharges": [ { "minLimit": 10.06, "maxLimit": -1, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0, "maxLimit": 10.05, "shipCharge": { "amount": 1, "currency": "USD" } } ] } ] } ], "createdDate": 1599589180814, "modifiedDate": 1599589209694
}
Result
This response provides template metadata such as:
idnametype(DEFAULTorCUSTOM)rateModelType(TIERED_PRICINGorPER_SHIPMENT_PRICING)status(ACTIVEorINACTIVE)shippingType(for example,INTERNATIONAL)createdDatemodifiedDate
Fulfillment center details
countryNameisoCountryCodefulfillmentCenterIds
Shipping Methods
Each shipping method includes:
shipMethod(such asSTANDARD,VALUE,ONE_DAY)- The status
regionsandsubRegionsaddressTypes(STREET,PO_BOX,MILITARY)transitTime- The pricing configuration (
TIERED_PRICINGorPER_SHIPMENT_PRICING)
Next steps
The Update shipping templates API lets you modify configurations on an existing shipping template, such as shipping methods, regions, transit times, and pricing rules.
The Delete shipping templates API lets you permanently remove existing shipping templates from Walmart Marketplace settings.
The Get all fulfillment centers API retrieves fulfillment centers (also known as ship nodes) information on your account.
The Update fulfillment center API helps you update your existing fulfillment centers (also known as a ship nodes) configuration in Marketplace Settings.
The Create fulfillment center API sets up new fulfillment centers (also known as ship nodes) in Walmart Marketplace Settings.
The Get account level settings API retrieves account-level shipping settings such as calendar day configurations, weekends, and additional days off.
The Update account level settings API allows you to configure account-level calendar settings that impact shipping calculations and delivery promise logic.
The Create account level settings API lets you establish account level calendar configuration for your shipping operations.
The Get all shipping templates API retrieves a list of all shipping templates configured on your account.
The Create shipping templates API allows sellers to create custom shipping templates that define shipping methods, transit times, pricing logic, and geographic coverage.
The Third-party fulfillment center association API allows sellers to activate or update the status of 3PL (third-party logistics) ship nodes associated with your Marketplace account.
- Third-party fulfillment center association Guide
- Third-party fulfillment center association API Reference Guide
The Get shipping configurations API retrieves account-level shipping profile settings associated on your account.
The Get shipping template activation status API allows sellers to retrieve the current activation state of shipping templates at the account level.
The Get coverage for fulfillment centers API retrieves the geographic coverage areas associated with each fulfillment center (ship node) configured under a seller account.
The Get carrier methods API retrieves the list of carrier methods available for use in Marketplace shipping configurations
The Get all third-party fulfillment providers API retrieves all third-party fulfillment providers (3PLs) available on the Walmart marketplace.
- Get all third-party fulfillment providers Guide
- Get all third-party fulfillment providers API Reference Guide
The Get partner configurations API retrieves seller-level profile information and system configuration settings associated with a Marketplace partner account.
Updated about 12 hours ago
