Developer HubAPI StatusSupport

SP-API Release Notes

Selling Partner API new features, bug fixes, and changelog.

For releases prior to January 19, 2022, see Announcements on the Selling Partner API GitHub repo.

September 20, 2023

API changes

Orders API v0
  • The BuyerCompanyName operation description in the Orders v0 API has been updated to clarify the company name of the destination address.

Documentation updates

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their sunset date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Feeds API v2020-09-04 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
  • Merchant Fulfillment API v0 (Select operations)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
  • Reports API v2020-09-04 (All operations)
Reports
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA

August 16, 2023

API changes

Orders API v0
  • The ShipmentServiceLevelCategory property of the order definition has been updated to include the value Priority. This value is available from the new shipping template available in the France, Spain, Germany, Poland, Netherlands, Sweden, and Belgium marketplaces to support seller-fulfilled Prime orders. If your integration uses the new shipping templates for these regions, you may need to update your integration to accept the Priority value for ShipmentServiceLevelCategory.
Catalog Items API v2022-04-01
  • The generic_keyword attribute is proprietary seller-specific data and will no longer be returned by the Catalog Items API. Selling Partners can use the Listings Items API to view submitted values.

Documentation updates

Deprecation notices

We have adjusted the sunset date for the following APIs:

Calls to these APIs will have a lower throttle rate from Aug 16, 2023 through October 18, 2023. Calls to these APIs will fail on October 18, 2023.

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

June 21, 2023

API changes

Replenishment API
  • New Replenishment API v2022-11-07 returns a selling partner's replenishment program (Subscribe & Save) metrics and offer information. This API is available in the following marketplaces: United States of America, Canada, Brazil, Mexico, United Kingdom, Germany, Spain, Italy, France, Netherlands, United Arab Emirates, India, Japan, and Australia.
Reports API
  • New MARKETPLACE_ASIN_PAGE_VIEW_METRICS report provides information on the ASIN page view (glance view) metrics for the DE, FR, IT, ES, NL, PL, SE and BE (EU-8) marketplaces, with data available up to the last seven days.
Rapid Retail Analytics
Listings Items API
Notifications API
  • New LISTINGS_ITEM_MFN_QUANTITY_CHANGE notification is sent whenever there is change in the available quantity of a listings item.
  • New ORDER_CHANGE notification is sent whenever there is an important change in the order. Important changes include order status changes and buyer requested cancellations. This notification replaces ORDER_STATUS_CHANGE.
  • The B2B_ANY_OFFER_CHANGED notification has been updated to include the Quantity Discount (QD) pricing in the Offer section, with new attributes including multiple quantity tiers, discount type, and price. You can now use this notification to build QD re-pricing solutions, which eliminates the need to use pricing APIs for this purpose.
Rapid Retail Analytics
  • New ITEM_SALES_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares sales data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included when they have orders or cancellations during a given hour. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
  • New ITEM_INVENTORY_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares inventory data at an ASIN level, and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included if the number of units available for purchase by customers has changed. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
  • New DETAIL_PAGE_TRAFFIC_EVENT notification is sent five minutes after the beginning of each hour. This notification shares traffic data at an ASIN level and includes data for the hour before the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs that have glance views are included. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.

Documentation updates

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their sunset date

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

May 17, 2023

API changes

Vendor Direct Fulfillment Shipping v2021-12-28
  • Updated the dynamic sandbox to include the createShippingLabels operation.
Orders V0
  • Sunset the Generic Orders Approvals workflow. Removed ItemApprovalTypes and ItemApprovalStatus attributes.

Documentation updates

Deprecation notices

April 19, 2023

API changes

Fulfillment Outbound API
  • Updated the city property in the address attribute from required to optional.
Fulfillment By Amazon (FBA) Inventory API
  • Updated the sellerSku field to include and parse commas.

Documentation updates

