Skip to main content
All CollectionsData SourcesAmazon
Amazon Selling Partner API (SP-API) Release Notes
Amazon Selling Partner API (SP-API) Release Notes
Openbridge Support avatar
Written by Openbridge Support
Updated over a week ago

The Amazon Selling Partner API (SP-API) enables developers to build applications that help selling partners programmatically exchange data on listings, orders, payments, reports, and more.

Amazon Seller

Amazon Vendor Central

These release notes highlight the latest features, API updates, and documentation improvements. SP-API continues to expand capabilities for sellers and vendors to help drive efficiency and growth.

API Changes

Fulfillment Inbound API v2024-03-20

  • New feature: View and select one of the available delivery windows for a shipment to arrive at an Amazon facility

  • New feature: Print labels for individual items

  • Select Partnered Carrier as an option for your less-than-truckload (LTL) shipments

  • Update the name of inbound plans and shipments

  • Update the quantity of units of a SKU after shipment confirmation

  • Add three new mandatory operations: confirmDeliveryWindowOptions, generateDeliveryWindowOptions, and listDeliveryWindowOptions

Deprecation Notices

  • Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the Deprecations table.

  • The following operations in Fulfillment Inbound API v0 are no longer deprecated:

    • getShipments

    • getShipmentItemsByShipmentId

    • getShipmentItems

May 22, 2024

API Changes

Product Pricing API v2022-05-01

  • Added the lowestPricedOffers and referencePrices attributes to provide the top 20 lowest priced offers and reference prices.

  • The Tutorial: Retrieve a list of featured offers for a batch of up to 20 ASINs in the Use Case Guide uses two new attributes: lowestPricedOffers and referencePrices.

  • Added the Price adjustment automation workflows guide outlining how to leverage the API and Pricing notifications to automate pricing management.

  • Added the Product pricing API and notifications FAQ.

Catalog Items API v2022-04-01

  • Added a new includedData query parameter option classifications which replaces the deprecated MWS GetProductCategoriesForSKU and GetProductCategoriesForASIN operations. Sellers and vendors can use classifications to browse classification trees assigned to an ASIN.

Feeds API v2021-06-30

  • The Order feeds attributes POST_ORDER_FULFILLMENT_DATA and POST_FLAT_FILE_FULFILLMENT_DATA are updated with a new field: ship-from-supply-source-id.

Deprecation Notices

  • Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. Refer to the Deprecations table for dates.

April 24, 2024

API Changes

Orders API v0

  • Added the CompanyName attribute.

  • Updated the rate limit for getOrder, getOrderAddress, and getOrderBuyerInfo from .0167 to .5 and increased the burst from 20 to 30.

  • Updated the IsBuyerRequestedCancel, IsGift and NumberOfItems object types from boolean/integer to string.

  • Updated getOrders to return AutomatedCarrier and AutomatedShipMethod attributes.

Easy Ship API v2022-03-23

  • Updated the license from Amazon Software License to Apache License 2.0.

  • Added 413 HTTP code to each operation's possible responses.

Report Schema Changes

  • Added lastUpdatedDate field to several Vendor reports.

Vendor Central Marketplace Expansion to Ireland (IE)

  • On April 23rd, 2024, Vendor Central launched support for Ireland (IE) Marketplace. See SP-API Vendor Central URLs, SP-API Endpoints, and Marketplace IDs for details.

Documentation Changes

  • The Orders API v0 Use Case Guide now notes orders more than 2 years old are not returned, with some marketplace exceptions.

Deprecation Notices

  • Deprecated SP-API resources will no longer receive technical support. Calls to deprecated SP-API resources will fail on their removal date. See Deprecations table for details.

    • Fulfillment Inbound API v0 (Select operations)

    • Feeds

    • Notifications

    • POST_PRODUCT_DATA

    • and more...

April 1, 2024

API Changes

Fulfillment Inbound v2024-03-20

  • Early access to the new API which supports FBA Inbound shipment creation and multiple inbound placement service options.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Fulfillment Inbound API v0 (Select operations)

    • Feeds

March 20, 2024

API Changes

Shipping API v2

  • Added AdditionalAddressNotes, NdrAction, NdrRequestData, SubmitNdrFeedbackRequest to the ndrFeedback parameter.

  • Added tutorial for Using the ndrFeedback API to submit Non-Delivery Reports.

  • Added LiquidVolume, IsHazmat, DangerousGoodsDetails attributes to the Item object.

