--- updatedAt: 2026-06-29T21:10:45.000Z --- # Fetch delivery promise details Returns fulfillment options, delivery promise details, and estimated MCS fulfillment fees for an eligible item and offer. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Fulfillment Management", "version": "1.0", "description": "With Walmart Fulfillment Services, you can focus on sales while Walmart expertly take care of fast shipping, seamless returns, and customer service. Simply send your inventory to Walmart fulfillment centers, where we will store your products securely and prepare them swiftly for shipping when an order is placed." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions": { "post": { "tags": [ "Fulfillment" ], "summary": "Fetch delivery promise details", "description": "Returns fulfillment options, delivery promise details, and estimated MCS fulfillment fees for an eligible item and offer.", "externalDocs": { "description": "View Guide", "url": "/doc/us/mp/us-mp-fulfillment/#12154" }, "operationId": "promiseFulfillments", "parameters": [ { "in": "header", "name": "Authorization", "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.", "required": true, "schema": { "type": "string" }, "example": "Basic YzcyOTFjNmItNzI5MC00...." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to track 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 which identifies each API call and used to track and debug issues; use a random generated GUID for this ID", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Walmart Service Name", "required": true, "schema": { "type": "string" }, "example": "Walmart Service Name" } ], "requestBody": { "description": "Request fields", "content": { "application/json": { "schema": { "required": [ "payload" ], "type": "object", "properties": { "header": { "type": "object", "properties": { "headerAttributes": { "type": "object", "properties": { "martId": { "type": "string", "description": "martId of the seller. Currently supported: '202'" }, "buId": { "type": "string", "description": "buId of the seller. Currently supported: '0'" } }, "description": "Header attributes" } }, "description": "header to support build and martId" }, "payload": { "required": [ "destinations", "offerSelections" ], "type": "object", "properties": { "destinations": { "type": "array", "description": "Customer order destination details.", "xml": { "wrapped": true }, "items": { "required": [ "address", "fulfillmentType" ], "type": "object", "properties": { "address": { "required": [ "zip", "state" ], "type": "object", "properties": { "city": { "type": "string", "description": "City where the address is located in." }, "addressType": { "type": "string", "description": "Type of address (example: RESIDENTIAL)." }, "zip": { "type": "string", "description": "ZIP or postal code where the address is located in." }, "line1": { "type": "string", "description": "First line of the address." }, "line2": { "type": "string", "description": "Second line of the address." }, "country": { "type": "string", "description": "Country code where the address is located in." }, "state": { "type": "string", "description": "State (two letter) code where the address is located in." } }, "description": "Address details." }, "fulfillmentType": { "type": "string", "description": "Fulfillment Type of an order. Currently supported type : 'DELIVERY'" } }, "description": "Customer order destination details." } }, "offerSelections": { "type": "array", "description": "Offer Selection details. List of offers - number of offer inside offer selection should be less than or equal to 30.", "xml": { "wrapped": true }, "items": { "required": [ "offers" ], "type": "object", "properties": { "offers": { "type": "array", "description": "Offer details. List of an items/vendor sku.", "xml": { "wrapped": true }, "items": { "required": [ "lineId", "requestedQuantity", "salesUnit", "sku" ], "type": "object", "properties": { "sku": { "type": "string", "description": "The identifier of the item in seller system (vendor sku)." }, "lineId": { "type": "string", "description": "The identifier (UUID) for each line assigned by seller systems." }, "salesUnit": { "type": "string", "description": "Sales unit type. Currently supported type : 'EACH'" }, "requestedQuantity": { "required": [ "measurementValue", "unitOfMeasure" ], "type": "object", "properties": { "measurementValue": { "minimum": 1, "type": "integer", "description": "Quantity of each item.", "format": "int32" }, "unitOfMeasure": { "type": "string", "description": "Unit of quantity. Currently supported type : 'EA'" } }, "description": "Requested Quantity Information of an item." } }, "description": "Offer details. List of an items/vendor sku." } } }, "description": "Offer Selection details. List of offers - number of offer inside offer selection should be less than or equal to 30." } } }, "description": "Request payload." } } }, "example": { "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "destinations": [ { "address": { "city": "Milpitas", "addressType": "RESIDENTIAL", "postalCode": "95035", "addressLineOne": "261 Odyssey Ln", "addressLineTwo": "222", "isPOBox": false, "countryCode": "US", "stateCode": "CA" }, "fulfillmentType": "DELIVERY" } ], "offerSelections": [ { "offers": [ { "sku": "OMP-B01-L", "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b00", "salesUnit": "Each", "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" } } ] } ] } } } }, "required": true }, "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "description": "Response status." }, "header": { "type": "object", "properties": { "headerAttributes": { "type": "object", "properties": { "martId": { "type": "string", "description": "martId of the seller. Currently supported: '202'" }, "buId": { "type": "string", "description": "buId of the seller. Currently supported: '0'" } }, "description": "Header attributes" } }, "description": "header to support build and martId" }, "payload": { "type": "object", "properties": { "offers": { "type": "array", "description": "Offer details indicating available quantity vs required quantify for offer", "items": { "type": "object", "properties": { "availableQuantity": { "required": [ "measurementValue", "unitOfMeasure" ], "type": "object", "properties": { "measurementValue": { "minimum": 1, "type": "integer", "description": "Quantity of each item.", "format": "int32" }, "unitOfMeasure": { "type": "string", "description": "Unit of quantity. Currently supported type : 'EA'" } }, "description": "Available Quantity Information of an item." }, "requestedQuantity": { "required": [ "measurementValue", "unitOfMeasure" ], "type": "object", "properties": { "measurementValue": { "minimum": 1, "type": "integer", "description": "Quantity of each item.", "format": "int32" }, "unitOfMeasure": { "type": "string", "description": "Unit of quantity. Currently supported type : 'EA'" } }, "description": "Requested Quantity Information of an item." }, "lineId": { "type": "string", "description": "The identifier (UUID) for each line assigned by seller systems." }, "salesUnit": { "type": "string", "description": "Sales unit type. Currently supported type : 'EACH'" }, "sku": { "type": "string", "description": "The identifier of the item in seller system (vendor sku)." } }, "description": "Offer details indicating available quantity vs required quantify for offer" } }, "destinations": { "type": "array", "description": "Customer order destination details.", "items": { "type": "object", "properties": { "address": { "required": [ "postalCode", "stateCode" ], "type": "object", "properties": { "city": { "type": "string", "description": "City where the address is located in." }, "addressType": { "type": "string", "description": "The address type. For example: 'RESIDENTIAL'" }, "postalCode": { "type": "string", "description": "ZIP or postal code where the address is located in." }, "addressLineOne": { "type": "string", "description": "First line of the address." }, "addressLineTwo": { "type": "string", "description": "Second line of the address." }, "countryCode": { "type": "string", "description": "Country code where the address is located in." }, "stateCode": { "type": "string", "description": "State (two letter) code where the address is located in." }, "isPOBox": { "type": "boolean", "description": "PO box detail." } }, "description": "Address details." }, "fulfillmentType": { "type": "string", "description": "Fulfillment Type of an order. Currently supported type : 'DELIVERY'" } }, "description": "Customer order destination details." } }, "fulfillmentPlans": { "type": "array", "description": "Fulfillment plans details.", "items": { "type": "object", "properties": { "fulfillmentModules": { "type": "array", "description": "Fulfillment module details.", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "Fulfillment module name. For example : 'UNSCHEDULED_DELIVERY and ERROR'" }, "fulfillmentGroups": { "type": "array", "description": "Fulfillment Group details.", "items": { "type": "object", "properties": { "fulfillmentOptions": { "type": "array", "description": "Fulfillment options details.", "items": { "type": "object", "properties": { "fulfillmentMode": { "type": "string", "description": "Fulfillment mode detail. For example : 'UNSCHEDULED'" }, "accessType": { "type": "string", "description": "Fulfillment access type. For example : 'DELIVERY_ADDRESS'" }, "fulfillments": { "type": "array", "description": "Fulfillment details.", "items": { "type": "object", "properties": { "fulfillmentId": { "type": "string", "description": "The identifier to identify fulfillment." }, "lineItemAttributesList": { "type": "array", "description": "Line item attribute details.", "items": { "type": "object", "properties": { "availableQuantity": { "required": [ "measurementValue", "unitOfMeasure" ], "type": "object", "properties": { "measurementValue": { "minimum": 1, "type": "integer", "description": "Quantity of each item.", "format": "int32" }, "unitOfMeasure": { "type": "string", "description": "Unit of quantity. Currently supported type : 'EA'" } }, "description": "Requested Quantity Information of an item." }, "fulfillmentChannel": { "type": "array", "description": "Fulfillment channel details. For example : 'WFS_FULFILLED'", "items": { "type": "string", "description": "Fulfillment channel details. For example : 'WFS_FULFILLED'" } }, "lineId": { "type": "string", "description": "The identifier to identify each line, assigned by seller systems." } }, "description": "Line item attribute details." } }, "sla": { "type": "object", "properties": { "tier": { "type": "string", "description": "Service level agreement tier details.For example : 'TWO_DAY'" }, "speed": { "type": "string", "description": "Ship method details. For example : 'Rush, Expedited, Value and Standard'" } }, "description": "Fulfillment service level agreement details." }, "nodeType": { "type": "string", "description": "Fulfillment node type details. For example : 'FC'" }, "accessMode": { "type": "object", "properties": { "mode": { "type": "string", "description": "Fulfillment access mode type. For example : 'NATIONAL_CARRIER'" } }, "description": "Fulfillment access mode details." }, "fulfillmentTime": { "type": "object", "properties": { "date": { "type": "object", "properties": { "minPromiseDate": { "type": "string", "description": "Fulfillment minimum promise date detail.", "format": "date-time" }, "Fulfillment maximum promise date detail.": { "type": "string", "format": "date-time" } }, "description": "Fulfillment date details." } }, "description": "Fulfillment time details." }, "errors": { "type": "array", "description": "Error list details.", "items": { "required": [ "code" ], "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "description": { "type": "string" }, "info": { "type": "string" }, "severity": { "type": "string", "enum": [ "INFO", "WARN", "ERROR" ] }, "category": { "type": "string", "enum": [ "APPLICATION", "SYSTEM", "REQUEST", "DATA" ] }, "causes": { "type": "array", "xml": { "wrapped": true }, "items": { "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "type": { "type": "string" }, "description": { "type": "string" } }, "xml": { "name": "Cause" } } } }, "xml": { "name": "Error" } } } }, "description": "Fulfillment details." } }, "fulfillmentType": { "type": "string", "description": "Fulfillment type detail. For example : 'DELIVERY'" } }, "description": "Fulfillment options details." } } }, "description": "Fulfillment Group details." } } }, "description": "Fulfillment module details." } } }, "description": "Fulfillment plans details." } }, "estimatedFees": { "type": "object", "description": "Estimated fee details for eligible items. Present only when the request contains at least one item with a valid `offerId` or `gtin`. Absent when the request has no `offerSelections` or when no eligible items are found. When status is SUCCESS, `itemDetails` contains per-item fee breakdowns and errors is absent. When status is `FAIL`, errors contains failure details and `itemDetails` is empty.", "properties": { "status": { "type": "string", "description": "Fee calculator result status. `SUCCESS` indicates that estimated fees were calculated for one or more eligible items. `FAIL` indicates that fee calculation failed and errors contains failure details.", "example": "SUCCESS", "enum": [ "SUCCESS", "FAIL" ] }, "errors": { "type": "array", "description": "List of errors returned when fee calculation fails.", "items": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "string", "description": "Error code that identifies the failure.", "example": "500.MCS.500" }, "field": { "type": "string", "description": "Field associated with the error, when applicable.", "example": "fee_calculator" }, "description": { "type": "string", "description": "Human-readable description of the error.", "example": "Internal server error." }, "info": { "type": "string", "description": "Additional information about the error, when available.", "example": "Failed to fetch estimated fees from fee-calculator service" }, "severity": { "type": "string", "description": "Severity level of the error.", "enum": [ "INFO", "WARN", "ERROR" ], "example": "ERROR" }, "category": { "type": "string", "description": "Category of the error.", "enum": [ "APPLICATION", "SYSTEM", "REQUEST", "DATA" ], "example": "APPLICATION" }, "causes": { "type": "array", "description": "Additional causes associated with the error, when available.", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Cause-specific error code." }, "field": { "type": "string", "description": "Field associated with the cause, when applicable." }, "type": { "type": "string", "description": "Type of cause." }, "description": { "type": "string", "description": "Human-readable description of the cause." } } } } } } }, "itemDetails": { "type": "array", "description": "Item-level estimated fee details returned when fee calculation succeeds.", "items": { "type": "object", "properties": { "offerId": { "type": "string", "description": "Offer identifier used to calculate estimated fees.", "example": "B41ECC04AE79634D96BEAD31AD1D5A8B0" }, "gtin": { "type": "string", "description": "GTIN used to calculate estimated fees for the item.", "example": "00708429035726" }, "chargeDetails": { "type": "array", "description": "List of estimated fee charges calculated for the item.", "items": { "type": "object", "properties": { "chargeType": { "type": "string", "description": "Type of estimated fee charge.", "example": "MCF_STANDARD", "enum": [ "MCF_STANDARD", "MCF_EXPEDITED", "FULFILLMENT" ] }, "currency": { "type": "string", "description": "ISO 4217 currency code for the charge amount.", "example": "USD" }, "netCharge": { "type": "number", "format": "double", "minimum": 0, "multipleOf": 0.01, "description": "Estimated fee amount for the charge type, expressed in the specified currency." } } } } } } } } } }, "description": "Response payload." } } }, "example": { "status": "ACCEPTED", "header": { "headerAttributes": { "buId": "0", "martId": "202" } }, "payload": { "offers": [ { "availableQuantity": { "measurementValue": 52, "unitOfMeasure": "EA" }, "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b00", "salesUnit": "Each", "sku": "OMP-B01-L" } ], "destinations": [ { "address": { "city": "Name of the city", "addressType": "RESIDENTIAL", "postalCode": "12345", "addressLineOne": "Street address", "addressLineTwo": "Optional", "isPOBox": false, "countryCode": "Country code, example: USA", "stateCode": "Two letter state code, example: KY" }, "fulfillmentType": "DELIVERY" } ], "fulfillmentPlans": [ { "fulfillmentModules": [ { "fulfillmentGroups": [ { "fulfillmentOptions": [ { "fulfillments": [ { "lineItemAttributesList": [ { "availableQuantity": { "measurementValue": 52, "unitOfMeasure": "EA" }, "fulfillmentChannel": [ "WFS_FULFILLED" ], "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b00" } ], "sla": { "tier": "TWO_DAY", "speed": "EXPEDITED" }, "accessMode": { "mode": "NATIONAL_CARRIER" }, "fulfillmentTime": { "date": { "minPromiseDate": "2023-02-27", "maxPromiseDate": "2023-02-27" } }, "fulfillmentId": "a269374b-0c07-4008-8b5c-6831cbb2c112", "nodeType": "FC" } ], "fulfillmentMode": "UNSCHEDULED", "accessType": "DELIVERY_ADDRESS", "fulfillmentType": "DELIVERY" } ] } ], "name": "UNSCHEDULED_DELIVERY" } ] } ], "estimatedFees": { "status": "SUCCESS", "itemDetails": [ { "offerId": "B41ECC04AE79634D96BEAD31AD1D5A8B0", "gtin": "00708429035726", "chargeDetails": [ { "chargeType": "MCF_STANDARD", "currency": "USD", "netCharge": 68.85 } ] } ] } } } } } } } } } }, "components": { "securitySchemes": { "accessToken": { "type": "apiKey", "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "An access token required for authenticating API requests. Obtain the token from `POST /v3/token` using the `client_credentials` grant type." } } } } ```