Product Type Definition Meta Schema
  • The Amazon Product Type Definition Meta-Schema (v1) has been updated to include the following keywords: $lifecycle, replacedBy, replaces, enumDeprecated, and enumReplacement.
C# guide updates

Deprecation notices

March 29, 2023

API changes

Fulfillment By Amazon (FBA) Inventory API
  • Update nextToken to expire after 30 seconds.
Orders API
  • Added confirmShipment operation.
Fulfillment Outbound API
  • Updated address attribute to include city.
  • Updated to employ a dynamic sandbox for testing instead of a static sandbox. Includes one new sandbox-only operation.

Documentation updates

Deprecation notices

February 22, 2023

API changes

Merchant Fulfillment API
  • Updated static sandbox mock responses to display names of select UPS domestic (US) ship methods on SP-API.
Orders V0 API
  • Added the following delivery preferences attributes to getOrderAddress to support Amazon Business customer orders:
    • PreferredDeliveryTime
    • BusinessHours
    • OtherAttributes
    • AddressInstructions

These attributes contain information about how and when a package is delivered.

Vendor Direct Fulfillment Orders API
  • The customedURL attribute of buyerCustomizedInfo, returned by the getOrder and getOrders operations, is now a Base 64 encoded URL using the UTF-8 character set.
Vendor Retail Procurement Orders API
  • Updated to pass six-month-past-in-date as a query parameter.

Documentation updates

  • New Amazon Business Orders Use Case Guide introduces operations to obtain information about Amazon Business customers and their delivery preferences.
  • New Sales API Use Case Guide provides sellers with sales performance information. This is achieved through returning aggregated order metrics for a given period of time, broken down by granularity, and buyer type.
  • New FBA Small & Light Use Case Guide introduces operations to help access the Small and Light FBA program.

Deprecation notices

January 25, 2023

API Changes

Product Pricing API
  • New getFeaturedOfferExpectedPriceBatch operation retrieves responses to a batch of up to 40 featured offer expected price (FOEP) requests.
Vendor Direct Fulfillment Orders API
  • New buyerCustomizedInfo attribute, containing buyer information for products the vendor has configured as customizable, specifying the types of customization or configurations along with types and ranges for their product.
Orders API
  • New serialNumber attribute returns a list of serial numbers for electronic products that are shipped to customers. Returned for FBA orders only.
Finances API
  • New financial event type: CapacityReservationBillingEventList allows you to retrieve details related to a Capacity Reservation Billing charge.

Documentation updates

Deprecation notices

December 6, 2022

API Changes

Catalog Items API

The Catalog Items v2022-04-01 API has been updated to include several additional attributes in the summary to bring the Catalog Items API to parity with the Marketplace Web Services Catalog Items section:

In addition, the following attributes have been added to ItemSummaryByMarketplace:

  • adultProduct
  • autographed
  • memorabilia
  • releaseDate
  • tradeInEligible

November 9, 2022

API Changes

Reports API

  • New GST Merchant Tax Report B2B GET_GST_MTR_B2B_CUSTOM provides detailed information about sales, refunds, and cancellations from Amazon Business invoices issued within a date range that you specify. Only available in the India Marketplace.

  • New GST Merchant Tax Report B2C GET_GST_MTR_B2C_CUSTOM provides detailed information about sales, refunds, and cancellations from consumer invoices issued within a date range that you specify. Only available in the India Marketplace.

  • New GST Merchant Stock Transfer Report GET_GST_STR_ADHOC provides details on inventory movements from Amazon Fulfillment Centers (FC removals or FC to FC transfers). The report contains transaction level details required for accounting and GST tax filing. Only available in the India Marketplace.

Documentation updates

October 19, 2022

API Changes

Notifications API

Updated for new FBA_INVENTORY_AVAILABILITY_CHANGES notification that is sent whenever there is a change in the Fulfillment By Amazon (FBA) inventory quantities. This notification includes a snapshot of the FBA inventory in all eligible marketplaces in a particular region.