Merchant Fulfillment API v0

  • Updated to include support for the UK Marketplace Asin Page View Metric report. See Regulatory Compliance Report Type Values.

Reports API v2021-06-30

  • Added Request and retrieve a bulk invoice report for Multi-Channel Fulfillment (MCF) orders for India tutorial. Allows downloading GST invoices in batch for delivered MCF orders.

Notifications API v1

  • Updated FEED_PROCESSING_FINISHED and REPORT_PROCESSING_FINISHED to include support for vendors with new accountId property. Applies to all marketplaces.

Fulfillment Outbound v2020-07-01

  • Added PaymentInformation attribute, required for India but optional elsewhere.

  • Added tutorial on creating an MCF order for India.

Documentation Changes

  • Added Python and Javascript SDK client libraries and tutorials.

  • Reformatted Report Type Values pages and consolidated report type attributes.

Deprecation Notices

  • Deprecated SP-API resources are no longer in active development. Calls will fail on the removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Fulfillment Inbound API v0 (Select)

    • Feeds

    • Reports

    • Notifications

February 21, 2024

API Changes

Reports API v2021-06-30

  • New Report Type Value EndUserDataReport provides personal customer data for transactions in EU-8 marketplaces.

Application Management API

  • Promoted from Public Beta to Production. Lets you programmatically rotate LWA credentials.

Documentation Updates

  • Added six new code tutorials on previewing, creating, and canceling orders.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Feeds

    • Reports

    • Notifications

January 31, 2024

API Changes

Listings Items API v2021-08-01

  • Added validation mode for putListingsItem and patchListingsItem using mode=VALIDATION_PREVIEW to validate without persisting data.

  • Added ShipsInProductPackaging to PrepInstruction enum returned in prepInstructions response.

  • Added ExtendedFields and AddressExtendedFields for Brazil addresses with extended fields.

Fulfillment By Amazon (FBA) Inventory API

  • Updated nextToken to expire after 30 seconds.

Orders API v0

  • Added confirmShipment operation.

  • Updated address attribute to include city.

  • Updated to employ a dynamic sandbox for testing. Includes one new sandbox operation.

Documentation Updates

  • Added Orders API Use Case Guide for confirmShipment.

  • Added Fulfillment Outbound API Dynamic Sandbox use case guide.

  • Expanded library of reports schemas on GitHub.

  • Added Listings Items API FAQ, issues troubleshooting, and guidance for complex attributes.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on their removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Feeds

    • Reports

    • Notifications

December 13, 2023

API Changes

Application Management API v2023-11-30 Public Beta

  • New API lets you programmatically rotate LWA credentials.

Shipping API v2

  • Launched support for dangerous goods (DG) shipping in US and UK.

Listings Items API v2021-08-01

  • India (IN) now a supported marketplace

  • Two new fields added to Issue object: Enforcements and Categories

  • searchDefinitionsProductTypes updated to string

Notifications API v1

  • Added optional payloadVersion parameter

Documentation Updates

  • Building Listings Management Workflows Guide updated with steps to retrieve recommendations using itemName or keywords.

  • Vendor Direct Fulfillment Orders API v1 Use Case Guide updated for customer data transmission. Some fields replaced with XXXXX for Amazon label vendors.

  • Vendor Retail Procurement APIs v1 Use Case Guide updated for SubmitShipments and GetShipmentDetails.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Fulfillment Inbound API v0 (Select)

    • Merchant Fulfillment API v0 (Select)

    • Feeds

    • Reports

    • Notifications

November 8, 2023

API Changes

Supply Sources API v2020-07-01

  • New API configures and updates info on seller supply sources like stores and warehouses.

Product Pricing API v2022-05-01

  • United Kingdom now a valid marketplace.

  • getFeaturedOfferExpectedPriceBatch (FOEP) extended to Amazon.co.uk.

  • ASIN_NOT_ELIGIBLE now a value for resultStatus.

  • New competitiveSummary returns featured buying options summary for ASIN and marketplaceId.

Product Type Definitions API v2020-09-01

  • Updated for 3 new parameters (itemName, locale, searchlocale) and 1 new displayName product type.

Finances API v0

  • Updated ListFinancialEvent and ListFinancialEventGroups to clarify expected responses and scope.

  • Modified ChangeRefundTransactions response from object to array.

