Call this endpoint to create a carrier rate quote for shipping inbound seller items from the pickup location to Walmart Fulfillment Centers. The Walmart Fulfillment Services (WFS) Preferred Carrier Program supports both FedEx parcel solutions and Less Than Truckload (LTL) shipments.

Provide shipment details such as origin and destination addresses, package dimensions, weight, and other relevant information. The API returns a shipping cost quote based on these details.

Key details about FedEx small parcel shipments include:

Weight limit: You can ship packages up to 150 lb.
Size limit: Packages can be up to 108" in length and 165" in length plus girth (where girth is calculated as 2x width + 2x height).
Package limit: You can ship up to 999 packages per shipment.

Key details about Less Than Truckload (LTL) shipments include:

Packages can consist of up to 12 unstacked pallets or up to 24 stacked pallets.
Weight limit: You can ship up to 22,000 lbs. total per shipment.
Volume limit: Up to 1,200 cubic feet in volume.

Note: This page shows examples using only the required parameters and inputs for creating carrier rate quotes. For a full list of customization options and additional capabilities, refer to the Marketplace Fulfillment API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-quote

Parcel quote type

This section demonstrates how to create carrier rate quotes for parcel shipments by providing detailed shipment information.

Sample request

This example demonstrates how to create a shipment quote specifically for the "PARCEL" quoteType.

curl --request POST \ --url https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-quote \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "payload": { "shipmentId": "0606271WFA", "quoteType": "Parcel", "units": [ { "destination": { "locationType": "DC", "addressLine1": "6720 Kimball Ave", "addressLine2": "", "city": "Chino", "stateOrProvince": "CA", "country": "US", "postalCode": "91708" }, "origin": { "addressLine1": "123 Main St", "addressLine2": "", "city": "Sunnyvale", "country": "US", "postalCode": "95126", "stateOrProvince": "CA", "phone": "2345678902", "locationName": "" }, "unitDetails": { "shipmentPackages": [ { "packageSequenceNumber": 1, "weight": "10", "weightUOM": "lb", "length": "12", "height": "16", "width": "5", "lengthUOM": "IN", "packageType": "MIXED SKUS" } ] } } ] }
}
'

import requests url = "https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-quote"
headers = { "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_SVC.NAME": "Walmart Service Name", "accept": "application/json", "content-type": "application/json"
} data = { "payload": { "shipmentId": "0606271WFA", "quoteType": "Parcel", "units": [ { "destination": { "locationType": "DC", "addressLine1": "6720 Kimball Ave", "addressLine2": "", "city": "Chino", "stateOrProvince": "CA", "country": "US", "postalCode": "91708" }, "origin": { "addressLine1": "123 Main St", "addressLine2": "", "city": "Sunnyvale", "country": "US", "postalCode": "95126", "stateOrProvince": "CA", "phone": "2345678902", "locationName": "" }, "unitDetails": { "shipmentPackages": [ { "packageSequenceNumber": 1, "weight": "10", "weightUOM": "lb", "length": "12", "height": "16", "width": "5", "lengthUOM": "IN", "packageType": "MIXED SKUS" } ] } } ] }
} response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.text)

Modify your code

Replace all placeholder values with your actual shipment data before making the API request.

Authorization - Replace with your actual Base64-encoded credentials.
WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.
Replace origin fields with the full shipping address, including street, city, state, postal code, and country.
Replace shipmentPackages details with accurate dimensions, weight, and label information for each shipment package.

Sample response

This sample response provides a comprehensive overview of the rate quote for a Parcel shipment, including the shipment ID, tracking number, quote type, estimated delivery date, billing weight, and various other attributes.

 { "payload": { "shipmentId": "string", "shipmentNumber": 0, "quoteType": "parcel", "rateQuotes": [ { "quoteId": "string", "estimatedDeliveryDateTime": "2025-07-28T23:02:29.338Z", "carrier": { "carrierId": "string", "carrierName": "string" }, "currency": "string", "discountCharge": 0, "netCharge": 0, "totalBillingWeight": 0, "status": "string", "rateZoneId": 0, "fedExFreightCharge": 0, "effectiveDate": "2025-07-28T23:02:29.338Z", "freightCharge": 0, "fuelCharge": 0, "totalWeight": 0, "totalVolume": 0, "numberOfPallets": 0, "nominalCharge": 0, "assessorialCharge": 0, "serviceCharge": 0, "minimumCharge": 0, "mixedSKUs": 0, "singleSKUs": 0, "totalCharge": 0 } ], "netCharge": 14.6, "fedExFreightCharge": 0, "serviceCharge": 0, "mpsShipment": true, "eligibleForITS": true }, "status": "OK"
}

