SP-API Competitive Summary Operation Getting Enum Value Changes — Update Before June 2025
Amazon's Product Pricing API (v2022‑05‑01) will add a new "DEFAULT" value to the customerMembership enum and rename the offerType enum from "CONSUMER" to case‑sensitive "Consumer". The sandbox reflects these changes on March 28 2025 and the live endpoint enforces them on June 6 2025 across all marketplaces.
Overview
Amazon is adding two enum adjustments to the getCompetitiveSummary operation of the Product Pricing API (v2022‑05‑01). A new DEFAULT customer‑membership tier will appear alongside PRIME and NON_PRIME, and the offerType value will shift from the all‑caps CONSUMER to the case‑sensitive Consumer. The changes will be staged beginning March 28, 2025, with full production enforcement on June 6, 2025, and they affect every Amazon marketplace. Sellers and developers who rely on competitive‑pricing data must adapt now to keep their tools functional.
Key Points
- New enum entry —
customerMembershipwill returnDEFAULTwhen a buyer’s membership does not fit the existingPRIMEorNON_PRIMEcategories. - Case‑sensitive fix —
offerTypechanges fromCONSUMERtoConsumer; any hard‑coded uppercase reference will cause an API error. - Global impact — Both updates apply to all Amazon sites, from .com to .co.uk and .in.
- Phased rollout — Model updates are expected in the sandbox by March 28, 2025; the live endpoint will enforce the new values on June 6, 2025.
- Risk of silent failures — Parsing logic that only expects two membership values may drop rows or misclassify offers once
DEFAULTappears.
What's Changing
- Add DEFAULT to customerMembership — When a competitive offer is generated for a buyer whose status cannot be classified as Prime or non‑Prime, the API will now include
"customerMembership":"DEFAULT"in the JSON payload. Example: A response that previously read"customerMembership":"NON_PRIME"for a new‑account buyer may now return"customerMembership":"DEFAULT". - Rename CONSUMER to Consumer — The field inside each entry of the array will be capitalized as instead of . : An earlier payload snippet will become after the June rollout.
Analysis & Recommendations
Why This Matters
Competitive pricing feeds drive repricing algorithms and Buy Box eligibility. An unhandled "DEFAULT" membership or the wrong case for "Consumer" will generate API errors or drop rows, leading to inaccurate pricing data during the mid‑year sales peak.
Key Takeaways
- A new enum entry "DEFAULT" is added to customerMembership, effective June 6 2025.
- The offerType enum changes from "CONSUMER" to "Consumer" (case‑sensitive) on June 6 2025.
- Sandbox responses will include the new values starting March 28 2025.
- Database ENUM columns must be altered to include "DEFAULT" to avoid insert failures.
Recommended Actions
- →Update parsing code (e.g., Python pydantic models) to include "DEFAULT" in the Literal for customerMembership; commit changes in your repo.
- →Search all code for "CONSUMER" in getCompetitiveSummary requests/responses and replace with "Consumer"; verify via SP‑API console.
- →In MySQL, run ALTER TABLE to add 'DEFAULT' to the customerMembership ENUM and test in the sandbox before June 6 2025.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!