Vendor Direct Fulfillment Shipping API v2021-12-28 and v1

  • Updated weight field now mandatory to generate error on shipmentconfirmations so vendors don't wait for transaction status error.

Documentation Updates

  • New Multi-Location Inventory (MLI) Integration guide on using APIs for integration with MLI.

  • Updated Building Listings Management Workflows Guide for retrieving recommendations using itemName or keywords.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Fulfillment Inbound API v0 (Select)

    • Merchant Fulfillment API v0 (Select)

    • Reports

    • Notifications

October 11, 2023

API Changes

Listings Items API 2021-08-01

  • Updated ItemProcurement data element from object to array.

Orders API v0

  • Added list of associated items to getOrderItems response.

Product Pricing API v0

  • Renamed listingPrice attribute in getItemOffers to help avoid B2B errors. Landedprice and Shipping now optional.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Feeds API v2020-09-04 (All)

    • Fulfillment Inbound API v0 (Select)

    • Merchant Fulfillment API v0 (Select)

    • Reports API v2020-09-04 (All)

    • Notifications

September 20, 2023

API Changes

Orders API v0

  • Updated BuyerCompanyName description to clarify company name of destination address.

Documentation Updates

  • Building Listings Management Workflows Guide updated for using Listings Items API to create package hierarchies.

Deprecation Notices

  • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.

    • Authorization API v1 (All)

    • FBA Small and Light API v1 (All)

    • Feeds API v2020-09-04 (All)

    • Fulfillment Inbound API v0 (Select)

    • Merchant Fulfillment API v0 (Select)

    • Reports API v2020-09-04 (All)

August 16, 2023

API Changes

Orders API v0

  • Updated ShipmentServiceLevelCategory to include Priority value for seller-fulfilled Prime in select EU marketplaces. Update integration if needed.

Catalog Items API v2022-04-01

  • generic_keyword attribute no longer returned. Use Listings Items API to view submitted values.

Documentation Updates

  • New Welcome topic with migration/integration resources, search tips, quick links.

  • New and improved developer registration topics.

Deprecation Notices

  • Adjusted removal date for Feeds API v2020-09-04 and Reports API v2020-09-04 to Oct 18, 2023. Lower throttle Aug 16 - Oct 18. Calls fail Oct 18. See Deprecations table for details.

June 21, 2023

API Changes

Replenishment API

  • New API returns selling partner's replenishment metrics and offer info. Available in US, CA, BR, MX, UK, DE, ES, IT, FR, NL, AE, IN, JP, AU.

Reports API

  • New EPR Monthly, Quarterly, Annual Reports for Extended Producer Responsibility declarations in FR, DE.

  • New Rapid Retail Analytics reports:

    • GET_VENDOR_REAL_TIME_SALES_REPORT - hourly ASIN-level sales data

    • GET_VENDOR_REAL_TIME_TRAFFIC_REPORT - hourly detail page traffic data

    • GET_VENDOR_REAL_TIME_INVENTORY_REPORT - hourly ASIN-level inventory data

Listings Items API

  • Now available in Belgium (BE)

Notifications API

  • New LISTINGS_ITEM_MFN_QUANTITY_CHANGE for changes in available quantity of listings item

  • New ORDER_CHANGE for important order changes. Replaces ORDER_STATUS_CHANGE.

  • Updated B2B_ANY_OFFER_CHANGED to include Quantity Discount pricing in Offer section.

  • New ITEM_SALES_EVENT_CHANGE sent 5 min after each hour with hourly ASIN sales data.

  • New ITEM_INVENTORY_EVENT_CHANGE sent 5 min after each hour with hourly ASIN inventory data.

  • New DETAIL_PAGE_TRAFFIC_EVENT sent 5 min after each hour with ASIN traffic data from prior hour.

