Get item association details
Overview
Use the Get item associations API to retrieve the shipping templates and fulfillment centers (ship nodes) associated with your item SKUs.
As part of the Precise Delivery Program, sellers and approved Solution Providers can associate item SKUs with shipping templates. You can configure these associations using the Bulk Item Setup (Multiple) API.
Submit a list of SKUs to retrieve their associated shipping template names, types, identifiers, and fulfillment center details.
Use Get item associations to verify the shipping templates and fulfillment centers assigned to your items.
Shipping template mappings can take 30 minutes to four hours to become available. Allow this processing time before retrieving newly configured associations.
Use cases
- Retrieve shipping templates associated with item SKUs.
- Identify fulfillment centers assigned to specific items.
- Verify shipping template associations after item setup.
- Review shipping template types and identifiers.
- Retrieve associations for multiple SKUs in one request.
Reference guide
This guide explains how to retrieve shipping template and fulfillment center associations for your item SKUs.
For complete endpoint details, parameters, and response definitions, refer to the Get item associations API reference.
Endpoint
POST https://marketplace.walmartapis.com/v3/items/associationsRequest sample
The following request retrieves shipping template and fulfillment center associations for two SKUs.
curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/items/associations' \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "sku": "RG-IRAE-79VD" }, { "sku": "AC73891" } ] }'import requests url = "https://marketplace.walmartapis.com/v3/items/associations" headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "Accept": "application/json", "Content-Type": "application/json"
} payload = { "items": [ { "sku": "RG-IRAE-79VD" }, { "sku": "AC73891" } ]
} response = requests.post(url, headers=headers, json=payload) print(response.text)Replace <ACCESS_TOKEN> with a valid access token and use a unique correlation ID for each request.
Modify your request
Retrieve associations for specific SKUs
Include an items array in the request body. Each item must contain a seller-defined sku.
You can submit up to 50 SKUs per request. To retrieve associations for more than 50 SKUs, submit multiple requests.
Example:
{ "items": [ { "sku": "RG-IRAE-79VD" }, { "sku": "AC73891" } ]
}Response sample
The following abbreviated response illustrates the shipping templates and fulfillment centers associated with the requested SKUs.
{ "items": [ { "sku": "RG-IRAE-79VD", "associations": [ { "shippingTemplate": { "name": "Template 1", "type": "CUSTOM", "id": "98723284584755201" }, "shipNodeName": "MP_Deliverr", "shipNode": "80991834993020929" } ] }, { "sku": "AC73891", "associations": [ { "shippingTemplate": { "name": "Default Shipping Template", "type": "DEFAULT", "id": "93685334451601409" }, "shipNodeName": "MP Center", "shipNode": "100009" } ] } ]
}The response is abbreviated for readability. A SKU can have multiple associations.
Results
After a successful request, the API returns the shipping templates and fulfillment centers associated with each requested SKU.
Next steps
- Review the returned shipping templates and fulfillment centers for each SKU.
- Use Bulk Item Setup (Multiple) to configure item associations as part of item setup.
- Allow the documented processing time before verifying newly configured associations.
Updated 4 days ago

