API Ahead

Editions

API Ahead · Amazon SP-API — 26 October – 2 November 2026

What changed in the Amazon Selling Partner API between 26 October 2026 and 2 November 2026, and what it means for your code.

12 breaking · 6 silent risk · 21 additive · 2 announcements · 10 API models touched

Category Count
🔴 Breaking 12
🟠 Silent risk 6
🟢 Additive 21
📣 Amazon announcements 2

🔴 Breaking (12)

These will fail loudly. Fix before Amazon enforces them.

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • Enum value(s) removed from Charge.chargeType: GIFT_WRAP, OTHER, PRODUCT, SHIPPING, TOTAL
  • If you send any of these values the request will be rejected. If you store them, historical records may no longer validate.
  • Enum value(s) removed from CreateSandboxShipmentRequest.shippingType: Marketplace, Self
  • If you send any of these values the request will be rejected. If you store them, historical records may no longer validate.
  • Schema DateTime changed type: string -> string(date-time)
  • Generated models for this type are now wrong.
  • Schema Decimal changed type: string -> number
  • Generated models for this type are now wrong.
  • Enum value(s) removed from PackageStatus: CREATED, INVOICE_GENERATED, PICKUP_SLOT_RETRIEVED, SHIPLABEL_GENERATED
  • If you send any of these values the request will be rejected. If you store them, historical records may no longer validate.
  • Type changed on field ShipmentInfo.orderPlacedTimestamp: string -> number(int64)
  • Deserialization will break or silently coerce. Update your models and any casting around this value.

Support / support_2025-02-01

  • Field removed: Case.lastOutboundDate
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Schema removed: CaseFilters
  • Generated client models referencing this type will no longer compile or deserialize.
  • Schema removed: DateFilter
  • Generated client models referencing this type will no longer compile or deserialize.
  • Field removed: ListCasesRequest.caseFilters
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: ListCasesRequest.marketplaceId
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: ListCasesRequest.sortField
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.

🟠 Silent risk (6)

These will NOT fail at deploy time. They fail in production, later, on a subset of records. This is the section that costs people weekends.

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • New enum value(s) in Charge.chargeType: gift_wrap, other, product, shipping, total
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.
  • New enum value(s) in CreateSandboxShipmentRequest.shippingType: MARKETPLACE, SELF
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.

Merchant Fulfillment / merchantFulfillmentV0

  • New enum value(s) in DeliveryExperienceOption: DeliveryConfirmationWithIdentityCheck, DeliveryConfirmationWithNameVerification
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.
  • New enum value(s) in DeliveryExperienceType: DeliveryConfirmationWithIdentityCheck, DeliveryConfirmationWithNameVerification
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.

Notifications / OrderChangeNotification

  • New enum value(s) in OrderChangeNotification.Payload.OrderChangeNotification.OrderChangeType: PreFulfillmentStatusChange
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.

Notifications / notifications

  • New enum value(s) in OrderChangeTypeEnum: PreFulfillmentStatusChange
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.

🟢 Additive (21)

New surface area. Nothing breaks — read only if you're curious.

Action Items / actionItems_2026-06-01

  • New API model published: Action Items / actionItems_2026-06-01

Action Plans / actionPlans_2026-06-01

  • New API model published: Action Plans / actionPlans_2026-06-01

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • Field ComplianceAttributes.countryOfOriginRequirement is now optional
  • New optional field: ComplianceAttributes.hazmatLabelRequirement
  • Field ComplianceAttributes.itemValueRequirement is now optional
  • Field InvoiceInfo.creationDateTime is now optional
  • Field InvoiceInfo.invoiceId is now optional
  • New optional field: Package.trackingDetails
  • Field RecommendedPackage.lineItems is now optional
  • New optional field: ShippingInfo.expectedShippingDateTime
  • New schema: TrackingDetails

Listings Items / listingsItems_2021-08-01

  • New optional field: ItemOfferByMarketplace.quantityDiscountPlan
  • New optional field: ItemOfferByMarketplace.replenishmentDiscount
  • New schema: QuantityDiscountLevel
  • New schema: QuantityDiscountPlan
  • New schema: ReplenishmentDiscount

Messaging / messaging_2026-04-20

  • New API model published: Messaging / messaging_2026-04-20

Notifications / OrderChangeNotification

  • New optional field: OrderChangeNotification.Payload.OrderChangeNotification.Summary.PreFulfillmentStatus

Notifications / notifications

  • New optional field: TrackingIdentifier.proNumber

Services / services

  • New optional parameter: GET /service/v1/serviceJobs :: providerServiceJobReferenceIds
  • New optional field: ServiceJobProvider.providerServiceJobReferenceId

📣 Amazon announcements (2)

What Amazon published in its changelog. Link and date; the summary is ours.

⏳ Upcoming removals (next 90 days)

What Amazon removes in the next 90 days according to its official schedule. Not this week's changes: the reminder so the migration does not catch you out.

Removal Product What goes away
11 November 2026 Report Type Values GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE, GET_V2_SETTLEMENT_REPORT_DATA_XML

Sources: the OpenAPI models and the notification, report and feed schemas Amazon publishes, compared version to version; its official deprecations schedule and its changelog. Every change comes from one of these sources: nothing here is a guess.

API Ahead is free. It tells you what changed in the API.

If you'd rather be told what changed in your repo — the file, the line, and a pull request with the fix — that's what we're building next. Reply and we'll put you on the pilot list.

The OpenAPI models and schemas are © Amazon.com, Inc. or its affiliates, released under the Apache License 2.0. The deprecations schedule and the changelog belong to Amazon's documentation: we link to them and summarize them, never reproduce their content. This newsletter is an independent analysis of those public sources: it is not affiliated with, sponsored by, or endorsed by Amazon. Amazon and Selling Partner API are trademarks of Amazon.com, Inc. or its affiliates.