Reports API

  • Updated GET_SALES_AND_TRAFFIC_REPORT, which now includes B2B traffic data regarding traffic originating from Amazon Business customers. As of 08/28/2022 B2B conversion metrics have changed to use the new B2B traffic data. Data before 08/28/2022 is set to zero to avoid confusion.

  • New Subscribe and Save Forecasting report GET_FBA_SNS_FORECAST_DATA provides an eight-week forecast of sales based on existing subscriptions and sales history.

  • New Subscribe and Save Performance report GET_FBA_SNS_PERFORMANCE_DATA provides a trailing four-week view of items shipped, percentage of orders missed due to being out of stock, average post-discount sale price, and average discount for each SKU.

Documentation updates

September 21, 2022

API Changes

Vendor Direct Fulfillment Shipping API v2021-12-28
  • Updated for new createShippingLabels synchronous operation that creates shipping labels for a purchase order and returns the labels. Note that the createShippingLabels operation does not have any sandbox support at this time.
  • Updated for production and dynamic sandbox support for all of the equivalent Vendor Direct Fulfillment Shipping V1 operations.
Tokens API v2021-03-01
  • Updated for the following restricted operations to support Vendor Direct Fulfillment Shipping API v2021-12-28:
    • createShippingLabels
    • getPackingSlip
    • getCustomerInvoice
    • getShippingLabel
Reports API v2021-06-30
  • Updated Inventory Ledger Report (GET_LEDGER_DETAIL_VIEW_DATA) now includes a new eventType filter to filter on particular warehouse events.

Documentation updates

August 10, 2022

API Changes

Orders V0 API
  • Improvements to the Orders API in support of Easy Ship shipments.
Services V1 API
  • Updated for new getRangeSlotCapacity operation that provides capacity slots in a format similar to availability records.
  • Updated for new getFixedSlotCapacity operation that provides fixed capacity slots.

May 18, 2022

API Changes

Catalog Items API
  • New Catalog Items API version 2022-04-01 improves the API experience and addresses developer feedback with the following changes:
    • Added identifier-based searches to the searchCatalogItems operation, enabling batch-like requests with up to 20 identifiers per request (ASINs, UPCs, EANs, etc.)
    • Added dimensions data set, providing normalized item and package dimensions
    • Added display names for product category, product subcategory, and browse classification
    • Expanded identifying attributes to item summaries (item classification, package quantity, part number, website display group)
    • Added browse classifications and website display groups to sales ranks
    • Aligned searchCatalogItems and getCatalogItem operations to use the same data sets, including attributes
    • Replaced variations with relationships to allow for multiple relationship types to be represented, such as package hierarchies
    • Added variation theme details (name to the relationships details)
Notifications API
  • Added a processingDirective parameter that lets you pass additional information to the subscription to control the processing of notifications. This parameter is used by the ANY_OFFER_CHANGED notification.
  • Updated the ANY_OFFER_CHANGED notification to support filtering notifications to only specific marketplaceIds, and limiting notifications to one every five or ten minute interval.
Orders API
  • Updated to include support for the Purchase Shield program that manages regulated orders in the UK. Regulated orders are a limited set of orders that fulfill products requiring a prescription (pet medication, prescription contacts, and prescription glasses). Two new operations have been added: getOrderRegulatedInfo and updateVerificationStatus.
  • New IsAccessPointOrder attribute to support identifying MFN (fulfilled by seller) orders that have been shipped to access point (AP) hubs.
Product Fees API
  • Updated for new getMyFeesEstimates operation that retrieves product fee estimates for a list of products and marketplaces.
Product Pricing API
  • Updated for new getItemOffersBatch and getListingOffersBatch operations that retrieve product pricing and offer information in a list for products.
Reports API

April 13, 2022

API Changes

Easy Ship API
  • New Easy Ship API helps you build applications that help sellers manage and ship Amazon Easy Ship orders.
FBA Inventory API
  • Updated FBA Inventory API for global availability and released new FBA Inventory Use Case Guide.
