Get issue types

Overview

Use the get issue types API to retrieve the metadata dictionary for all the Search Engine Marketing (SEM) issue types. Each entry includes a human-readable description, issue category BLOCKED, LIMITED, or NO_ISSUES), whether the issue is fixable by the seller, and a remediation documentation link.

Call this endpoint once at startup, cache the results, and use them to enrich diagnostics returned by the search item issues endpoint. This endpoint returns:

• Issue names
• Issue descriptions
• Issue categories
• Remediation guidance
• Issue fixability status
• Help links

Use cases

Use this endpoint to:

• Enrich diagnostics search results with human-readable descriptions
• Build remediation workflows using fixability status
• Drive issue severity badges in dashboards
• Link sellers to remediation documentation

Endpoint

GET /v3/advertising/sem/item-issues/issue-types

Request sample

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/advertising/sem/item-issues/issue-types' \ --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ --header 'WM_MARKET: US' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'WM_SEC.ACCESS_TOKEN: <Your_access_token>' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'Accept: application/json'

import requests url = "https://marketplace.walmartapis.com/v3/advertising/sem/item-issues/issue-types" headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "<Your_access_token>", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json"
} response = requests.get(url, headers=headers)
print(response.json())

Modify your code

This endpoint does not require a request body. However, you can customize your integration by:

• Caching the response locally
• Refreshing metadata every 24 hours
• Mapping issueType values to diagnostics responses
• Using isFixable to drive remediation workflows

Response sample

{ "ITEM_OUT_OF_STOCK": { "issueName": "Item Out of Stock", "issueCategory": "BLOCKED", "isFixable": true, "issueDescription": "Item is Out of Stock. Please add additional inventory.", "learnMoreUrl": "https://marketplacelearn.walmart.com" }
}

Results

A successful response returns a metadata map keyed by issueType. Each issue type includes remediation guidance, severity, fixability, and optional help links.

Error handling

Common issue types

Best practices

• Cache issue metadata locally
• Refresh metadata every 24 hours
• Use isFixable=true to prioritize remediation workflows
• Group UI badges using issueCategory
• Link sellers to learnMoreUrl resources

Next steps

After retrieving issue metadata:

• Match issue types returned by diagnostics to metadata records
• Build “Fix Now” workflows for actionable issues
• Use issue categories to prioritize seller remediation
• Integrate metadata into SEM dashboards