Less Than Truckload (LTL) quote type

This section demonstrates how to create carrier rate quotes for Less Than Truckload (LTL) shipments by providing detailed shipment information.

Sample request

This example demonstrates how to create a shipment quote specifically for the "LTL" quoteType.

curl --request POST \ --url https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-quote \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "payload": { "shipmentId": "0597968WFA", "quoteType": "LTL", "equipmentDetails": null, "pickUpFromDate": "2024-04-04T15:00:57.271Z", "pickUpToDate": "2024-04-04T15:33:57.271Z", "contactDetails": { "FirstName": "Customer first name", "LastName": "Customer last name", "email": "Customer's email address", "phoneNo": "Customer's phone number" }, "units": [ { "sequenceNbr": null, "mode": null, "serviceLevel": null, "origin": { "addressLine1": "123 Main St", "addressLine2": "", "city": "Sunnyvale", "country": "US", "postalCode": "46231", "stateOrProvince": "IN", "phone": "2345678902", "locationName": "test", "locationType": "VNDR" }, "destination": null, "unitDetails": { "freightClass": 0, "declaredValue": 1000, "noOfSingleSkuBoxes": 1000, "noOfMixedSkuBoxes": 50, "totalPalletCount": 2, "shipmentPackages": [ { "isStackable": true, "width": 40, "length": 48, "weightUOM": "LB", "lengthUOM": "IN", "packageType": "", "height": 40, "packageSequenceNumber": 1, "weight": 190 } ] } } ] }
}
'

import requests
import json url = "https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-quote" headers = { "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_SVC.NAME": "Walmart Service Name", "accept": "application/json", "content-type": "application/json"
} payload = { "payload": { "shipmentId": "0597968GDM", "quoteType": "LTL", "equipmentDetails": None, "pickUpFromDate": "2024-04-04T15:00:57.271Z", "pickUpToDate": "2024-04-04T15:33:57.271Z", "contactDetails": { "FirstName": "Customer first name", "LastName": "Customer last name", "email": "Customer's email address", "phoneNo": "Customer's phone number" }, "units": [ { "sequenceNbr": None, "mode": None, "serviceLevel": None, "origin": { "addressLine1": "123 Main St", "addressLine2": "", "city": "Sunnyvale", "country": "US", "postalCode": "46231", "stateOrProvince": "IN", "phone": "2345678902", "locationName": "test", "locationType": "VNDR" }, "destination": None, "unitDetails": { "freightClass": 0, "declaredValue": 1000, "noOfSingleSkuBoxes": 1000, "noOfMixedSkuBoxes": 50, "totalPalletCount": 2, "shipmentPackages": [ { "isStackable": True, "width": 40, "length": 48, "weightUOM": "LB", "lengthUOM": "IN", "packageType": "", "height": 40, "packageSequenceNumber": 1, "weight": 190 } ] } } ] }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print(response.status_code)
print(response.json())

Modify your code

Replace all placeholder values with your actual shipment data before making the API request.

Authorization - Replace with your actual Base64-encoded credentials.
WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.
Replace origin fields with the full shipping address, including street, city, state, postal code, and country.
Replace shipmentPackages details with accurate dimensions, weight, and label information for each shipment package.

Sample response

This sample response provides a comprehensive overview of the rate quote for a LTL shipment, including the shipment ID, tracking number, quote type, estimated delivery date, billing weight, and various other attributes.

 { "payload": { "shipmentId": "string", "shipmentNumber": 0, "quoteType": "LTL", "rateQuotes": [ { "quoteId": "string", "estimatedDeliveryDateTime": "2025-07-28T23:02:29.338Z", "carrier": { "carrierId": "string", "carrierName": "string" }, "currency": "string", "discountCharge": 0, "netCharge": 0, "totalBillingWeight": 0, "status": "string", "rateZoneId": 0, "fedExFreightCharge": 0, "effectiveDate": "2025-07-28T23:02:29.338Z", "freightCharge": 0, "fuelCharge": 0, "totalWeight": 0, "totalVolume": 0, "numberOfPallets": 0, "nominalCharge": 0, "assessorialCharge": 0, "serviceCharge": 0, "minimumCharge": 0, "mixedSKUs": 0, "singleSKUs": 0, "totalCharge": 0 } ], "netCharge": 134.6, "fedExFreightCharge": 0, "serviceCharge": 0, "mpsShipment": true, "eligibleForITS": true }, "status": "OK"
}

Result

If the request is successful, the response returns a 200 OK status and provides detailed information about the shipment and its associated carrier rate quotes.