Walmart Rules API
The Rules API from Walmart — 14 operation(s) for rules.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/walmart-rules-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Walmart Management Rules API
description: Rules Management
servers:
- url: https://marketplace.walmartapis.com
description: Production URL
- url: https://sandbox.walmartapis.com
description: Sandbox URL
security:
- basicScheme: []
tags:
- name: Rules
paths:
/v3/rules/inactivate:
put:
tags:
- Rules
summary: Walmart Inactivate Rule
description: You can use this API to inactivate one or more rules for a specific ruleId and ruleStatus.
operationId: inactivateRule
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
type: object
properties:
ruleHeader:
type: object
properties:
version:
type: string
rules:
type: array
items:
type: object
properties:
ruleId:
type: string
description: Unique identifier of the rule created for custom rule assortment.
ruleStatus:
type: string
description: Status of the rule post the rule creation. Allowed values are Active, Inactive, Submitted.
example:
ruleHeader:
version: '1.2'
rules:
- ruleId: '39'
ruleStatus: Submitted
- ruleId: '44'
ruleStatus: Active
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Message and status of inactivation of rule
status:
type: string
description: status
example:
message: 'Rules are inactivated: [39, 44]'
status: SUCCESS
/v3/rules/exceptions:
get:
tags:
- Rules
summary: Walmart Gets All Exceptions
description: This API retrieves all the items which has been defined as exceptions using "Create Override Exception" API.
operationId: getAllExceptions
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
skuIds:
type: array
description: A seller-provided Product ID.
items:
type: string
description: A seller-provided Product ID.
status:
type: string
example:
skuIds:
- '123456'
- '789065'
status: SUCCESS
put:
tags:
- Rules
summary: Walmart Delete Exceptions
description: This API is used to bring back any SKU to Two-day Delivery settings.
operationId: deleteExceptions
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
type: object
properties:
ruleHeader:
type: object
properties:
version:
type: string
rules:
type: object
properties:
skus:
type: array
items:
type: object
properties:
sku:
type: string
description: 'An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. This will be used by the seller in the XSD file to refer to each item. Special characters in the sku needing encoding are: '':'', ''/'', ''?'', ''#'', ''['', '']'', ''@'', ''!'', ''$'', ''&'', "''", ''('', '')'', ''*'', ''+'', '','', '';'', ''='', as well as ''%'' itself. Other characters don''t need to be encoded.'
example:
ruleHeader:
version: '1.2'
rules:
skus:
- sku: sku-1234
- sku: sku-2323
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
feedId:
type: string
description: A unique ID, returned from the Create Override Exception API, used for tracking a feed file
status:
type: string
description: status
example:
feedId: 5ED712C698FD43B999EC5EEFD5C63655@ATgBAQA
status: OK
post:
tags:
- Rules
summary: Walmart Create Override Exceptions
description: This API is used if any SKU is required to be removed from Two-day delivery settings
operationId: createOverrideExceptions
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
type: object
properties:
ruleHeader:
type: object
properties:
version:
type: string
rules:
type: object
properties:
skus:
type: array
items:
type: object
properties:
sku:
type: string
description: 'An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. This will be used by the seller in the XSD file to refer to each item. Special characters in the sku needing encoding are: '':'', ''/'', ''?'', ''#'', ''['', '']'', ''@'', ''!'', ''$'', ''&'', "''", ''('', '')'', ''*'', ''+'', '','', '';'', ''='', as well as ''%'' itself. Other characters don''t need to be encoded.'
example:
ruleHeader:
version: '1.2'
rules:
skus:
- sku: sku-1234
- sku: sku-2323
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
feedId:
type: string
description: A unique ID, returned from the Create Override Exception API, used for tracking a feed file
status:
type: string
description: status
example:
feedId: 5ED712C698FD43B999EC5EEFD5C63655@ATgBAQA
status: OK
/v3/rules/assortment:
put:
tags:
- Rules
summary: Walmart Change Assortment Type
description: This API helps you enable or disable the two-day assortment type.
operationId: changeAssortmentType
parameters:
- name: enable
in: query
required: true
schema:
type: boolean
example: true
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
content:
application/json:
schema:
type: object
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
status:
type: string
payload:
type: object
properties:
id:
type: string
description: Unique identifier of the rule created for custom rule assortment.
example:
status: OK
payload:
id: 366efe47-61cc-4493-978a-6bab0604f78e
/v3/rules/activate:
put:
tags:
- Rules
summary: Walmart Activate Rule
description: This API is used to activate a rule for a specific ruleId and ruleStatus. Only Rules which are in submitted and inactive state can be activated.
operationId: activateRule
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
type: object
properties:
ruleHeader:
type: object
properties:
version:
type: string
rules:
type: array
items:
type: object
properties:
ruleId:
type: string
description: Unique identifier of the rule created for custom rule assortment.
ruleStatus:
type: string
description: Status of the rule post the rule creation. Allowed values are Active, Inactive, Submitted.
example:
ruleHeader:
version: '1.2'
rules:
- ruleId: '39'
ruleStatus: Submitted
- ruleId: '44'
ruleStatus: Inactive
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Message and ruleId
status:
type: string
description: status
example:
message: 'Rules are activated: [39, 44]'
status: Success
/v3/rules/actions:
put:
tags:
- Rules
summary: Walmart Update Shipping Area to Rules
description: This API helps you define coverage areas for your items that are held outside of the fulfillment centers defined by your shipNode management API's.
operationId: updateShippingAreaToRule
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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:
type: object
properties:
ruleHeader:
type: object
properties:
version:
type: string
rules:
type: object
properties:
ruleId:
type: string
description: Unique identifier of the rule created for custom rule assortment.
ruleStatus:
type: string
description: Status of the rule post the rule creation. Allowed values are Active, Inactive, Submitted.
actions:
type: array
description: Defines the two day state coverage areas.
items:
type: object
properties:
twoDayShippingRegions:
type: array
description: List of two-day regions.
items:
type: object
properties:
regionCode:
type: string
description: regionCode
subRegions:
type: array
items:
type: object
properties:
subRegionCode:
type: string
description: subRegionCode
description: List of two-day regions.
description: Defines the two day state coverage areas.
example:
ruleHeader:
version: '1.2'
rules:
ruleId: '612'
ruleStatus: Submitted
actions:
- twoDayShippingRegions:
- regionCode: NE
subRegions:
- subRegionCode: NY1
- subRegionCode: NY2
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
rules:
type: array
items:
type: object
properties:
conditions:
type: array
description: 'Seller creates conditions while defining the custom rule assortment.There are three condition which a seller can use : subCategories, price, weight.'
items:
type: object
properties:
name:
type: string
description: Name of the rule created for custom rule assortment.
operator:
type: string
description: 'Seller uses operator while defining conditions in the rule. Operators allowed for condition price and weight: EQUALS, GREATER_THAN, LESS_THAN,GREATER_THAN_OR_EQUALS,LESS_THAN_OR_EQUALS. and for condition subcategories : IN .'
value:
type: string
description: Values for each condition. Value can be a comma separated strings for subcategories and numerical value for price and weight.
description: 'Seller creates conditions while defining the custom rule assortment.There are three condition which a seller can use : subCategories, price, weight.'
description:
type: string
description: Description of the rule created for custom rule assortment.
name:
type: string
description: Name of the rule created for custom rule assortment.
priority:
type: string
description: Priority of the rule created for custom rule assortment.
ruleId:
type: string
description: Unique identifier of the rule created for custom rule assortment.
ruleStatus:
type: string
description: Status of the rule post the rule creation. Allowed values are Active, Inactive, Submitted.
skuProcessingStatus:
type: string
description: When the rule gets activated, skuProcessingStatus represents the state of all items being processed for two-day. The two values for skuProcessingStatus are Processing and Completed.
ruleAction:
type: object
properties:
twoDayShippingRegions:
type: array
description: List of two-day regions.
items:
type: object
properties:
regionCode:
type: string
description: regionCode
subRegions:
type: array
items:
type: object
properties:
subRegionCode:
type: string
description: subRegionCode
description: List of two-day regions.
description: Defines the two day state coverage areas.
status:
type: string
description: status
example:
rules:
- conditions:
- name: price
operator: EQUALS
value: '20'
- name: subCategories
operator: IN
value: 571fdff7208f9a0cdb760a7f,56f2eb65208f9a0612c3adbd
description: testing-new-510
name: testing-new-510
priority: '21'
ruleAction:
twoDayShippingRegions:
- regionCode: NE
subRegions:
- subRegionCode: NY1
- subRegionCode: NY2
ruleId: '612'
ruleStatus: Submitted
status: OK
/v3/rules/:
get:
tags:
- Rules
summary: Walmart Get All Rules
description: This API retrieves the details of all the rules defined using "create an Item rule" API.
operationId: getAllRules
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
rules:
type: array
items:
type: object
properties:
conditions:
type: array
description: 'Seller creates conditions while defining the custom rule assortment.There are three condition which a seller can use : subCategories, price, weight.'
items:
type: object
properties:
name:
type: string
description: Name of the rule created for custom rule assortment.
operator:
type: string
description: 'Seller uses operator while defining conditions in the rule. Operators allowed for condition price and weight: EQUALS, GREATER_THAN, LESS_THAN,GREATER_THAN_OR_EQUALS,LESS_THAN_OR_EQUALS. and for condition subcategories : IN .'
value:
type: string
description: Values for each condition. Value can be a comma separated strings for subcategories and numerical value for price and weight.
description: 'Seller creates conditions while defining the custom rule assortment.There are three condition which a seller can use : subCategories, price, weight.'
description:
type: string
description: Description of the rule created for custom rule assortment.
name:
type: string
description: Name of the rule created for custom rule assortment.
priority:
type: string
description: Priority of the rule created for custom rule assortment.
ruleId:
type: string
description: Unique identifier of the rule created for custom rule assortment.
ruleStatus:
type: string
description: Status of the rule post the rule creation. Allowed values are Active, Inactive, Submitted.
skuProcessingStatus:
type: string
description: When the rule gets activated, skuProcessingStatus represents the state of all items being processed for two-day. The two values for skuProcessingStatus are Processing and Completed.
ruleAction:
type: object
properties:
twoDayShippingRegions:
type: array
description: List of two-day regions.
items:
type: object
properties:
regionCode:
type: string
description: regionCode
subRegions:
type: array
items:
type: object
properties:
subRegionCode:
type: string
description: subRegionCode
description: List of two-day regions.
description: Defines the two day state coverage areas.
status:
type: string
description: status
example:
rules:
- conditions:
- name: weight
operator: LESS_THAN
value: '10'
- name: subCategories
operator: IN
value: 559c5d924fff3d64de18bf45,559c5d8f4fff3d64de18bf3d
name: Test rule Issue2
priority: '6'
ruleId: '565'
ruleStatus: Active
skuProcessingStatus: Success
- conditions:
- name: subCategories
operator: IN
value: 559c5d924fff3d64de18bf45
name: njnjn
priority: '10'
ruleAction:
twoDayShippingRegions:
- regionCode: NE
subRegions:
- subRegionCode: RI
- subRegionCode: ME1
- subRegionCode: ME2
- subRegionCode: NH
- subRegionCode: NY3
- subRegionCode: NY1
- subRegionCode: NY5
- subRegionCode: NY2
- subRegionCode: NY4
- subRegionCode: NJ3
- subRegionCode: NJ4
- subRegionCode: NJ1
- subRegionCode: NJ2
- subRegionCode: VT
ruleId: '602'
ruleStatus: Active
skuProcessingStatus: Processing
status: success
put:
tags:
- Rules
summary: Walmart Update Rule
description: This API updates a rule defined using "create an Item rule". You can update priority, Description, conditions and name of a rule.
operationId: updateRule
parameters:
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- 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
# --- truncated at 32 KB (84 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/walmart/refs/heads/main/openapi/walmart-rules-api-openapi.yml