Rapid Retail Analytics

  • New MARKETPLACE_ASIN_PAGE_VIEW_METRICS report on glance view metrics for EU-8 market places.

    Documentation Updates

    • New Migrating Listings Management Workflows guide for migrating from XML/flat file feeds to Listings Items API and JSON feeds.

    • Updated reports schemas repo with GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU and GET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON

    Deprecation Notices

    • SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date.

      • ORDER_STATUS_CHANGE

      • MFN_ORDER_STATUS_CHANGE

      • Feeds API v2020-09-04

      • Reports API v2020-09-04 See Deprecations table for details.

    May 17, 2023

    API Changes

    Vendor Direct Fulfillment Shipping v2021-12-28

    • Updated to include createShippingLabels synchronous operation to create and return shipping labels for a PO. No sandbox support currently.

    • Updated for production and dynamic sandbox support for all equivalent v1 operations.

    • Updated restricted operations to support v2021-12-28.

    Orders V0

    • Removed Generic Orders Approvals workflow, ItemApprovalTypes, and ItemApprovalStatus.

    Documentation Updates

    • New Reports attributes directory lists available report attributes.

    • New Vendor Retail Procurement FAQ.

    Deprecation Notices

    • Feeds API v2020-09-04

    • Reports API v2020-09-04

    • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN

    • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN

    April 19, 2023

    API Changes

    Fulfillment Outbound API

    • Updated city property in address from required to optional.

    Fulfillment By Amazon (FBA) Inventory API

    • Updated sellerSku to parse commas.

    Documentation Updates

    • Amazon Product Type Definition Meta-Schema (v1) updated with new keywords.

    • Added two new C# guides for SDK generation and authentication.

    Deprecation Notices

    • Feeds API v2020-09-04

    • Reports API v2020-09-04

    March 29, 2023

    API Changes

    Fulfillment By Amazon (FBA) Inventory API

    • New error code PRODUCTASSURANCE_SAFETYDOCUMENTATION for non-compliant products without safety docs. Returned on CreateInboundShipmentPlan, CreateInboundShipment, UpdateInboundShipment, PreviewItemEligibility.

    Orders API

    • New buyerTaxInformation for Turkey Marketplace with business tax info.

    Notifications API

    • New Order Status Change notification for changes in order availability status.

    Reports API

    • Updated GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA report with corrected column names. See FBA Report Types.

    • FBA_BULK_INVOICE report shares seller invoices in date range, including customer orders.

    Documentation Updates

    • New use case directories map APIs, notifications, reports to seller and vendor use cases.

    • SP-API models table shows API availability for sellers/vendors with links to reference and release notes.

    • New Vendor Direct Fulfillment Orders v2021-23-28 and Transaction Status v2021-12-28 use case guides.

    • Updated dynamic usage plans topic for Product Pricing API and getFeaturedOfferExpectedPriceBatch.

    Deprecation Notices

    • Feeds API v2020-09-04

    • Reports API v2020-09-04

    • FBA Inventory Reports

    • MFN_ORDER_STATUS_CHANGE Notification

    February 22, 2023

    API Changes

    Merchant Fulfillment API

    • Updated to use a dynamic sandbox for testing instead of static. Includes one new sandbox operation.

    Orders V0 API

    • New buyerRequestedCancel parameter for buyer cancellation requests and reasons.

    Reports API

    • New Sales and Traffic Business Report with key sales and traffic metrics by date and ASIN. Requires Brand Analytics role, now available to all sellers.

    • New Coupons Performance Report with campaign and coupon-level promo details. For vendors with Brand Analytics role.

    • New vendor retail analytics reports, available to vendors with Brand Analytics role:

      • Vendor Sales Report - key retail sales metrics at aggregate and ASIN level by time period

      • Vendor Traffic Report - key retail traffic metrics at aggregate and ASIN level by time period

      • Vendor Forecasting Report - 8 week mean, P70, P80, P90 demand forecasts at ASIN level

      • Vendor Inventory Health Report 2.0 - inventory and operational metrics at aggregate and ASIN level by time period

    Documentation Updates

    • Documentation update for Flat File and XML Invoice Data Reports for VAT Calculation Service sellers.

    • New Migration Hub page with MWS to SP-API timelines, deprecation dates, resources.

    • New SP-API Blog with articles from Amazon experts.

    Deprecation Notices

    • Feeds API v2020-09-04

    • Reports API v2020-09-04

    January 19, 2022

    API Changes

    Reports API

    • The new FBA Manage Inventory Health Report has a consolidated view of sales, shipments, fees, aged/excess units, and recommended actions.

    • A new On Demand Stock Transfer Report with invoice details and GSTINs for interstate movement is needed.

    Documentation Updates

    • Updated Amazon MWS to SP-API Migration Guide with more resources like video series and AWS Quick Start.

Did this answer your question?