Returns the complete, authoritative metadata for all SEM eligibility issue types (~61 issue types, ~5KB).
Market availability: US only

Items used in Search Engine Marketing (SEM) campaigns such as Google Shopping Ads must meet specific content, quality, and policy requirements before they can be advertised on search engines. When items fail to meet these requirements, they are flagged with specific issue types that either block the item from being advertised entirely or limit its visibility and performance in SEM.

This endpoint returns the complete catalog of all issue types that can affect an item's SEM eligibility, along with human-readable names, descriptions, remediation guidance, severity categories, and help links. It serves as the single source of truth for issue metadata.

Current scope

The issue types returned by this endpoint apply to items that are currently part of active SEM campaigns. The POST /item-issues/search endpoint uses these issue types to report diagnostics on campaign items.

Future extensibility

In a future release, the POST /item-issues/search endpoint will support querying diagnostic issues for any item in the seller's catalog — even items not yet added to a campaign — using the itemId filter. The same issue types returned by this endpoint will apply to those items as well, enabling sellers to proactively diagnose and fix issues before campaign onboarding.

SEM eligibility issue categories

Each issue type belongs to one of three categories that indicate its impact on an item's ability to be advertised on search engines:

Actionable vs non-actionable issues

Each issue type includes an isFixable flag that indicates whether the seller can resolve the issue:

• isFixable=true: Seller can take action to restore or improve SEM eligibility (For example, restock inventory, update title, improve image quality). Partners should surface these with a "Fix Now" UI affordance.
• isFixable=false: Requires Walmart or system intervention (For example, Google policy violations, BuyBox eligibility). Partners should display these as informational — the seller cannot directly resolve them.

Response structure

The response is a map keyed by issueType (string), where each value is an IssueMetadata object containing:

• issueName: Human-readable short headline for UI display (For example, "Item Out of Stock")
• issueCategory: SEM eligibility impact — BLOCKED (cannot advertise on search engines) or LIMITED (reduced SEM visibility)
• isFixable: Whether the partner can remediate this issue to restore SEM eligibility
• issueDescription: Human-readable description with specific remediation guidance (For example, "Item is out of stock. Add inventory to make the item available.")
• learnMoreUrl: Help link to Walmart-hosted or Google support documentation for step-by-step remediation. May be null for some issue types.

Recommended usage pattern

1. Call this endpoint once on application initialization
2. Cache the result locally (recommended TTL: 24 hours)
3. Use cached metadata to enrich items returned by the POST /item-issues/search endpoint — match each item's issueType to the cached metadata for display name, description, and help links
4. Use isFixable to drive UI affordances: show "Fix Now" buttons for fixable SEM issues, informational badges for non-fixable ones
5. Use learnMoreUrl to deep-link to help documentation for step-by-step remediation guidance
6. Use issueCategory to color-code or badge issues in your UI: red for BLOCKED (cannot advertise), yellow for LIMITED (reduced SEM performance).