Notifications API
  • New PRICING_HEALTH notification is sent whenever a seller offer is ineligible to be the Featured Offer (Buy Box offer) because of an uncompetitive price.
  • New FulfillmentChannel property in the ORDER_STATUS_CHANGE notification that allows you to filter order status change notifications based on whether the order is fulfilled by Amazon (AFN) or fulfilled by seller (MFN).
Vendor Direct Fulfillment APIs

Documentation updates

March 23, 2022

API Changes

Orders API
  • New buyerRequestedCancel parameter provides information on whether a buyer requested order cancellation and reason for cancellation.
Reports API

New Seller retail analytics reports

  • New Sales and Traffic Business Report helps you manage your analytics better by providing key sales performance metrics such as ordered product sales, revenue, units ordered, and claim amount, as well as page traffic metrics such as page views and buy box percentage of the seller’s entire catalog of items aggregated by date and ASIN. This report requires the Brand Analytics Selling Partner API role which is now available to all sellers.

New Performance reports

  • New Coupons Performance Report helps you optimize your promotions and adjust your advertising strategies. The report includes campaign-level details (total clips, redemptions) and coupon-level details (start/end date, clips, redemptions, and budget information). Available to vendors who have the Brand Analytics Selling Partner API role.

New Vendor retail analytics reports

  • New Vendor Sales Report helps you manage your inventory better by providing key retail sales metrics such as ordered/shipped revenue and units. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Traffic Report helps you manage your inventory better by providing key retail traffic metrics such as detail page views. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Forecasting Report helps you manage your inventory better by providing forward looking mean, P70, P80, and P90 weekly customer demand forecasts. The forecasting system produces forecasts for an ASIN at various P-levels, also known as confidence levels. If you are setting a forecasting P-level of .80 ("P80"), it means that there is an 80% probability customer demand will not exceed the weekly forecasted units. Data is reported at the ASIN level for the most recent weekly forecast generation date. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Inventory Health Report 2.0 helps you manage your inventory better by providing inventory and operational health metrics such as sellable on hand units and vendor confirmation rate. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across week, month, quarter, and year reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.

Documentation update for Invoice data reports

  • Flat File VAT Invoice Data Report and XML VAT Invoice Data Report are now available in documentation. These reports are for sellers enrolled in Amazon’s VAT Calculation Service and who opt to upload their own invoices.

Documentation updates

  • New Migration Hub page aggregates all Amazon MWS to Selling Partner API migration-related timelines, planned deprecation dates, and resources into a single reference page.

  • New Selling Partner API Blog site includes articles from Amazon Solutions Architects and API experts covering a range of topics including customer stories, migration, best practices, tips and tricks, and much more.

January 19, 2022

API Changes

Fulfillment Inbound

  • New error code PRODUCTASSURANCE_SAFETYDOCUMENTATION returned for non-compliant products that do not have safety compliance documentation. This error code is returned for the following operations:
    • CreateInboundShipmentPlan
    • CreatInboundShipment
    • UpdateInboundShipment
    • PreviewItemEligibility

Read more about this change on GitHub or Seller Central.

Orders API

  • New buyerTaxInformation attribute for the Turkey Marketplace. This attribute includes business tax information when the buyer is a business.

Notifications API

  • New Order Status Change notification is sent whenever there is a change in the status of order availability.

Reports API

  • New FBA Manage Inventory Health Report helps you manage your inventory better by providing a consolidated view across your sales (7, 30, 60, and 90 days), shipment statuses (working, received, and shipped), estimated storage and long-term storage fees, and aged and excess units. This report includes metrics across sales, inbound, estimated fees, and recommended actions.
  • New On Demand Stock Transfer Report that provides transaction level information like invoice value, invoice number, tax rate, and Goods and Services Tax Identification Numbers (GSTINs) for interstate movement transactions.

Documentation updates

Amazon MWS to Selling Partner API Migration Guide

Updated 7 days ago