--- updatedAt: 2026-11-04T20:32:45.000Z agentTools: siteIndex: https://developer-docs.amazon/llms.txt projectIndex: https://developer-docs.amazon/sp-api/llms.txt --- # SP-API Release Notes Selling Partner API new features, software updates, and changelog. *For releases prior to January 19, 2022, refer to [Announcements](https://github.com/amzn/selling-partner-api-models/discussions/categories/announcements) in the [Selling Partner API GitHub repo](https://github.com/amzn/selling-partner-api-models).* ## November 4, 2026 #### Documentation changes * Added the [What is Shop Direct](https://developer-docs.amazon/sp-api/docs/shop-direct) guide. This guide explains how Shop Direct makes a merchant's products discoverable to Amazon customers through searches and detail pages. When a customer selects a Shop Direct product, Shop Direct redirects them to the merchant's website to complete the purchase. Shop Direct merchants retain control over inventory, pricing, order fulfillment, and customer service. *** ## October 28, 2026 #### API changes ##### [Action Items API v2026-06-01](https://developer-docs.amazon/sp-api/reference/action-items-v2026-06-01) * Launched the Action Items API. You can use this API to examine recommendations, tasks, and issues identified by Amazon. ##### [Action Plans API v2026-06-01](https://developer-docs.amazon/sp-api/reference/action-plans-v2026-06-01) * Launched the Action Plans API. You can use this API to create plans to address Action Items for sellers. ##### [Messaging Automations v2026-04-20](https://developer-docs.amazon/sp-api/reference/messaging-automations-v2026-04-20) * Launched the Messaging Automations API. You can use this API to programmatically manage automated buyer-seller messaging configurations. ##### [External Fulfillment Shipping v2024-09-11](https://developer-docs.amazon/sp-api/reference/external-fulfillment-shipping-v2024-09-11) * Added the `trackingDetails` field to the `package` response parameter. You can use this field to retrieve tracking details for packages. ##### [Listings Items API v2021-08-01](https://developer-docs.amazon/sp-api/reference/listings-items-v2021-08-01) * Added quantity discounts to the `Offers` view of the `getListingsItem` operation. You can use the new quantity discount fields to retrieve the active quantity-based pricing available for a listing. ##### [Merchant Fulfillment API v0](https://developer-docs.amazon/sp-api/reference/merchant-fulfillment-v0) * Added the `DeliveryConfirmationWithIdentityCheck` and `DeliveryConfirmationWithNameVerification` enum values to the `DeliveryExperience` and `DeliveryExperienceOption` enums. You can use these options to request delivery confirmation with recipient identity or name verification for supported shipments. ##### [Notifications v1](https://developer-docs.amazon/sp-api/reference/notifications-v1) * Added the `PreFulfillmentStatusChange` value to the [`OrderChangeType`](https://developer-docs.amazon/sp-api/docs/notification-type-values#order_change) notification schema and the `OrderChangeTypeEnum` in the Notifications API. Selling partners using Amazon Automotive can use this value to track changes to an order's pre-fulfillment status, such as a seller action still pending or an order being rejected before fulfillment. * Added the `proNumber` field to `TrackingIdentifier`. The Progressive rotating order (PRO) number is assigned by the freight carrier, and you can use it to track a shipment. ##### [Services v1](https://developer-docs.amazon/sp-api/reference/services-v1) * Added the `providerServiceJobReferenceIds` query parameter to the `getServiceJobs` operation. You can use this parameter to filter services by the service provider's job reference identifiers. This enables service providers to view their job details and provide updates on the job. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon/sp-api/docs/sp-api-deprecations). *** ## September 30, 2026 #### API changes ##### [Finance Remittance API v2026-03-17](https://developer-docs.amazon/sp-api/reference/finance-remittance-v2026-03-17) * Launched the Finance Remittance API, which you can use to programmatically retrieve vendor payment remittance data. The API provides payment and deduction details, associated invoices, dates, and identifiers, including invoice payments, deductions, vendor returns, and advertising transactions. You can use this API to access the same remittance data that is available in Vendor Central without manually exporting reports. ##### [Support API v2025-02-01](https://developer-docs.amazon/sp-api/reference/support-v2025-02-01) * Launched the Support API. You can use this API to programmatically retrieve information about a selling partner's Amazon support cases, allowing you to monitor issues within your application and implement fixes from Selling Partner Support more quickly. ##### [A+ Content API v2020-11-01](https://developer-docs.amazon/sp-api/reference/a-content-management-v2020-11-01) * Added support for the 19 Premium A+ content modules and five Brand Story content modules through the same operations used for Standard A+ Content. * Added the `createMedia`, `getMedia`, and `updateMedia` operations. You can use these operations to create image and video media assets, retrieve media metadata and related pairings, and update media titles and accessibility descriptions used by Premium video modules. ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon/sp-api/reference/data-kiosk-v2023-11-15) * Added the [Seller Analytics dataset](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/data-kiosk/analytics_sellerAnalytics_2025_03_31.graphql). Use the Seller Analytics dataset to access information including sales, traffic, promotions, account health, search, reviews, defects, and returns. * Updated the Analytics Economics dataset with deal, coupon, removal, disposal, and fuel fees. ##### [Delivery By Amazon API v2022-07-01](https://developer-docs.amazon/sp-api/reference/delivery-by-amazon-v2022-07-01) * Added the `invoiceId` query parameter to the `getInvoiceStatus` operation. You can use this parameter to retrieve an invoice. ##### [Feeds API v2021-06-30](https://developer-docs.amazon/sp-api/reference/feeds-v2021-06-30) * Added static sandbox test scenarios for the [`POST_FLAT_FILE_FBA_CREATE_REMOVAL`](https://developer-docs.amazon/sp-api/docs/fulfillment-by-amazon-feed-type-values#flat-file-fba-create-removal-feed) feed type. You can use these scenarios to test the full removal order feed lifecycle (create feed, get feed status, and get feed document) against outcomes that include `DONE`, `FATAL`, and `IN_PROGRESS`, without submitting live feeds. ##### [Fulfillment Outbound API v2026-07-04](https://developer-docs.amazon/sp-api/reference/fulfillment-outbound-v2026-07-04) * Added a new JSON schema for the `FULFILLMENT_ORDER_STATUS` notification. The schema provides detailed shipment and package-level status updates, which helps you track fulfillment order progress with greater granularity. ##### [Invoices API v2024-06-19 (Brazil Only)](https://developer-docs.amazon/sp-api/reference/invoices-v2024-06-19-brazil-only) * Added the `warehouseCode` query parameter to tax invoices endpoints. This parameter enables you to retrieve invoices on behalf of vendors. ##### [Listings Items API v2021-08-01](https://developer-docs.amazon/sp-api/reference/listings-items-v2021-08-01) * Added PRODUCT-level and LISTING-level issue classification to the `categories` attribute in issue descriptions returned by the `getListingsItem` and `searchListingsItems`. You can use this to identify whether an issue originates from the ASIN (product level) or the SKU (listing level). ##### [Notifications V1](https://developer-docs.amazon/sp-api/reference/notifications-v1) * Launched the `TAX_INVOICE_EXPORT_STATUS_CHANGE` notification type. Sellers can subscribe to this notification type to receive real-time updates when the status of a tax invoice export request changes. * Launched the `TAX_INVOICE_ISSUANCE_ELIGIBILITY_STATUS_CHANGE` notification type. Sellers can subscribe to this notification type to receive real-time updates when the eligibility status for a seller's tax invoice issuance operation changes. * Launched the `TAX_INVOICE_ISSUANCE_STATUS` notification type. Sellers can subscribe to this notification type to receive real-time updates when the status of a tax invoice issuance changes, including error details when issuance fails. ##### [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01) * Added the `asin` and `purchasePrice` fields to the `AssociatedOrderItem` object in the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations. You can use these fields to identify an order item and the purchase price, excluding shipping, tax, gift wrap, and promotions. * Added the `WARRANTY` value to the `associationType` field in the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations. You can use this value to identify whether a warranty plan covers an item, including plans purchased from a different seller in the same customer order. * Added the `promiseCalculationInputs` field to the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations. This field returns the carrier information used to calculate an order's promise date. ##### [Tracking API v2026-01-30](https://developer-docs.amazon/sp-api/reference/tracking-v2026-01-30) * Added the `proNumber` query parameter to the `getShipmentTracking` operation. The PRO (progressive rotating order) number is assigned by the freight carrier, and you can use it to track a shipment. ##### [Vendor Direct Fulfillment Payments v1](https://developer-docs.amazon/sp-api/reference/vendor-direct-fulfillment-payments-v1) The following changes apply only to EU stores: * Added the `billFromParty`, `vatGroupParty`, and `taxRepresentativeParty` fields to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use these fields to identify the invoice issuer, VAT group representative, and fiscal or tax representative required for EU e-invoice interoperability. * Added the `shipToParty` field to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use this field to provide the full ship-to address when it's required in addition to `shipToCountryCode`. * Added the `taxPointDate` and `deliveryDate` fields to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use these fields to report the date when the tax becomes chargeable and the date of delivery or service completion. * Added the `invoiceBaseAmount` and `exchangeRate` fields to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use these fields to report the invoice's net line-item total and the currency exchange rate applied when amounts are shown in a foreign currency. * Added the `allowanceDetails` array at both the invoice and line-item level to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use this array to report allowance amounts, such as discounts or promotional allowances, and their associated tax details. * Added the `itemDescription` field to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use this field to provide a product or service description for an invoiced line item. * Added the `additionalDetails` array at the line-item level to the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation, and added the `TaxExemptReason`, `LegalTerms`, and `RegulatoryNote` values to its `type` enum. You can use these values to report a VAT exemption reason, other applicable legal terms, or a regulatory note for a line item. * Added the `additionalPartyIdentifications` array to party objects in the [`submitInvoice`](https://developer-docs.amazon/sp-api/reference/submitinvoice) operation. You can use this array, along with the new `AdditionalPartyIdentification` schema, to report additional corporate or fiscal identifiers, such as the French SIREN number or the German Wirtschafts-Identifikationsnummer (W-IdNr.), that aren't VAT or GST registrations. * Added the `LocalTaxNumber` value to the `TaxRegistrationDetail.type` enum. You can use this value to report a local tax number issued by a tax office, such as Germany's Steuernummer. ##### [Vendor Invoices v1](https://developer-docs.amazon/sp-api/reference/vendor-invoices-v1) The following changes apply only to EU stores: * Added the `billFromParty`, `vatGroupParty`, and `taxRepresentativeParty` fields to the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation. You can use these fields to identify the invoice issuer, VAT group representative, and fiscal or tax representative required for EU e-invoice interoperability. * Added the `invoiceBaseAmount` and `taxPointDate` fields to the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation. You can use these fields to report the invoice's net line-item total and the date when the tax becomes chargeable. * Added the `itemDescription` field to the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation. You can use this field to provide a product or service description for an invoiced line item. * Added the `additionalDetails` array at the line-item level to the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation, and added the `TaxExemptReason`, `LegalTerms`, and `RegulatoryNote` values to its `type` enum. You can use these values to report a VAT exemption reason, other applicable legal terms, or a regulatory note for a line item. * Added the `additionalPartyIdentifications` array to party objects in the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation. You can use this array, along with the new `AdditionalPartyIdentification` schema, to report additional corporate or fiscal identifiers, such as the French SIREN number or the German Wirtschafts-Identifikationsnummer (W-IdNr.), that aren't VAT or GST registrations. * Added the `LocalTaxNumber` value to the `TaxRegistrationDetails.type` enum. You can use this value to report a local tax number issued by a tax office, such as Germany's Steuernummer. * Added the `originalInvoiceDate` field to `CreditNoteDetails` in the [`submitInvoices`](https://developer-docs.amazon/sp-api/reference/submitinvoices) operation. You can use this field, alongside `referenceInvoiceNumber`, to report the date of the original invoice that a credit note references. #### Documentation changes * Updated the [Get all Amazon Business orders guide](https://developer-docs.amazon/sp-api/docs/get-all-amazon-business-orders) to explain how to identify orders that require pallet delivery. The guide explains how to use the `palletDelivery` field in [Orders API](https://developer-docs.amazon/sp-api/reference/orders-v2026-01-01) responses and Order Reports to identify these orders and route them to the appropriate freight or LTL fulfillment process. * Added a new guide that explains how to [submit product listings using Amazon's modular title structure](https://developer-docs.amazon/sp-api/docs/submit-modular-titles). The guide covers how to provide title content using the `item_name` and `title_differentiation` (Item Highlights) attributes when you create or update listings through the API. * The [Selling Partner API Code Samples](https://developer-docs.amazon/sp-api/recipes) page will be removed on **October 28, 2026**. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon/sp-api/docs/sp-api-deprecations). *** ## August 26, 2026 #### API changes ##### [Promotions API v2025-12-01](https://developer-docs.amazon/sp-api/reference/promotions-v2025-12-01) * Launched the new Promotions API, which you can use to search, retrieve, and manage promotions. The Promotions API supports multiple promotion types: deals, coupons, price discounts, and basket building promotions. You can use it to programmatically monitor promotion status, review item selections, and identify validation issues. ##### [Reports v2021-06-30](https://developer-docs.amazon/sp-api/reference/reports-v2021-06-30) * Added the `promotionsApiMappingId` field to the `GET_COUPON_PERFORMANCE_REPORT` and `GET_PROMOTION_PERFORMANCE_REPORT` report types. Sellers and vendors can use this field to cross-reference performance report data with promotions managed through the [Promotions API](https://developer-docs.amazon/sp-api/reference/promotions-v2025-12-01). #### Documentation changes * Added the [Seller Authorizations FAQ](https://developer-docs.amazon/sp-api/docs/seller-authorizations-faq). * Updated the [Security and Compliance Best Practices Guide](https://developer-docs.amazon/sp-api/docs/best-practices) to reflect new and revised requirements in the Data Protection Policy (DPP), Acceptable Use Policy (AUP), and Solution Provider Portal Agreement. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon/sp-api/docs/sp-api-deprecations). *** ## August 5, 2026 #### API changes ##### [Tracking API v2026-01-30](https://developer-docs.amazon/sp-api/reference/tracking-v2026-01-30) * Launched the new Tracking API with one operation available in the US store. The `getShipmentTracking` operation allows sellers and vendors to retrieve tracking details for a shipment as it moves through Amazon’s supply chain. For more information, refer to [Tracking API](https://developer-docs.amazon/sp-api/docs/tracking-api). ##### [Notifications V1](https://developer-docs.amazon/sp-api/reference/notifications-v1) * Launched the `SHIPMENT_TRACKING_MILESTONE_CHANGED` notification type. Sellers and vendors can subscribe to this notification type to receive real-time tracking updates for a shipment as it moves through Amazon's supply chain. For more information, refer to the [Subscribe to shipment tracking notifications](https://developer-docs.amazon/sp-api/docs/subscribe-to-shipment-tracking-notifications) tutorial. * Added support for the `SHIPMENT_TRACKING_MILESTONE_CHANGED` notification type to `eventFilterType` in the `getSubscription` operation. You can use the new corresponding `TrackingFilter` schema to specify a tracking identifier when subscribing to this notification type. #### Documentation changes * Added the [Retrieve multi-shipment package tracking details](https://developer-docs.amazon/sp-api/docs/retrieve-package-tracking-details) guide for Fulfillment Outbound API. This guide explains how to retrieve tracking information for all packages in a Multi-Channel Fulfillment order. * Added the [Retrieve delivery tracking information](https://developer-docs.amazon/sp-api/docs/retrieve-delivery-tracking-information) guide for Fulfillment Outbound API. This guide explains how to get delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment order. * Added the [Track a partially fulfilled order](https://developer-docs.amazon/sp-api/docs/track-partially-fulfilled-order) guide for Fulfillment Outbound API. This guide explains how to track a partially fulfilled order for items that are low inventory. * Added the [Track Delivery and Handle Order Outcomes](https://developer-docs.amazon/sp-api/docs/track-delivery-handle-outcomes) guide for Fulfillment Outbound API. This guide explains how to track the delivery of an order and manage different situations. *** ## July 29, 2026 #### API changes ##### [Invoices API v2026-06-25](https://developer-docs.amazon/sp-api/reference/invoices-v2026-06-25) * Launched the new Invoices API. You can use the Invoices API to retrieve invoice data programmatically and streamline your bookkeeping processes. The Invoices API enables you to search for invoices within a specified date range, track invoice payment status, and retrieve detailed line-item information for reconciliation with purchase orders. For more information, refer to [Invoices API](https://developer-docs.amazon/sp-api/docs/invoice-api). ##### [Finances v2024-06-19](https://developer-docs.amazon/sp-api/reference/finances-v2024-06-19) * Added the [`listSummary`](https://developer-docs.amazon/sp-api/reference/listsummary) operation that enables you to retrieve a financial summary for a date range or settlement * Added the [`listBalances`](https://developer-docs.amazon/sp-api/reference/listbalances) operation that enables you to retrieve a current or past balance. * Added the `SETTLEMENT_ID` value for the `relatedIdentifierName` query parameter for the [`listTransactions`](https://developer-docs.amazon/sp-api/reference/listtransactions) operation. You can use this value to filter transactions by their settlement ID. ##### [Fulfillment Inbound v2024-03-20](https://developer-docs.amazon/sp-api/reference/fulfillment-inbound-v2024-03-20) * Added an optional `discounts` field to the [`listDeliveryWindowOptions`](https://developer-docs.amazon/sp-api/reference/listdeliverywindowoptions) response with discount incentives for delivery window options. This enables you to view available discounts as you select delivery windows that have the `DISCOUNTED` availability type. ##### [Fulfillment Outbound v2026-07-04](https://developer-docs.amazon/sp-api/reference/fulfillment-outbound-v2026-07-04) * Launched a new version of the Fulfillment Outbound API. This new version supports granular dynamic sandbox controls, multi-tenant authorization, async processing support, among other improvements. Refer to [Fulfillment Outbound Migration Guide](https://developer-docs.amazon/sp-api/docs/fulfillment-outbound-migration-guide) for more information. ##### [Listings Items API v2021-08-01](https://developer-docs.amazon/sp-api/reference/listings-items-v2021-08-01) * Updated the `marketplaceIds` parameter in the [`getListingsItem`](https://developer-docs.amazon/sp-api/reference/getlistingsitem) and [`searchListingsItems`](https://developer-docs.amazon/sp-api/reference/searchlistingsitems) operations to accept multiple `marketplaceIds` within the same region. You can use these operations to retrieve listings data across multiple stores in a single request. For more information, refer to [Retrieve details about a listing for single or multiple Amazon stores](https://developer-docs.amazon/sp-api/docs/retrieve-details-about-a-listing). ##### [Orders API v2026-01-01](https://developer-docs.amazon/sp-api/reference/orders-v2026-01-01) * Added the `cancellationExecution` object to the `getOrder` and `searchOrders` operations. You can use this object to learn how a cancellation was processed for a specific order item, including which entity processed the cancellation and why. * Added the `fulfillment.labelPrintingWindow` response parameter to the `getOrder` and `searchOrders` operations. You can use this parameter to view the earliest time available for printing an order's shipping label. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon/sp-api/reference/product-pricing-v2022-05-01) * Added the `promotions` array to the [`getCompetitiveSummary`](https://developer-docs.amazon/sp-api/reference/getcompetitivesummary) operation. You can use this array to retrieve live promotion details, including promotion type, discount and savings information, and eligibility requirements for `Coupon`, `Deal`, and `Basket_Building` promotions. ##### [Transfers v2024-06-01](https://developer-docs.amazon/sp-api/reference/transfers-v2024-06-01) * Added the [`listPayouts`](https://developer-docs.amazon/sp-api/reference/listpayouts) operation that enables you to retrieve payouts by date or settlement. * Added the [`listExpectedPayouts`](https://developer-docs.amazon/sp-api/reference/listexpectedpayouts) operation that enables you to retrieve expected payouts from Amazon that are associated with a selling partner's account. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon/sp-api/docs/sp-api-deprecations). *** ## May 27, 2026 #### API changes ##### [Notifications API v1](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * Added the `filterExpression` field to the [`createSubscription`](https://developer-docs.amazon.com/sp-api/reference/createsubscription) operation. You can use this field to filter events before notification delivery. Filters are applied to the notification payload using Common Expression Language (CEL) syntax. * Added `DeliveryTipChange` as a supported order change type to the `OrderChangeType` notification schema. You can use this to track the status of a delivery tip for an order. ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) The following updates apply to veterinary products: * Added the `approvedAlternativeDetails` field to the `VerificationDetails` object in the [`updateVerificationStatus`](https://developer-docs.amazon.com/sp-api/reference/updateverificationstatus) operation. You can use this field to submit pre-approved alternative product attributes. * Added the `interimStatusDetail` field to the `VerificationDetails` object in the [`updateVerificationStatus`](https://developer-docs.amazon.com/sp-api/reference/updateverificationstatus) operation. You can use this field to provide granular progress updates while an order is pending verification to indicate that a veterinarian has been contacted. * Added the `ValidInterimStatusCodes` field to the `RegulatedOrderVerificationStatus` object in the [`getOrderRegulatedInfo`](https://developer-docs.amazon.com/sp-api/reference/getorderregulatedinfo) response. This field returns the list of supported interim status codes and customer-facing descriptions that you can use when you provide an `interimStatusDetail`. ##### [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01) * Added the `breakdowns` array to the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations. You can use this attribute to show an order's proceeds breakdown, including delivery tip information. * Added the `FULFILLMENT_ORDERS` value to the `includedData` parameter in the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations. You can use this attribute to view the fulfillment ID for Easy Ship orders. ##### [Product Type Definitions API v2020-09-01](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01) * Added the optional `parentageLevel` query parameter to retrieve schemas for a specific listing parentage level. You can use this parameter to retrieve simplified schema requirements for standalone, variation child, or variation parent listings types. To learn how to use this parameter in your listings workflows, refer to the updated [Retrieve a Product Type Definition](https://developer-docs.amazon.com/sp-api/docs/retrieve-a-product-type-definition#parentagelevel-parameter) and [Configure related Listings Items](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide#configure-related-listings-items-variations-package-hierarchies) guides. ##### [Replenishment v2022-11-07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) * Added the optional `filter` attribute to the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) and [`getSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics) operations. You can use this `filter` to narrow metrics results by attributes such as `asins`, `skus`, `fulfillmentChannelTypes`, `brandNames`, `uniqueItems`, and `productGroups`. * Added `DAY` as a new aggregation frequency for the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) and [`getSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics) operations. You can use this aggregation to retrieve day-level metrics for intervals of up to 31 days. ##### [Services API v1](https://developer-docs.amazon.com/sp-api/docs/services-api) * Updated the [`getServiceJobByServiceJobId`](https://developer-docs.amazon.com/sp-api/reference/getservicejobbyservicejobid) operation to include vehicle information in the response, when relevant. Each element of the `associatedItems` array that is a vehicle has this information in the `linkedAssets` array. * Updated the [`getServiceJobs`](https://developer-docs.amazon.com/sp-api/reference/getservicejobs) operation with the `productOrderIds` and `trackingIds` query parameters. You can use these parameters to find service jobs that use the products with the given product order IDs or tracking IDs. You can retrieve `productOrderIds` and `trackingIds` from the response to the [`getServiceJobs`](https://developer-docs.amazon.com/sp-api/reference/getservicejobs) operation. #### Documentation changes * Added Industry Vertical Pricing (IVP) audience values to the [Listings Items API guide](https://developer-docs.amazon.com/sp-api/docs/manage-amazon-haul-advanced-multiple-offer-multiple-fulfillment-use-cases#multiple-offers-with-b2b). Eligible third-party sellers in the US store can use IVP audience values in the `purchasable_offer.audience` field. * Added the [Create and Filter Notifications Subscription](https://developer-docs.amazon.com/sp-api/docs/filter-notification-subscriptions) guide for the Notifications API. This guide explains how to create subscriptions with filter expressions that control which event notifications you receive. You can use the `filterExpression` field to specify a Common Expression Language (CEL) expression that evaluates each event payload and returns only events that match your criteria. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## April 29, 2026 #### API changes ##### [External Fulfillment Shipping v2024-09-11](https://developer-docs.amazon.com/sp-api/reference/external-fulfillment-shipping-v2024-09-11) * Added support for the Easy Ship program for US domestic shipments. * Added drop-off location details, such as the address, map URL, and distance, for shipments that the seller delivers to nearby drop-off locations. * Added support for US customary units. ##### [Fulfillment Outbound v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Updated the [`getPackageTrackingDetails`](https://developer-docs.amazon.com/sp-api/reference/getpackagetrackingdetails) operation with two new `eventCode` values to support locker delivery: * `EVENT_801`: Package delivered to locker. * `EVENT_804`: Package picked up from locker. ##### [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01) * Added `TAX` and `PAYMENT` attributes to the [`getOrders`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) and [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operations to address discrepancies between Orders v0 and Orders v2026-01-01. These discrepancies include `Order.PaymentExecutionDetail`, `Order.PaymentMethod`, `Order.PaymentMethodDetails`, `Order.IsIBA`, `Order.ElectronicInvoiceStatus`, `Order.BuyerInvoicePreference`, `Order.BuyerTaxInformation`, `Order.MarketplaceTaxInfo`, `Order.SellerDisplayName`, `Order.BuyerInfo.BuyerTaxInfo`, `OrderItem.TaxCollection`, `OrderItem.DeemedResellerCategory`, `OrderItem.SerialNumberRequired`, and `OrderItem.AssociatedItems`. #### Documentation changes * Added pricing validation details to the [Listings Items API](https://developer-docs.amazon.com/sp-api/docs/manage-listings-issues) and [Product Pricing API](https://developer-docs.amazon.com/sp-api/docs/price-adjustment-automation-workflows-guide) guides. This feature allows users to detect and fix pricing problems before submission or production impact. * Added the attribute updates to [Orders API Migration Guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-migration-guide) and [Access Orders PII](https://developer-docs.amazon.com/sp-api/docs/access-orders-pii) guide. * Added the [Get Tax Information](https://developer-docs.amazon.com/sp-api/docs/get-tax-information) guide for the Orders API. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## April 1, 2026 #### API changes ##### [FBA Inbound Eligibility API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inbound-eligibility-v1) * Added the `FBA_INB_0465` enum value to the `ineligibilityReasonList` in the [`getItemEligibilityPreview`](https://developer-docs.amazon.com/sp-api/reference/getitemeligibilitypreview) operation. You can use this value to better understand why a product is not eligible to inbound using the manufacturer’s barcode. ##### [Feeds v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * Added the optional query parameter `enableContentEncodingUrlHeader` to the `GetFeedDocument` operation. You can use this parameter to allow automatic decompression by HTTP clients. ##### [Product Pricing API v2022\_05\_01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added the `similarItems` array to the Product Pricing API. You can use this array to identify comparable products for a given ASIN and Amazon store, enabling better pricing decisions. ##### [Replenishment API v2022\_11\_07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) * Updated the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) operation to return metrics at the offer level instead of the ASIN level. You can use this operation to gain more detailed insights into Subscribe & Save performance across SKUs and fulfillment channels. * Added `SKU` and `fulfillmentChannelType` fields to the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) response. You can use these fields to track performance at the offer level across `AMAZON` and `MERCHANT` fulfillment channels. * Updated the [`listOffers`](https://developer-docs.amazon.com/sp-api/reference/listoffers) operation to support inventory and delivery health filtering, sorting, and enriched offer details. You can use this operation to filter offers by delivery condition (paused, at-risk, or healthy), sort by inventory or price, and monitor stock levels and delivery health to better manage Subscribe and Save offers. * Added the `REVENUE_PENETRATION` metric to [`getSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics) operation. You can use this metric to measure the percentage of program revenue against total product revenue. ##### [Reports v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Added the optional query parameter `enableContentEncodingUrlHeader` to the `getReportDocument` operation. You can use this parameter to allow automatic decompression by HTTP clients. ##### [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1) * Added the `payments` array to the [`getServiceJobByServiceJobId`](https://developer-docs.amazon.com/sp-api/reference/getservicejobbyservicejobid) response. This array lists the amounts to collect from customers during deliveries. #### Documentation changes * Added a new guide for [general troubleshooting of SP-API errors](https://developer-docs.amazon.com/sp-api/docs/troubleshoot-sp-api-errors). * Added comprehensive guidance for troubleshooting [HTTP and authorization errors](https://developer-docs.amazon.com/sp-api/docs/resolve-common-http-and-authorization-error-codes). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## February 23, 2026 #### API changes ##### [Data Kiosk v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * Added B2B refund metrics, feedback metrics, and claim-related metrics to business reports at both the `ByDate` and `ByAsin` levels to the Analytics Sales and Traffic dataset v2024-04-24. ##### [Fulfillment Outbound v2020-07-01 API](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added the `MAIL_ROOM_CLERK` and `AS_INSTRUCTED` values to the `DropOffLocation` enum in the [`GetFulfillmentOrder`](https://developer-docs.amazon.com/sp-api/reference/getfulfillmentorder) operation. For the `RECEPTIONIST`, `MAIL_ROOM_CLERK`, and `AS_INSTRUCTED` types, the `attributes` object now includes a `recipientName` field containing the name of the person who received the package. You can use these new values to represent attended delivery scenarios where packages are handed to a mail room clerk or delivered according to recipient instructions. * Added the ability to request Ships in Product Packaging (SIPP) and packing slip preferences when creating MCF orders. For more information, refer to [Create an MCF Order that Ships in Product Packaging](https://developer-docs.amazon.com/sp-api/docs/create-mcf-sipp-order). ##### [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * **Applicable only to `JSON_LISTINGS_FEED`** Updated the time when `JSON_LISTINGS_FEED` status shows 'DONE' and you receive the [FEED\_PROCESSING\_FINISHED](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#feed_processing_finished) notification for the `JSON_LISTINGS_FEED`. The feed status now changes to `DONE` and the notification is triggered only after all processing is complete, providing more accurate completion logs. Processing times remain unchanged. If you have automated the workflows that depends on this notification, review them to mitigate potential impact. This change does not affect your ability to submit subsequent feeds according to current rate limits. For more information, refer to the [Listings Management Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## January 28, 2026 #### API changes ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * Updated the Analytics Sales and Traffic dataset to include B2B refund metrics, feedback metrics, and claim-related metrics for Business Reports at both the `ByDate` and `ByAsin` levels. ##### [Finances v0](https://developer-docs.amazon.com/sp-api/reference/finances-v0) * Financial events can now contain an `EBTRefundReimbursementOnlyEventList`, which is a list of EBT refund reimbursement events. EBT payments require that all transactions are between the seller and the customer. Because of this requirement, Amazon refunds the seller, and then the seller refunds the customer. This applies to the Amazon US store. ##### [Finances v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) * Updated the `listTransactions` operation to filter by order ID, a unique identifier for an order. The order ID filter can be used to get the list of all transactions associated with an order. To use this filter, set the `relatedIdentifierName` query parameter to `ORDER_ID` and the `relatedIdentifierValue` parameter to the order ID. ##### [Invoices v2024-06-19](https://developer-docs.amazon/sp-api/reference/invoices-v2024-06-19-brazil-only) * Added the `createGovernmentInvoice`, `getGovernmentInvoiceStatus`, and `getGovernmentInvoiceDocument` operations. These operations allow Brazilian sellers who use Fulfillment by Amazon (FBA) the ability to use the Invoices APIs for inbound shipments. This applies only to the Amazon Brazil store. ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Removed the `BuyerEmail` parameter from Fulfillment by Amazon (FBA) orders. Merchant Fulfilled Network (MFN) orders now require the Direct-to-Consumer Shipping role to access this field. Sellers should use the Buyer Communication role for the Messaging API to contact buyers after purchase. ##### [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01) * Launched a new version of the Orders API. The Orders API v2026-01-01 simplifies ten operations into two: `getOrder` and `searchOrders`. The `getOrder` operation retrieves complete order and item information in a single request. This reduces the number of requests that are needed and improves throttling. #### Documentation changes * Added the Orders API [migration guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-migration-guide) to assist with migration from the Orders API v0 to the new Orders API v2026-01-01. For more information about the Orders API v0 deprecation, refer to the [deprecation schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). * Added the [Get recommended browse nodes or item type keywords](https://developer-docs.amazon.com/sp-api/docs/get-recommended-browse-nodes-or-item-type-keywords) tutorial for the Product Type Definitions API. This tutorial explains how to use the `getDefinitionsProductType` operation to retrieve new enumerated values for `item_type_keyword` (US) and `recommended_browse_nodes` (other Amazon stores) for a product type. You can use these values to ensure your products appear in the correct browse path with Amazon-recommended classifications. * Added the [Multi-store PATCH feature for the Listings Items API and the JSON Listings Feed](https://developer-docs.amazon.com/sp-api/docs/listings-items-api) tutorial. This tutorial explains how to update prices across multiple Amazon stores in a single request using the `PATCH` replace operation with the `purchasable_offer` attribute within a region. You can specify different Amazon stores by using the `marketplace_id` parameter within each offer object, which streamlines price management across regions and reduces the number of API calls required to update the pricing information. * Updated the `FulfillmentChannel` field in all [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) sample responses from `SellerFulfilled` to `MFN` to match the actual API response. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## December 22, 2025 #### API changes ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * Removed the `FNSKU` value from the `ProductIdentifierGranularity` enum of the [Analytics Economics](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/data-kiosk/analytics_economics_2024_03_15.graphql) dataset. ##### [Replenishment API v2022-11-07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) * Added `SUBSCRIBER_LIFETIME_VALUE_BY_CUSTOMER_SEGMENT` and `SIGNUP_CONVERSION_BY_SELLER_FUNDING` to [`GetSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics). These metrics provide additional insights into subscriber value and conversion performance. * Added new customer lifetime value and signup conversion metrics to the `GetSellingPartnerMetricsResponseMetric`. These metrics help you measure revenue contribution by subscriber segment and evaluate the impact of seller-funded discounts. These new metrics are only supported in the Amazon US store. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## December 3, 2025 #### API changes ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * Added the `lostFeaturedOffer` to the `Traffic` data in the [Vendor Analytics dataset](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/data-kiosk/analytics_vendorAnalytics_2024_09_30.graphql), available in the `manufacturingView` query. This value provides the percentage of product page views where your offer is not the Featured Offer. It is equal to the number of glance views where your item is not the Featured Offer divided by the total number of glance views. ##### [Delivery By Amazon API v2022-07-01](https://developer-docs.amazon.com/sp-api/docs/delivery-by-amazon-api) * Added the `SelfShip` value to the `ProgramType` enum. You can use this enum value to submit invoices for orders that sellers deliver directly to customers. ##### [External Fulfillment Shipping API v2024-09-11](https://developer-docs.amazon.com/sp-api/reference/external-fulfillment-shipping-v2024-09-11) * Added the `reason` attribute to the `getShipments` and `getShipment` response. You can use this response to retrieve the corresponding reason for each shipment’s `subStatus`. The reasons provide customers with more granular insight into why a shipment was marked as delivered or undelivered. ##### [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * Updated the [`JSON_LISTINGS_FEED`](https://github.com/amzn/selling-partner-api-models/tree/main/schemas/feeds) to include the `SKU` in the issues section. This change adds the `SKU` to the processing report to map issues back to the input in a more convenient way. ##### [Finances API v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) * Updated the `listTransactions` operation to filter by `FinancialEventGroupId`, a unique identifier for the financial event group. To use this filter, set the `relatedIdentifierName` query parameter to `FINANCIAL_EVENT_GROUP_ID`. Set the `relatedIdentifierValue` parameter to the `FinancialEventGroupId` retrieved from the Finances API v0 `listFinancialEventGroups` operation. ##### [Fulfillment Inbound v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * Added `DISCOUNTED` and `BLOCKED` as possible `availabilityType` values, which describe the type of delivery window. A `DISCOUNTED` delivery window has an incentive for choosing it. A `BLOCKED` delivery window is unavailable for scheduling. This affects the [`listDeliveryWindowOptions`](https://developer-docs.amazon.com/sp-api/reference/listdeliverywindowoptions) and [`getShipment`](https://developer-docs.amazon.com/sp-api/reference/getshipment) operations. You will not be able to select delivery windows with `BLOCKED` status after **February 28, 2026**. * Updated delivery windows. All delivery windows will be set to one calendar week, a set of seven days starting on Sunday and ending on Saturday. Priority processing applies to shipments that arrive in their delivery window. Shipments arriving outside their delivery window may experience delays. ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Removed the `amazonFulfillmentTrackingNumber` query parameter. For tracking-related queries, use the `packageNumber` query parameter with the [`getpackagetrackingdetails`](https://developer-docs.amazon.com/sp-api/reference/getpackagetrackingdetails) to retrieve shipment tracking information. ##### [Seller Wallet API v2024-03-01](https://developer-docs.amazon.com/sp-api/reference/seller-wallet-v2024-03-01) * Updated the `CreateTransaction` request fields to include `payeeContactInformation`. This information is required when the `bankAccountOwnershipType` in the request is set to `THIRD_PARTY`, and is used to support mandatory payee verification and registration processes. ##### [Vendor Direct Fulfillment Shipping API v1](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v1) * Added new fields to support regulatory compliance requirements. These updates include: * `lotNumberSourceReference` for FDA Food Safety Modernization Act (FSMA 204) compliance. * `lotNumberSourceType` for FDA Food Safety Modernization Act (FSMA 204) compliance. * `countryOfOrigin` to support product origin tracking. * `regulationReferences` object to capture EU Due Diligence Regulation (EUDR) compliance data, including reference numbers, verification codes, and exemption details. #### Documentation changes * Added the [Manage Listings Issues](https://developer-docs.amazon.com/sp-api/docs/manage-listings-issues) guide. This guide explains how to identify, retrieve, and troubleshoot Listings issues. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## October 1, 2025 #### API changes ##### [Data Kiosk v2023-11-15](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-api) * Added the `customerReviews` and `customerReturnTopics` metrics to the [Vendor Analytics Data Kiosk dataset](https://developer-docs.amazon.com/sp-api/docs/vendor-analytics-dataset-guide). These metrics provide information about customer reviews and reasons for returns. ##### External Fulfillment APIs * Added the [External Fulfillment Inventory](https://developer-docs.amazon.com/sp-api/docs/external-fulfillment-inventory), [External Fulfillment Returns](https://developer-docs.amazon.com/sp-api/docs/external-fulfillment-returns), and [External Fulfillment Shipping](https://developer-docs.amazon.com/sp-api/docs/external-fulfillment-shipping) APIs. These APIs allow programmatic handling of inventory, returns, and shipping across multiple external fulfillment channels, including Seller Flex, Easy Ship, Self Ship, and MFN Self Delivery. ##### [Fulfillment Outbound v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added the ability to request signature confirmation upon delivery. To require a signature from the recipient upon delivery, set `featureName` to `SIGNATURE_CONFIRMATION` in the `createFulfillmentOrder` request. This is only supported in the Amazon US store. ##### [Merchant Fulfillment v0](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0) * Added the `ShippingService.AdjustmentItemList` array to the [`getEligibleShippingServices`](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0#geteligibleshipmentservices) operation. You can use this array to view the Fulfilled by Merchant (FBM) Ship+ cashback amounts. * Added the `ShippingService.RateWithAdjustments` field to the [`getEligibleShippingServices`](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0#geteligibleshipmentservices) operation. You can use this field to see the carrier charge without cashback. * Added the `FBM_SHIP_PLUS` flag to `ShippingService.Benefits.IncludedBenefits` in the [`getEligibleShippingServices`](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0#geteligibleshipmentservices) operation. You can use this flag to identify shipping methods that are eligible for the FBM Ship+ benefits. ##### [Orders v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Updated the [`getOrderAddress`](https://developer-docs.amazon.com/sp-api/reference/getorderaddress) operation’s `Name` response attribute from required to optional. ##### [Vendor Direct Fulfillment Orders v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-orders-v2021-12-28) * Added the `hasCustomizableItems` response attribute to the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-2) and [`getOrders`](https://developer-docs.amazon.com/sp-api/reference/getorders-2) operations. You can use this attribute to determine if an order has customizable items. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## August 27, 2025 #### API changes ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * **Analytics Sales and Traffic v2024-04-24**: The `analytics_salesAndTraffic_2024_04_24` dataset now offers the `salesAndTrafficTrends` query, which provides ASIN-level trend analysis, and combines existing by-ASIN and by-date views to provide daily, weekly, or monthly metrics for specific ASINs over time. ##### [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) The `sourceAddress` property used in the requests to [`createInboundPlan`](https://developer-docs.amazon.com/sp-api/reference/createinboundplan) and [`updateShipmentSourceAddress`](https://developer-docs.amazon.com/sp-api/reference/updateshipmentsourceaddress) now includes the `districtOrCounty` property. This change allows you to use the [Fulfillment Inbound API](https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-api) to create shipments in the Amazon TR store. The `districtOrCounty` property is included in the address values returned by the following operations: * [listInboundPlans](https://developer-docs.amazon.com/sp-api/reference/listinboundplans) * [getInboundPlan](https://developer-docs.amazon.com/sp-api/reference/getinboundplan) * [getShipment](https://developer-docs.amazon.com/sp-api/reference/getshipment) ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * The [`getFulfillmentOrder`](https://developer-docs.amazon.com/sp-api/reference/getfulfillmentorder) operation now returns the `amazonFulfillmentTrackingNumber` property. You can use this property in your request to the [`getPackageTrackingDetails`](https://developer-docs.amazon.com/sp-api/reference/getpackagetrackingdetails) operation to track Multi-Channel Fulfillment (MCF) packages. ##### [Product Fees API v0](https://developer-docs.amazon.com/sp-api/reference/product-fees-v0) * Removed the `itemPrice` field from the `previewContext` attribute. * Updated the `feeTransactionId` operation’s response from `feeTransactionContext` to `transactionContext`. ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Added the `unitOnTimeDeliveryRate` response attribute to the [Seller Performance report](https://developer-docs.amazon.com/sp-api/docs/report-type-values-performance#seller-performance-report)(`GET_V2_SELLER_PERFORMANCE_REPORT`). You can use this attribute to get a seller's on-time delivery rate at a unit level within a reporting date range for one Amazon store that you specify. This metric is only available in the Amazon US store. ##### [Seller Wallet API v2024-03-01](https://developer-docs.amazon.com/sp-api/reference/seller-wallet-v2024-03-01) * The [Seller Wallet API](https://developer-docs.amazon.com/sp-api/docs/seller-wallet-api) is now publicly available in the NA and EU regions. #### Documentation changes * Added the [Amazon listing status and seller-fulfilled inventory management](https://developer-docs.amazon.com/sp-api/docs/understanding-amazon-listing-status-and-seller-fulfilled-inventory-management) guide. This guide explains how to manage your Amazon product listings and inventory with the Selling Partner APIs. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) The following dataset will be removed on February 26, 2026: * `analytics_salesAndTraffic_2023_11_15` ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports-api) The following report type values will be removed on December 11, 2025: * `GET_FBA_SNS_FORECAST_DATA` * `GET_FBA_SNS_PERFORMANCE_DATA` ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) The following operation will be removed on September 30, 2025: * `CompetitivePriceThreshold` *** ## June 25, 2025 #### API changes ##### [Customer Feedback API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/customer-feedback-v2024-06-01) * The new [Customer Feedback API](https://developer-docs.amazon.com/sp-api/reference/customer-feedback-v2024-06-01) retrieves insights from customer reviews and returns. This API provides the same information as the Product Opportunity Explorer on Seller Central and Vendor Central. For more information, refer to the [Customer Feedback API v2024-06-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/customer-feedback-api-v2024-06-01-use-case-guide). ##### [Finances API v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) * The [`listTransactions`](https://developer-docs.amazon.com/sp-api/reference/listtransactions) operation now identifies Amazon Haul transactions. If a transaction is an Amazon Haul transaction, the value of the `storeName` property in the `listTransactions` response is `AMAZON_HAUL`. * The [`listTransactions`](https://developer-docs.amazon.com/sp-api/reference/listtransactions) operation of the Finances API v2024-06-19 can now filter by transaction status. Include the `transactionStatus` query parameter in your request and set it to the status of transaction you want included in the response. Possible values are `RELEASED`, `DEFERRED`, and `DEFERRED_RELEASED`. ##### [Fulfillment Inbound API](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * The following operations in the Fulfillment Inbound API now have a rate limit of five requests per second, up from their previous limit of two requests per second: * [`getShipment`](https://developer-docs.amazon.com/sp-api/reference/getshipment) * [`listShipmentBoxes`](https://developer-docs.amazon.com/sp-api/reference/listshipmentboxes) * [`listDeliveryWindowOptions`](https://developer-docs.amazon.com/sp-api/reference/listdeliverywindowoptions) * [`listTransportationOptions`](https://developer-docs.amazon.com/sp-api/reference/listtransportationoptions) * [`getInboundOperationStatus`](https://developer-docs.amazon.com/sp-api/reference/getinboundoperationstatus) * [`getLabels`](https://developer-docs.amazon.com/sp-api/reference/getlabels) (Fulfillment Inbound API v0 operation) ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added the `FBM_SHIP_PLUS` value for the `AmazonPrograms` response object of the [`getOrderItems`](https://developer-docs.amazon.com/sp-api/reference/getorderitems) operation. You can use this value to determine if an order item is part of the FBM Ship+ program. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added the `CompetitivePrice` value to the [`getCompetitiveSummary`](https://developer-docs.amazon.com/sp-api/reference/getcompetitivesummary) operation. You can use this value to determine featured offer eligibility based on the lowest price recently found at a reputable retailer outside of the Amazon store. ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Updated the [Search Query Performance Report](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#search-query-performance-report) to include the ability to query a space-separated list of ASINs. #### Documentation changes * Added the granular [rate limit throttle messages](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-rate-limits#throttle-error-messages) for the Listings Items API. * Released the prebuilt SDK for C#. For more information, refer to [SP-API SDKs](https://developer-docs.amazon.com/sp-api/docs/sp-api-sdks). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports-api) The following report type values will be removed on December 11, 2025: * `GET_FBA_SNS_FORECAST_DATA` * `GET_FBA_SNS_PERFORMANCE_DATA` ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) The removal date for the following Feeds type values has changed from June 30, 2025 to July 31, 2025. * `POST_PRODUCT_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_UIEE_BOOKLOADER_DATA` For more information, refer to [Migrating product feeds workflows](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide). * The following operation in the [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) will be removed on September 30, 2025: * `CompetitivePriceThreshold` *** ## May 28, 2025 #### API changes ##### [Sales API v1](https://developer-docs.amazon.com/sp-api/reference/sales-v1) * The [`getOrderMetrics`](https://developer-docs.amazon.com/sp-api/reference/getordermetrics) operation of the Sales API now has an optional query parameter `amazonProgram` that you can use to retrieve sales metrics for the Amazon Haul program. The Amazon Haul program is only available in the Amazon US store. ##### [Listings Items v2021-08-01 API](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * Added support for the JSON Patch `merge` operation to the Listings Items v2021-08-01 API. You can use this operation to update the quantity field in `fulfillmentAvailability` without including optional fields like `restock_date` or `lead_time_to_ship_max_days`. You can also use the `merge` operation to delete the `quantity_discount_plan` from `purchasable_offer` for B2B offers. For more information, refer to [Tutorial: Merge a listing](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide#tutorial-merge-a-listing). ##### [Product Pricing v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added the `DEFAULT` enum value for the `customerMembership` operation that the `FeaturedOfferSegment` uses. * Updated the enum value for the `OfferType` input in the `lowestPricedOffersInputs` array from `CONSUMER` to `Consumer`. #### Documentation changes * Added documentation that explains how service providers can migrate from Service Provider Central to Solution Provider Portal. For details, refer to [Service Provider Registration and Migration](https://developer-docs.amazon.com/sp-api/docs/register-as-a-service-provider). * Improved the structure and clarity of the authorization documentation. For the revised content, refer to the complete [Authorize Applications](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications) section. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) * `listCatalogCategories` *** ## April 30, 2025 #### API changes ##### [Seller Wallet API v2024-03-01](https://developer-docs.amazon.com/sp-api/reference/seller-wallet-v2024-03-01) * The Selling Partner API for Seller Wallet (Seller Wallet API) provides financial information that is relevant to a seller's Seller Wallet account. You can obtain financial events, balances, and transfer schedules for Seller Wallet accounts. You can also schedule and initiate transactions. For tutorials about how to use the Seller Wallet API, refer to the [Seller Wallet API v2024-03-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/seller-wallet-api-v2024-03-01-use-case-guide). **This API is only available in private beta**. ##### [Finances API v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) * Deferred transactions that become released are now distinguished with a `transactionStatus` of `DEFERRED_RELEASED`. #### Documentation changes * The [terminology page](https://developer-docs.amazon.com/sp-api/docs/terminology) now features a more comprehensive set of terms. Hover over underlined terms throughout the documentation to see their definitions. Example: <>. * Added [Onboarding to the SP-API](https://developer-docs.amazon.com/sp-api/docs/onboarding-overview), a step-by-step guide that walks you through Selling Partner API integration. This 10-step tutorial covers the complete integration process, from initial registration to listing an application. The tutorial includes sections on sandbox testing, authorization workflows, and production deployment. * Added the [Shipment Invoicing API v0 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/shipment-invoicing-api-v0-use-case-guide), which details how to retrieve shipment information and submit a shipment invoice. * Added the [automated pricing rules](https://developer-docs.amazon.com/sp-api/docs/manage-automated-pricing-rules) guide, which details how to manage automated pricing rules programmatically. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## April 2, 2025 #### API changes ##### [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1) * Added the `estimatedArrivalTime` parameter to the [`setAppointmentFulfillmentData`](https://developer-docs.amazon.com/sp-api/reference/setappointmentfulfillmentdata) request. You can use this parameter to provide the range of time when a technician is expected to arrive at a fulfillment location. #### Documentation changes * Released prebuilt SDKs for Java and PHP. For more information, refer to [SP-API SDKs](https://developer-docs.amazon.com/sp-api/docs/sp-api-sdks). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## February 27, 2025 #### Documentation changes #### [SP-API Product Metadata Update](https://developer-docs.amazon.com/sp-api/docs/sp-api-metadata-updates) * Added a [SP-API Product Metadata Updates](https://developer-docs.amazon.com/sp-api/docs/sp-api-metadata-updates) page, which shows the metadata changes for all product types in the affected Amazon stores. *** ## February 26, 2025 #### API changes ##### [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) * Added the following operations to the Amazon Warehousing and Distribution (AWD) API v2024-05-09: * [`createInbound`](https://developer-docs.amazon.com/sp-api/reference/createinbound): Creates a draft AWD inbound order with a list of packages for inbound shipment. The operation creates one shipment per order. * [`getInbound`](https://developer-docs.amazon.com/sp-api/reference/getinbound): Retrieves an AWD inbound order. * [`updateInbound`](https://developer-docs.amazon.com/sp-api/reference/updateinbound): Updates an AWD inbound order that is in `DRAFT` status and not yet confirmed. Use this operation to update the `packagesToInbound`, `originAddress`, and `preferences` attributes. * [`cancelInbound`](https://developer-docs.amazon.com/sp-api/reference/cancelinbound): Cancels an AWD Inbound order and its associated shipment. * [`confirmInbound`](https://developer-docs.amazon.com/sp-api/reference/confirminbound): Confirms an AWD inbound order in `DRAFT` status. * [`getInboundShipmentLabels`](https://developer-docs.amazon.com/sp-api/reference/getinboundshipmentlabels): Retrieves the box labels for a shipment ID that you specify. This is an asynchronous operation. If the label status is `GENERATED`, then the label URL is available. * [`updateInboundShipmentTransportDetails`](https://developer-docs.amazon.com/sp-api/reference/updateinboundshipmenttransportdetails): Updates transport details for an AWD shipment. * [`checkInboundEligibility`](https://developer-docs.amazon.com/sp-api/reference/checkinboundeligibility): Determines if the packages you specify are eligible for an AWD inbound order. * Added a tutorial that shows how to create an inbound order for shipment to AWD. For more information, refer to [Tutorial: Create an inbound order for shipment to AWD](https://developer-docs.amazon.com/sp-api/docs/amazon-warehousing-and-distribution-api-use-case-guide#tutorial-create-an-inbound-order-for-shipment-to-awd). ##### [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * Added the `includedData` array to the [JSON\_LISTINGS\_FEED](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/feeds/listings-feed-processing-report-schema-v2.json). If you specify the `includedData` array in the feed header, the report includes a list of issues that occur after the acceptance of your listing submission. * The [Building Listings Management Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide) now includes guidance on how to use the `includedData` array of the [`JSON_LISTINGS_FEED`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/feeds/listings-feed-processing-report-schema-v2.json) to retrieve issues that occur after the acceptance of your listing submission. For more information, refer to [Create and update listings items in bulk](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide#create-and-update-listings-items-in-bulk). ##### [Fulfillment Outbound v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added `deliveryWindow` to the [`getPackageTrackingDetails`](https://developer-docs.amazon.com/sp-api/reference/getpackagetrackingdetails) response. This property provides sellers with a time window that describes when a package is expected to be delivered. ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Added two new [Analytics Reports](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics): * Search Catalog Performance Report: Provides search engagement metrics such as impressions, clicks, cart adds, and purchases for a specified date range. * Search Query Performance Report: Provides overall query performance, such as impressions, clicks, cart adds, and purchases for a given ASIN and specified date range. ##### [Vehicles API v2024-11-01](https://developer-docs.amazon.com/sp-api/reference/vehicles-v2024-11-01) * Added the Vehicles API v2024-11-01, which you can use to retrieve information about vehicles, including their unique identifiers. You can use this information and the [Listings API](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) to provide the list of vehicles with which your listed ASINs are compatible. #### Documentation changes * Added a topic that lists the required roles for every SP-API operation, feed type, notification type, and report type. You can use this information to help you select roles when you register as a developer. For details, refer to [Role Mappings](https://developer-docs.amazon.com/sp-api/docs/role-mappings). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) The removal date for the following Feeds Type Values has changed from Mar 31, 2025 to June 30, 2025. * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_UIEE_BOOKLOADER_DATA` For more information, refer to [Migrating product feeds workflows](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide). *** ## January 29, 2025 #### API changes ##### [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) * Added the optional response parameter `replenishmentQuantity` to the [`listInventory`](https://developer-docs.amazon.com/sp-api/reference/listinventory) operation. You can use this parameter to review quantity information for units that are in transit from Amazon Warehousing and Distribution (AWD) to a Fulfillment by Amazon (FBA) facility. ##### [Data Kiosk v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * The Vendor Analytics dataset now includes metrics such as `sellableInTransitInventory`, `unsellableInTransitInventory`, `mostRecentSubmitted`, `netOrderedGMS`, and `netShipmentGMS`. You can use these metrics to monitor inventory availability, identify fulfillment issues, and understand your sales performance. ##### [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * The response of the [`listPackingOptions`](https://developer-docs.amazon.com/sp-api/reference/listpackingoptions) operation now describes acceptable packing methods and package weights in the `supportedConfigurations` property. This property replaces the `supportedShippingConfigurations` property. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added `sampleLocation` to the response of the [`getCompetitiveSummary`](https://developer-docs.amazon.com/sp-api/reference/getcompetitivesummary) operation and the request of the [`getFeaturedOfferExpectedPriceBatch`](https://developer-docs.amazon.com/sp-api/reference/getfeaturedofferexpectedpricebatch) operation. You can use this metric to return location information for featured offers and to retrieve a location-specific feature offer expected price (FOEP). ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Updated the [End User Data Report](https://developer-docs.amazon.com/sp-api/docs/report-type-values-regulatory-compliance#end-user-data-report) to include support for the Ireland (IE) Amazon store. #### Documentation changes * Added a new, interactive [API reference](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references) for each API, where you can dynamically create requests in multiple languages. * Added notes the [welcome](https://developer-docs.amazon.com/sp-api/docs/welcome) and [errors FAQ](https://developer-docs.amazon.com/sp-api/docs/errors-faq) pages to improve the discoverability of the [API Health Dashboard](https://sellercentral.amazon.com/sp-api-status). * Restructured the [VAT Calculation Service guide](https://developer-docs.amazon.com/sp-api/docs/vat-calculation-service-guide) to improve flow and readability. * Updated the [Vendor Retail Procurement APIs v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide) to include the following operations for business requirements: `getPurchaseOrder`, `SubmitShipmentConfirmations`, `submitInvoices`, and `GetShipmentDetails`. * Added a rate limit topic for each API. These new topics list the usage plans (rate limits and burst values) for each operation. For an example, refer to [Data Kiosk API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-api-rate-limits). * Added a tutorial that shows how to use SP-APIs to retrieve and pass a purchase order number to UPS, FedEx, or USPS. For details, refer to [Tutorial: Retrieve and Pass a Purchase Order Number to a Carrier](https://developer-docs.amazon.com/sp-api/docs/tutorial-retrieve-and-pass-purchase-order-number-to-carrier). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). * The removal date for select [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) operations has changed from December 11, 2024 to March 31, 2025. The affected operations are: * `listCatalogItems` * `getCatalogItem` *** ## December 18, 2024 #### API changes ##### [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) * Added the expiration property to the `listInventory` and `getInboundShipment` responses. You can use this property to get the expiration date of a perishable item in your shipment. For more information, refer to [Track an inbound shipment with expected and received SKU details](https://developer-docs.amazon.com/sp-api/docs/amazon-warehousing-and-distribution-api-use-case-guide#tutorial-track-an-inbound-shipment). * Added the `prepDetails` property to the `listInventory` and `getInboundShipment` responses. You can use this property to get the preparation details on an item, including the preparation owner, category, instructions, and label owner. #### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * The [Vendor Analytics dataset](https://developer-docs.amazon.com/sp-api/docs/vendor-analytics-dataset-guide) now includes metrics such as Confirmed Units, Shipped COGS, MSRP, and customer ZIP Code data. #### [Listings Items API v2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * Added the [`searchListingsItems`](https://developer-docs.amazon.com/sp-api/reference/searchlistingsitems) operation. You can use this operation to return information for multiple listings items based on filters, which include listing IDs, issues, status, and creation date. #### [Replenishment API v2022-11-07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) * Added `REVENUE_BY_DELIVERIES`, `SUBSCRIBER_RETENTION`, `REVENUE_PENETRATION_BY_SELLER_FUNDING`, and `SHARE_OF_COUPON_SUBSCRIPTIONS` metrics to the [`getSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics) operation response. These metrics describe the revenue sources and subscription performance. * Added the `SHARE_OF_COUPON_SUBSCRIPTIONS` metric to the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) operation response. This metric describes the coupon acquisition performance. #### [Sellers API v1](https://developer-docs.amazon.com/sp-api/reference/sellers-v1) * Added the `storeName` property to the [`getMarketplaceParticipations`](https://developer-docs.amazon.com/sp-api/reference/getmarketplaceparticipations) response. You can use the `storeName` property to get the name of the seller's store as displayed in the Amazon store. * Added the `MarketplaceParticipationList` array to the [`getAccount`](https://developer-docs.amazon.com/sp-api/reference/getaccount) response. The `MarketplaceParticipationList` array replaces the array of `MarketplaceLevelAttributes`. * Removed the `sellingPlan` parameter from the `MarketplaceParticipationList` array and added it to the root level of the [`getAccount`](https://developer-docs.amazon.com/sp-api/reference/getaccount) response. For more information, refer to the [Sellers API v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v2024-07-14-use-case-guide). * The `getAccount` operation requires the [Account Information Service Provider (AISP)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#account-information-service-provider) role. For more information about this role, refer to [Third-Party Provider Registration](https://developer-docs.amazon.com/sp-api/docs/tpp-registration). #### [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01) * The [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01) is now generally available. You can use this API to retrieve information about the payment methods associated with a seller and initiate payouts to a seller's deposit method on file. To use this API, you must select one of the following roles in the app registration page for your application: * [Payment Initiation Service Provider (PISP)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#payment-initiation-service-provider) role * [Account Information Service Provider (AISP)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#account-information-service-provider) role * [Finance and Accounting](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#finance-and-accounting) role. This API is available in the EU region. #### [Vendor Direct Fulfillment Shipping API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v2021-12-28) * Added the [`createContainerLabel`](https://developer-docs.amazon.com/sp-api/reference/createcontainerlabel) operation. You can use this operation to create a container (pallet) label. #### [Vendor Shipments API v1](https://developer-docs.amazon.com/sp-api/reference/vendor-shipments-v1) * The `GetShipmentLabels` operation of the Vendor Shipments API v1 now supports the ability to retrieve small parcel labels for vendors. #### Seller Central store Expansion to Ireland (IE) On December 10, 2024, Seller Central launched support for the Ireland (IE) Amazon store. For more information, refer to the [SP-API Seller Central URLs](https://developer-docs.amazon.com/sp-api/docs/seller-central-urls), [SP-API Endpoints](https://developer-docs.amazon.com/sp-api/docs/sp-api-endpoints), and [Store Identifiers](https://developer-docs.amazon.com/sp-api/docs/store-identifiers) topics in the SP-API documentation. #### Third-party provider support for UK and EU SP-API developers Sellers in the UK and EU can now authorize third-party provider (TPPs) to access an account holder's account and payment services using the [AISP](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#account-information-service-provider) and [PISP](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#payment-initiation-service-provider) roles. For more information, refer to [Third-Party Provider Registration](https://developer-docs.amazon.com/sp-api/docs/tpp-registration) and [Third-Party Provider Signature Guidance](https://developer-docs.amazon.com/sp-api/docs/tpp-registration-signature-guidance). #### Documentation changes * Updated guidance on how to handle [null enum values](https://developer-docs.amazon.com/sp-api/docs/errors-faq#why-am-i-getting-a-null-enum-value). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). * The removal date for select [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) operations has changed from December 11, 2024 to January 28, 2025. The affected operations are: * `listCatalogItems` * `getCatalogItem` * The removal date for the [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) type value `LISTINGS_ITEM_ISSUES_CHANGE` (payload version 1.0) has changed from December 11, 2024 to March 26, 2025. *** ## November 14, 2024 #### API changes ##### [Easy Ship v2022-03-23](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) * Updated the [EasyShip API v2022-03-23](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) for additional Amazon store support in the Netherlands (NL) and Poland (PL). *** ## November 12, 2024 #### API changes ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added `WasPrice` to the [`getCompetitiveSummary`](https://developer-docs.amazon.com/sp-api/reference/getcompetitivesummary) operation (in the `referencePrices` list in the operation response). `WasPrice` is the 90-day median price that customers pay for the product on Amazon. You can use this value to set promotions and discounts based on the typical price on the product detail page. *** ## November 11, 2024 #### API changes ##### [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01) * Updated the rate limit for the [`initiatePayout`](https://developer-docs.amazon.com/sp-api/reference/initiatepayout) operation from 0.5 to 0.017 and updated the burst rate from 30 to 2. *** ## November 6, 2024 #### API changes ##### [Finances V0 API](https://developer-docs.amazon.com/sp-api/reference/finances-v0) * Added the `TransactionNumber` parameter to the `AdjustmentItem` object. You can use this parameter to identify what the adjustment is related to. For example, Amazon Shipping customers can use this to get an invoice number that they can use to identify an Amazon Shipping invoice. ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-use-case-guide) * Added the following to the [Fulfillment Outbound API v2020-07-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-use-case-guide): * `items` now has quantity limitations (maximum of 100 line items with a maximum of 250 units per order). * `shippingSpeedCategory` now has shipping method service-level agreements that vary by Amazon store. * `DeliveryPreferences` now has the default delivery preference set to leave the package unattended at the front door for eligible orders. ##### [Merchant Fulfillment API v0](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0) * Updated the `getEligibleShippingServices` and `createShipment` operations to include new increased throttling rates. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added Japan (JP) Amazon store support for the [`getFeaturedOfferExpectedPriceBatch`](https://developer-docs.amazon.com/sp-api/reference/getfeaturedofferexpectedpricebatch) operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all Amazon stores. #### Documentation changes * Added the following information to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits): * Details about the rate-limiting algorithm * Factors that influence rate limits * How to find your rate limits * Added the following API-specific rate limits pages: * [Catalog Items API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-rate-limits) * [Feeds API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/feeds-api-rate-limits) * [Listings Items API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-rate-limits) * [Listings Restrictions API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-rate-limits) * [Product Type Definitions API Rate Limits](https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api-rate-limits) * Added new, interactive references for the following APIs: * [Catalog Items v2022-04-01](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v2022-04-01) * [Orders v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * [Reports v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * [Feeds v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * [Fulfillment Inbound v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * [Listings Items v2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * [Vendor Invoices v1](https://developer-docs.amazon.com/sp-api/reference/vendor-invoices-v1) * [Vendor Shipments v1](https://developer-docs.amazon.com/sp-api/reference/vendor-shipments-v1) #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) (Select operations) * `listCatalogItems` * `getCatalogItem` * [Fulfillment Inbound API v0](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) (Select operations) * `confirmPreorder` * `confirmTransport` * `createInboundShipment` * `createInboundShipmentPlan` * `estimateTransport` * `getPreorderInfo` * `getTransportDetails` * `putTransportDetails` * `updateInboundShipment` * `voidTransport` For more information, refer to [Migrating Fulfillment Inbound workflows](https://developer-docs.amazon.com/sp-api/docs/migrating-fulfillment-inbound-workflows). ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_PRODUCT_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_UIEE_BOOKLOADER_DATA` For more information, refer to [Migrating product feeds workflows](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide). ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `LISTING_ITEM_ISSUES_CHANGE` payload version 1.0 *** ## October 14, 2024 #### API changes ##### [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * Added the [`listPrepDetails`](https://developer-docs.amazon.com/sp-api/reference/listprepdetails) and [`setPrepDetails`](https://developer-docs.amazon.com/sp-api/reference/setprepdetails) operations to get and set preparation details. ##### [Notifications API v1](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#fba_inventory_availability_changes) * Added the [`TRANSACTION_UPDATE`](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#transaction_update) notification that is sent whenever there is a new transaction posted to the seller's account. #### Documentation changes * Added the [Schedule Data Kiosk Queries](https://developer-docs.amazon.com/sp-api/docs/schedule-data-kiosk-queries) guide, detailing how to automatically make regular calls to `createQuery`. * New [Fulfillment Inbound code samples](https://developer-docs.amazon.com/sp-api/docs/code-samples#fulfillment-inbound). *** ## September 25, 2024 #### API changes ##### [Data Kiosk API v2023-11-15](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * Added `GroupByAttributes` to the [`analytics_vendorAnalytics_2024_09_30`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/data-kiosk/analytics_vendorAnalytics_2024_09_30.graphql) schema. These attributes detail the location to which items are shipped: * `shipToCountryCode` * `shipToCity` * `shipToStateOrProvince` ##### [FBA Inventory API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) * Updated the `GetInventorySummariesResponse` to include a new `Stores` array. `Stores` contains a list of seller-enrolled stores for the affected inventory item. ##### [Notifications API v1](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#fba_inventory_availability_changes) * Updated the [`FBAInventoryAvailabilityChangeNotification`](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#fbainventoryavailabilitychangenotification) object to include a new `Stores` array. `Stores` contains a list of seller-enrolled stores for the affected inventory item. ##### [Finances API v0](https://developer-docs.amazon.com/sp-api/reference/finances-v0) * Added the optional `storeName` field to `listFinancialEvents` response. This field provides the store where the transaction took place, and is contained in the following objects: * `ShipmentEvent` * `PayWithAmazonEvent` * `ServiceFeeEvent` * `RemovalShipmentEvent` ##### [Finances API v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) * New [Finances API v2024-06-19](https://developer-docs.amazon.com/sp-api/reference/finances-v2024-06-19) provides financial information that is relevant to a seller's business. You can use this API to obtain financial events for a specified order or date range without having to wait until a statement period closes. ##### [Invoices API v2024-06-19](https://developer-docs.amazon/sp-api/reference/invoices-v2024-06-19-brazil-only) * New [Invoices API for Amazon Brazil store](https://developer-docs.amazon/sp-api/reference/invoices-v2024-06-19-brazil-only) that you can use to search for and retrieve invoices based on specific criteria, and asynchronously download the returned invoices. For more information, refer to the [Invoices API Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/invoices-api-v2024-06-19-use-case-guide). ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added the `AmazonPrograms` attribute to the [`getOrderItems`](https://developer-docs.amazon.com/sp-api/reference/getorderitems) response. This attribute contains the list of programs that are associated with an item, such as **Subscribe and Save**. #### Documentation changes * Updated the [Price Adjustment Automation Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/price-adjustment-automation-workflows-guide) to include Price Feed migration strategies and bulk price updates using the `JSON_LISTINGS_FEED`. * Updated the [Product Pricing API and Notifications FAQ](https://developer-docs.amazon.com/sp-api/docs/pricing-faq) to include: * [The differences between the `PRICING_HEALTH` and `ANY_OFFER_CHANGED` notifications](https://developer-docs.amazon.com/sp-api/docs/pricing-faq#what-are-the-differences-between-pricing_health-and-any_offer_changed-notifications). * [How to use the `getCompetitiveSummary` operation](https://developer-docs.amazon.com/sp-api/docs/pricing-faq#what-is-the-getcompetitivesummary-operation-used-for-and-why-should-i-adopt-it). * New [Product Pricing API code samples](https://developer-docs.amazon.com/sp-api/docs/code-samples#product-pricing-api-v0), which demonstrate how to: * Retrieve and map SKU data. * Fetch SKU price. * Calculate new SKU price. * Submit new SKU price. * New [B2C Pricing sample solution on GitHub](https://github.com/amzn/selling-partner-api-samples/tree/main/use-cases/pricing), which includes: * Repricing against `PRICING_HEALTH` notifications in Java and Python. * Repricing logic against `ANY_OFFER_CHANGED` notifications in Java and Python. * [New B2B Pricing sample solution on GitHub](https://github.com/amzn/selling-partner-api-samples/tree/main/use-cases/pricing), which includes: * Repricing logic against `ANY_OFFER_CHANGED` notifications in Java * Quantity Tier discount feature in Java #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) (Select operations) * `listCatalogItems` * `getCatalogItem` * [Fulfillment Inbound API v0](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) (Select operations) * `confirmPreorder` * `confirmTransport` * `createInboundShipment` * `createInboundShipmentPlan` * `estimateTransport` * `getPreorderInfo` * `getTransportDetails` * `putTransportDetails` * `updateInboundShipment` * `voidTransport` For more information, refer to [Migrating Fulfillment Inbound workflows](https://developer-docs.amazon.com/sp-api/docs/migrating-fulfillment-inbound-workflows). ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_PRODUCT_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_UIEE_BOOKLOADER_DATA` For more information, refer to [Migrating product feeds workflows](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide). ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `LISTING_ITEM_ISSUES_CHANGE` payload version 1.0 *** ## September 11, 2024 #### API changes ##### [EasyShip API v2022-03-23](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) * Added support for the Japan (JP) Amazon store. For more information on the Amazon stores that support Easy Ship operations, refer to the [EasyShip API v2022-03-23 Amazon store support table](https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide). ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added an optional field, `deliveryInformation`, to the `GetFulfillmentOrder` response. You can use this to get the `deliveryDocumentList`, which can have a photo or signature for a delivered Multi-Channel Fulfillment Outbound shipment. You can use `dropOffLocation` to get where the shipment package was delivered. ##### [Listings Items API v2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * The [Listings Items API v2021-08-01](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide) and [`JSON_LISTINGS_FEED`](https://developer-docs.amazon.com/sp-api/docs/listings-feed-type-values#listings-feed) feed type now support Amazon Business (B2B) pricing functionality. * The new [Manage Advanced Multiple-Offer and Multiple-Fulfillment Use Cases guide](https://developer-docs.amazon.com/sp-api/docs/manage-advanced-multiple-offer-multiple-fulfillment-use-cases) demonstrates how selling partners who are enrolled in the Amazon Business (B2B) program can create multiple offers on a listing, which creates differential pricing between regular buyers on Amazon websites (such as Amazon.com) and business buyers on Amazon Business websites. ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added new optional verification details properties to the `regulatedInfo` operations. Sellers can use these details to verify orders that contain prescriptions. * The [Regulated orders guide](https://developer-docs.amazon.com/sp-api/docs/regulated-orders) includes a [new tutorial](https://developer-docs.amazon.com/sp-api/docs/regulated-orders#tutorial-provide-additional-details-about-the-verfication-of-a-regulated-order) on how to provide additional details about the verification of an order that contains regulated information. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Updated the [`getFeaturedOfferExpectedPriceBatch`](https://developer-docs.amazon.com/sp-api/reference/getfeaturedofferexpectedpricebatch) to no longer require `offerIdentifier` in the `FeaturedOfferExpectedPriceResponseBody`. The `offerIdentifier` parameter is now optional in order to correctly deserialize `getFeaturedOfferExpectedPriceBatch` error responses, as `FeaturedOfferExpectedPriceResponseBody` doesn’t provide `offerIdentifier` in the response when there are errors. #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the [SP-API Deprecation Schedule](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## August 19, 2024 #### API changes ##### [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) * Added the optional response parameter `totalInboundQuantity` to the [`listInventory`](https://developer-docs.amazon.com/sp-api/reference/listinventory) operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution. * Added a new optional request parameter `skuQuantities` to the [`getInboundShipment`](https://developer-docs.amazon.com/sp-api/reference/getinboundshipment) operation. You can use this parameter to reconcile and compare expected and received inventory for each SKU in a shipment. You can now use the Amazon Warehousing and Distribution API to: * Track inventory in-transit to Amazon Warehousing and Distribution to improve end-to-end inventory view. * Reconcile and compare expected and received inventory for each SKU in a shipment. *** ## August 14, 2024 #### API changes ##### [FBA Inbound Eligibility API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inbound-eligibility-v1) * Added a new inbound ineligibility enum value, `FBA_INB_0342` in the `getItemEligibilityPreview` operation. This value provides more information on why an offer can't use certain manufacturer barcodes. ##### [Sellers API v1](https://developer-docs.amazon.com/sp-api/reference/sellers-v1) * Added the [`getAccount`](https://developer-docs.amazon.com/sp-api/reference/getaccount) operation to retrieve information about seller accounts. ##### [Vendor Orders API v1](https://developer-docs.amazon.com/sp-api/reference/vendor-orders-v1) * Added a new `unitOfMeasure` variable to support variable weight products. This variable provides the unit of measure for prices of items sold by weight. If this field is absent, the item is sold by eaches. Operations that return this variable include: * [`getPurchaseOrders`](https://developer-docs.amazon.com/sp-api/reference/getpurchaseorders) * [`getPurchaseOrder`](https://developer-docs.amazon.com/sp-api/reference/getpurchaseorder) * [`submitAcknowledgement`](https://developer-docs.amazon.com/sp-api/reference/submitacknowledgement) * [`getPurchaseOrdersStatus`](https://developer-docs.amazon.com/sp-api/reference/getpurchaseordersstatus) #### Documentation changes * The new [Services API v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/services-api-v1-use-case-guide) outlines how to access service job details and confirm or reschedule appointments using the [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the [deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). The following operations in the [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) were deprecated on **September 30, 2022** and will be removed on **September 25, 2024**: * `listCatalogItems` * `getCatalogItem` *** ## July 31, 2024 #### API changes ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added the `queryStartDate` parameter to the [`getFeatureInventory`](https://developer-docs.amazon.com/sp-api/reference/getfeatureinventory) operation. You can use this parameter to select inventory that has been updated since a specified date. * The [Fulfillment Outbound API v2020-07-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-use-case-guide) provides steps on how to pass the `queryStartDate` parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature. #### Documentation changes The Selling Partner API Blog will be removed on **July 31, 2024**. For technical guidance on Selling Partner APIs, refer to the [SP-API Documentation site](https://developer-docs.amazon.com/sp-api/docs/welcome). For supplementary guidance on Selling Partner APIs, refer to [Developer University](https://developer.amazonservices.com). #### Deprecation notices Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the [deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). The following operations in the [Catalog Items API v0](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v0) were deprecated on **September 30, 2022** and will be removed on **September 25, 2024**: * `listCatalogItems` * `getCatalogItem` *** ## July 8, 2024 #### API changes ##### [Merchant Fulfillment v0 API](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0) * Added the `Benefits` object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example, `CLAIMS_PROTECTED` for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon. *** ## June 28, 2024 #### API changes * Removed the [June 27, 2024](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#june-27-2024) updates to [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) and [Merchant Fulfillment v0 API](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0). *** ## June 27, 2024 #### API changes ##### [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * The [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) is now in general availability. You can use this API to select from multiple inbound placement service options and create inbound plans with support for up to 1500 SKUs. * The [Fulfillment Inbound API v2024-03-20 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-api-v2024-03-20-use-case-guide) provides tutorials on how to create shipments and guidance on the fulfillment inbound shipment workflow. * The [Fulfillment Inbound API frequently asked questions](https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-faq) includes the benefits of the [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) and guidance on migrating from the Fulfillment Inbound API v0. * [Migrating Fulfillment Inbound workflows](https://developer-docs.amazon.com/sp-api/docs/migrating-fulfillment-inbound-workflows) guide you through migrating from the [Fulfillment Inbound API v0](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) to the new [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20). ##### [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01) * You can use the new Transfers API to initiate payouts and retrieve instrument details sellers' accounts by calling the [`initiatePayout`](https://developer-docs.amazon.com/sp-api/reference/initiatepayout) and [`getPaymentMethods`](https://developer-docs.amazon.com/sp-api/reference/getpaymentmethods) operations. For tutorials on how to use the Transfers API v2024-06-01, sellers can refer to the [Transfers API v2024-06-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/transfers-api-v2024-06-01-use-case-guide). This API is only available in private beta. #### Documentation changes * The [Finances v0 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/finances-api-v0-use-case-guide) outlines how to retrieve financial information, such as the current balance, transactions, and fund transfer status for your orders using the [Finances API v0](https://developer-docs.amazon.com/sp-api/reference/finances-v0). #### 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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## June 19, 2024 #### API changes ##### [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) * Sellers can use the new Amazon Warehousing and Distribution API to track inventory inside AWD distribution centers and track shipments going into AWD distribution centers. ##### [Data Kiosk API v2023-11-05](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) * The [Data Kiosk API v2023-11-05](https://developer-docs.amazon.com/sp-api/reference/data-kiosk-v2023-11-15) is now in general availability. * The new [Data Kiosk sample solution](https://github.com/amzn/selling-partner-api-samples/tree/main/use-cases/data-kiosk) provides all the resources that you need to deploy a fully functional SP-API application that automates the creation and retrieval of Data Kiosk documents. * The new [Data Kiosk workflow guide](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) offers insights into best practices, answers common questions about API usage, and outlines optimal workflows. * The new [Vendor Analytics dataset](https://developer-docs.amazon.com/sp-api/docs/vendor-analytics-dataset-guide) provides vendor data across multiple domains. You can aggregate data across any granularity (ASIN/Brand/Manufacturing/date) and access more than 100 metrics across sales, traffic, inventory, forecast, profitability, and new geographic sales metrics. ##### [FBA Inventory API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) * Developers who create or manage applications that integrate with the [FBA Inventory API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) and [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the [FBA Inventory Dynamic Sandbox Guide](https://developer-docs.amazon.com/sp-api/docs/fba-inventory-api-v1-dynamic-sandbox-guide). ##### [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Added the new [`deliveryOffers`](https://developer-docs.amazon.com/sp-api/reference/deliveryoffers) operation. Sellers can use this operation to display Multi-Channel Fulfillment (MCF) standard delivery offers on pre-checkout pages. This operation is only available in the United States (US) Amazon store. * Added the optional field `lockerDetails` to the [`getFulfillmentOrder`](https://developer-docs.amazon.com/sp-api/reference/getfulfillmentorder) response. Sellers can include the information that is needed to access the locker delivery boxes. This field is only available in the Japan (JP) Amazon store. * Added the optional field `deliveryPreferences` to the [`createFulfillmentOrder`](https://developer-docs.amazon.com/sp-api/reference/createfulfillmentorder) request. Sellers can include the delivery preferences that are applied to the destination address. This field is only available in the Japan (JP) Amazon store. * Developers who create or manage applications that integrate with the [FBA Inventory API v1](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) and [Fulfillment Outbound API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the [Fulfillment Outbound Dynamic Sandbox Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-dynamic-sandbox-guide). ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * The [`getFeaturedOfferExpectedPriceBatch`](https://developer-docs.amazon.com/sp-api/reference/getfeaturedofferexpectedpricebatch) operation is now available in all Amazon stores except Japan (JP). Sellers can use this operation to get the featured offer expected price (FOEP) data for up to 40 SKUs. ##### [Replenishment API v2022-11-07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) * Added the metrics `LOST_REVENUE_DUE_TO_OOS`, `SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS`, and `COUPONS_REVENUE_PENETRATION` to the [`getSellingPartnerMetrics`](https://developer-docs.amazon.com/sp-api/reference/getsellingpartnermetrics) operation response. These metrics describe sources of revenue and lost revenue. * Added the metrics `LOST_REVENUE_DUE_TO_OOS` and `COUPONS_REVENUE_PENETRATION` to the [`listOfferMetrics`](https://developer-docs.amazon.com/sp-api/reference/listoffermetrics) operation response. These metrics describe sources of revenue and lost revenue. #### 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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## June 4, 2024 #### API changes ##### [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-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`](https://developer-docs.amazon.com/sp-api/reference/confirmdeliverywindowoptions), [`generateDeliveryWindowOptions`](https://developer-docs.amazon.com/sp-api/reference/generatedeliverywindowoptions), and [`listDeliveryWindowOptions`](https://developer-docs.amazon.com/sp-api/reference/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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). The following operations in [Fulfillment Inbound API v0](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) are no longer deprecated: * [`getShipments`](https://developer-docs.amazon.com/sp-api/reference/getshipments) * [`getShipmentItemsByShipmentId`](https://developer-docs.amazon.com/sp-api/reference/getshipmentitemsbyshipmentid) * [`getShipmentItems`](https://developer-docs.amazon.com/sp-api/reference/getshipmentitems) *** ## May 22, 2024 #### API changes ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * Added the `lowestPricedOffers` and `referencePrices` attributes to the [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01). This enhancement provides the top 20 lowest priced offers and reference prices. * In the [Product Pricing API v2022-05-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-use-case-guide), the [Tutorial: Retrieve a list of featured offers for a batch of up to 20 ASINs](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-use-case-guide#tutorial-retrieve-a-list-of-featured-offers-for-a-batch-of-up-to-20-asins) makes use of two new attributes: `lowestPricedOffers` and `referencePrices`. * Added the [Price Adjustment Automation Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/price-adjustment-automation-workflows-guide) to our Selling Partner API documentation site. This guide outlines how to leverage the [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) and Pricing notifications to build best-in-class workflows that automate pricing management. * Added the [Product pricing API and notifications frequently asked questions](https://developer-docs.amazon.com/sp-api/docs/pricing-faq) to our Selling Partner API documentation site. This documentation covers common questions and details for the [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01). ##### [Catalog Items API v2022-04-01](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v2022-04-01) * Added a new `includedData` query parameter option called `classifications`, which replaces the deprecated MWS `GetProductCategoriesForSKU` and `GetProductCategoriesForASIN`operations. Sellers and vendors can use `classifications` to browse the classification trees assigned to an ASIN. ##### [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30) * The [Order feeds attributes](https://developer-docs.amazon.com/sp-api/docs/order-feeds-attributes) [`POST_ORDER_FULFILLMENT_DATA`](https://developer-docs.amazon.com/sp-api/docs/order-feeds-attributes#post_order_fulfillment_data) and [`POST_FLAT_FILE_FULFILLMENT_DATA`](https://developer-docs.amazon.com/sp-api/docs/order-feeds-attributes#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. For more information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## April 24, 2024 #### API changes ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added the the `CompanyName` attribute to the [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) API. * Updated the rate limit for the `getOrder`, `getOrderAddress`, and `getOrderBuyerInfo` operations 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 the `getOrders` operation to return the `AutomatedCarrier` and `AutomatedShipMethod` attributes. ##### [Easy Ship API v2022-03-23](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) * Updated the license from the Amazon Software License to the Apache License 2.0. * Added the 413 HTTP code to each operation’s list of possible responses. #### Report schema changes Added The `lastUpdatedDate` field to the following Vendor reports: * [`GET_VENDOR_SALES_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) * [`GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) * [`GET_VENDOR_TRAFFIC_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) * [`GET_VENDOR_FORECASTING_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) * [`GET_VENDOR_INVENTORY_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) #### Vendor Central Store Expansion to Ireland (IE) On April 23rd, 2024, Vendor Central launched support for Ireland (IE) Amazon store. For more information, refer to the [SP-API Vendor Central URLs](https://developer-docs.amazon.com/sp-api/docs/vendor-central-urls), [SP-API Endpoints](https://developer-docs.amazon.com/sp-api/docs/sp-api-endpoints), and [Amazon store IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids) topics in the SP-API documentation. #### Documentation changes * The [Orders API v0 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-use-case-guide) includes new details about order age. Orders more than two years old will not be returned in the API response. The JP, AU, and SG Amazon stores are an exception. In those Amazon stores the Orders API v0 supports orders from 2016 to present. #### Deprecation notices Deprecated SP-API resources will no longer receive technical support. Calls to deprecated SP-API resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Fulfillment Inbound API v0 (Select operations) * `createInboundShipmentPlan` * `updateInboundShipment` * `createInboundShipment` * `getPreorderInfo` * `confirmPreorder` * `getTransportDetails` * `putTransportDetails` * `voidTransport` * `estimateTransport` * `confirmTransport` * `getShipments` * `getShipmentItemsByShipmentId` * `getShipmentItems` ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_PRODUCT_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_UIEE_BOOKLOADER_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `LISTING_ITEM_ISSUES_CHANGE` payload version 1.0 *** ## April 1, 2024 #### API changes ##### [Fulfillment Inbound v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20) * Early access to the new Fulfillment Inbound v2024-03-20 API, which supports FBA Inbound shipment creation and allows you to select from multiple inbound placement service options, among other features. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Fulfillment Inbound API v0 (Select operations) * `createInboundShipmentPlan` * `updateInboundShipment` * `createInboundShipment` * `getPreorderInfo` * `confirmPreorder` * `getTransportDetails` * `putTransportDetails` * `voidTransport` * `estimateTransport` * `confirmTransport` * `getShipments` * `getShipmentItemsByShipmentId` * `getShipmentItems` *** ## March 20, 2024 #### API changes ##### [Shipping API v2](https://developer-docs.amazon.com/amazon-shipping/docs/shipping-api-v2-reference) * Added the `AdditionalAddressNotes`, `NdrAction`, `NdrRequestData`, and `SubmitNdrFeedbackRequest` objects to the `ndrFeedback parameter`. * Added tutorial for [Using the ndrFeedback API to submit Non-Delivery Reports for eligible shipments](https://developer-docs.amazon.com/amazon-shipping/docs/tutorial-use-the-ndrfeedback-api-to-submit-non-delivery-reports-for-eligible-shipments). ##### [Merchant Fulfillment API v0](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0) * Added the Dangerous Goods attributes `LiquidVolume`, `IsHazmat`, and `DangerousGoodsDetails` to the Item object. ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Updated [Amazon store ASIN Page View Metric](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/marketplaceAsinPageViewMetrics.json) report to include support for the UK. For more information about this report, refer to [Regulatory Compliance Report Type Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values-regulatory-compliance#marketplace-asin-page-view-metrics). This change applies to the Amazon UK store only. * Published new [Request and retrieve a bulk invoice report for Multi-Channel Fulfillment (MCF) orders for India](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-tutorial-request-a-report#request-and-retrieve-a-bulk-invoice-report-for-MCF-orders-for-india) tutorial to the [Request a report tutorial](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-tutorial-request-a-report) page. The bulk invoice report lets MCF Sellers download the Goods and Service Tax invoice associated with their MCF order in a batch/zip format. Sellers can pass a date range to generate the download request and receive a zip file with delivered MCF order invoices. ##### [Notifications API v1](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * Updated [`FEED_PROCESSING_FINISHED`](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#feed_processing_finished) and [`REPORT_PROCESSING_FINISHED`](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#report_processing_finished) to include support for vendors. Both notifications include a new `accountId` property, which identifies the selling partner on whose behalf the feed or report was submitted. This change applies to all Amazon stores. ##### [Fulfillment Outbound v2020-07-01](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-use-case-guide) * Added the `PaymentInformation` attribute, which is required for India but is optional for all other Amazon stores. * Added tutorial on how to create an MCF order for India in the [Fulfillment Outbound API v2020-07-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-api-v2020-07-01-use-case-guide). #### Documentation changes * Added Python and Javascript client libraries for SDKs in the SP-API. To learn more about SP-API SDKs, refer to [Using SDKs](https://developer-docs.amazon.com/sp-api/docs/using-sdks), [Tutorial: Automate your SP-API calls using JavaScript SDK for Node.js](https://developer-docs.amazon.com/sp-api/docs/tutorial-automate-your-sp-api-calls-using-javascript-sdk-for-node-js), and [Tutorial: Automate your SP-API calls using Python SDK](https://developer-docs.amazon.com/sp-api/docs/tutorial-automate-your-sp-api-calls-using-python-sdk). * Reformatted the Report Type Values pages and consolidated the report type attributes for optimized discoverability. #### 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 detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Authorization API v1 (All operations) * FBA Small and Light API v1 (All operations) * Fulfillment Inbound API v0 (Select operations) * `getInboundGuidance` ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_PRODUCT_DATA` * `POST_INVENTORY_AVAILABILITY_DATA` * `POST_PRODUCT_OVERRIDES_DATA` * `POST_PRODUCT_PRICING_DATA` * `POST_PRODUCT_IMAGE_DATA` * `POST_PRODUCT_RELATIONSHIP_DATA` * `POST_FLAT_FILE_INVLOADER_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_BOOKLOADER_DATA` * `POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA` * `POST_FLAT_FILE_LISTINGS_DATA` * `POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA` * `POST_UIEE_BOOKLOADER_DATA` * `POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN` * `POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN` * `RFQ_UPLOAD_FEED` ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_PRODUCT_EXCHANGE_DATA` * `GET_FBA_UNO_INVENTORY_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `MFN_ORDER_STATUS_CHANGE` * `LISTING_ITEM_ISSUES_CHANGE` payload version 1.0 *** ## February 21, 2024 #### API changes ##### [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Added new Report Type Value [EndUserDataReport](https://developer-docs.amazon.com/sp-api/docs/report-type-values-regulatory-compliance) provides personal customer data, including contact information, Glance View, and `Orderdata` for customers who have elected to share this data with the seller when completing a transaction in DE, FR, IT, ES, NL, PL, SE and BE (EU-8) Amazon stores. ##### [Application Management API](https://developer-docs.amazon.com/sp-api/reference/application-management-v2023-11-30) * Promoted the Application Management API v2023-11-30 from Public Beta to Production. This API lets you programmatically rotate your Login with Amazon (LWA) credentials (client secrets). #### Documentation updates * Added six new code tutorials that detail how to do various tasks such as previewing orders, creating orders, and canceling orders. Find them in the [Code Samples](https://developer-docs.amazon.com/sp-api/recipes) section. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN` * `POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN` * `RFQ_UPLOAD_FEED` ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_PRODUCT_EXCHANGE_DATA` * `GET_FBA_UNO_INVENTORY_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `MFN_ORDER_STATUS_CHANGE` *** ## January 31, 2024 #### API changes ##### [Listings Items API v2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * Added a new validation mode for the [`putListingsItem`](https://developer-docs.amazon.com/sp-api/reference/putlistingsitem) and [`patchListingsItem`](https://developer-docs.amazon.com/sp-api/reference/patchlistingsitem) operations. Use the `mode=VALIDATION_PREVIEW` query parameter to validate a listings item without persisting the data in the catalog. This feature allows you to preview listing errors in production without creating listings. ##### [Fulfillment Inbound API v0](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) * Added the `ShipsInProductPackaging` value to the `PrepInstruction` enum. `PrepInstructionList` is returned in the response for calls to `prepInstructions`. ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added `ExtendedFields` and `AddressExtendedFields` objects. These objects are only available for Brazil addresses and are returned in responses for a Brazil shipping addresses that contain extended fields. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Authorization API v1 (All operations) * FBA Small and Light API v1 (All operations) #### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN` * `POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN` * `RFQ_UPLOAD_FEED` #### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_FBA_UNO_INVENTORY_DATA` * `GET_PRODUCT_EXCHANGE_DATA` *** ## December 13, 2023 #### API changes ##### [Application Management API v2023-11-30 Public Beta](https://developer-docs.amazon.com/sp-api/reference/application-management-v2023-11-30) * New Application Management API lets you programmatically rotate your Login with Amazon (LWA) credentials (client secrets). Available in public beta. ##### [Shipping API v2](https://developer-docs.amazon.com/amazon-shipping/docs/shipping-api-v2-reference) * Launched support for dangerous goods (DG) shipping in the US and UK markets. ##### [Listings Items API v2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * India (IN) is now a supported Amazon store * Two new fields added to the `Issue` object: `Enforcements` and `Categories` ##### [Product Type Definitions API v2020-09-01](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01) * `searchDefinitionsProductTypes` operation type updated to string ##### [Notifications API v1](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * Added an optional `payloadVersion` parameter * New [Listings Item Issues Change Notification version 2023-12-13](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/notifications/ListingsItemIssuesChangeNotification_2023-12-13.json) has three new enforcement actions: `LISTING_SUPPRESSED`, `ATTRIBUTE_SUPPRESSED`, and `CATALOG_ITEM_REMOVED` #### Documentation updates [Vendor Direct Fulfillment Orders API v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-orders-api-use-case-guide) was updated to include a section on [Direct Fulfillment customer data transmission](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-orders-api-use-case-guide#direct-fulfillment-customer-data-transmission). Vendors do not receive customer data such as name, address, or phone number for certain shipments fulfilled through the `getOrder` and `getOrders` operations. For Amazon label only vendors, certain fields will be replaced with the fictitious value `XXXXX`. The [Vendor Retail Procurement APIs v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide) has been updated to include information on using the Operations [SubmitShipments](https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#submitshipments) and [GetShipmentDetails](https://developer-docs.amazon.com/sp-api/docs/vendor-retail-procurement-apis-v1-use-case-guide#getshipmentdetails). [`GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA`](https://developer-docs.amazon.com/sp-api/docs/fba-payments-reports-attributes#get_fba_fulfillment_longterm_storage_fee_charges_data) now includes updated column names. A note has been added to the FBA Long Term Storage Fee Charges Report on the [Fulfillment by Amazon (FBA) Report Type Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values-fba#fba-payments-reports) page, outlining the correct way to generate the report. The Fulfillment by Amazon (FBA) bulk invoice report (`FBA_BULK_INVOICE`) shares the invoices for a seller within the given date range. These invoices include customer orders served by the seller. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Authorization API v1 (All operations) * FBA Small and Light API v1 (All operations) * Fulfillment Inbound API v0 (Select operations) * `getInboundGuidance` * Merchant Fulfillment API v0 (Select operations) * `getEligibleShipmentServicesOld` * `cancelShipmentOld` * `getAdditionalSellerInputsOld` ##### [Feeds](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * `POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN` * `POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN` * `RFQ_UPLOAD_FEED` ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_FBA_UNO_INVENTORY_DATA` * `GET_PRODUCT_EXCHANGE_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `ORDER_STATUS_CHANGE` *** ## November 8, 2023 #### API changes ##### [Supply Sources API v2020-07-01](https://developer-docs.amazon.com/sp-api/reference/supply-sources-v2020-07-01) * New Supply Sources API configures and updates information on seller supply sources, such as stores and warehouses. ##### [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * The United Kingdom is now a valid Amazon store. * `getFeaturedOfferExpectedPriceBatch`(FOEP) has been extended to [Amazon.co.uk](http://amazon.co.uk). * `ASIN_NOT_ELIGIBLE` is now a value for `resultStatus`. * The new `competitiveSummary` operation returns the competitive summary response including featured buying options for the ASIN and `marketplaceId` combination. ##### [Product Type Definitions API v2020-09-01](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01) * Updated for three new parameters (`itemName`, `locale`, and `searchlocale`) and one new `displayName` product type. ##### [Finances API v0](https://developer-docs.amazon.com/sp-api/reference/finances-v0) * Updated `ListFinancialEvent` and `ListFinancialEventGroups` operations more clearly communicate expected responses and scope. The response for `ChangeRefundTransactions` was modified from an object to an array. ##### [Vendor Direct Fulfillment Shipping API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v2021-12-28) and [v1](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v1) * Updated `weight` field is now mandatory. This change will generate an error when invoking `shipmentconfirmations` so that vendors do not have to wait for an error during transaction status. #### Documentation updates * New [Multi-Location Inventory (MLI) Integration guide](https://developer-docs.amazon.com/sp-api/docs/mli-integration-guide) advises Selling Partners on the APIs and operations that are mandatory for integration with MLI , which allows multi location sellers to provide Amazon with location-level data on their inventory and actual fulfillment capabilities. * Updated Building Listings Management Workflows Guide now includes steps to retrieve a recommendation using the `itemName` or `keywords` in the [List an item that does not already exist in the Amazon catalog](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide#list-an-item-that-does-not-already-exist-in-the-amazon-catalog) workflow. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * Authorization API v1 (All operations) * FBA Small and Light API v1 (All operations) * Fulfillment Inbound API v0 (Select operations) * `getInboundGuidance` * Merchant Fulfillment API v0 (Select operations) * `getEligibleShipmentServicesOld` * `cancelShipmentOld` * `getAdditionalSellerInputsOld` ##### [Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_FBA_UNO_INVENTORY_DATA` * `GET_PRODUCT_EXCHANGE_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `ORDER_STATUS_CHANGE` *** ## October 11, 2023 #### API changes ##### [Listings Items API 2021-08-01](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) * Updated `ItemProcurement` data element changed from object to an array. ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * A list of associated items was added to the response for the `getOrderItems` operation. ##### [Product Pricing API v0](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v0) * The `listingPrice` attribute in the `getItemOffers` response was renamed to help developers avoid errors when extending their code for business-to-business use cases. The `Landedprice` and `Shipping` sub-fields are no longer required, but optional. #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_FBA_UNO_INVENTORY_DATA` * `GET_PRODUCT_EXCHANGE_DATA` ##### [Notifications](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * `ORDER_STATUS_CHANGE` *** ## September 20, 2023 #### API changes ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * The `BuyerCompanyName` operation description in the Orders v0 API has been updated to clarify the company name of the destination address. #### Documentation updates * Updated [Building Listings Management Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide) includes guidance for using the Listings Items API to create package hierarchy relationships, which can link units, case packs, and pallets of a product to create a connected listing. For more information, refer to [Configuring package hierarchies](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide#configuring-package-hierarchies). #### 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 removal date. For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). ##### [APIs](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * `GET_FBA_UNO_INVENTORY_DATA` * `GET_PRODUCT_EXCHANGE_DATA` *** ## August 16, 2023 #### API changes ##### [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-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 Amazon stores to support seller-fulfilled Prime orders. If your integration uses the new shipping templates for these regions, you might need to update your integration to accept the `Priority` value for `ShipmentServiceLevelCategory`. ##### [Catalog Items API v2022-04-01](https://developer-docs.amazon.com/sp-api/reference/catalog-items-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 * The SP-API developer documentation site recently published a new [Welcome](https://developer-docs.amazon.com/sp-api/docs/welcome) topic. This topic provides resources for migrating to and integrating with SP-API, tips for searching the documentation site, and quick links to popular SP-API content. * The SP-API developer documentation site has been updated to include new and improved developer registration topics including how to [Register as a public developer](https://developer-docs.amazon.com/sp-api/docs/register-as-a-public-developer), how to [Register as a private developer](https://developer-docs.amazon.com/sp-api/docs/register-as-a-private-developer), how to [Register as a private vendor](https://developer-docs.amazon.com/sp-api/docs/register-as-a-private-vendor), how to [Apply for restricted (PII) roles](https://developer-docs.amazon.com/sp-api/docs/applying-for-pii-roles), and how to [Check the status of your request to register as a developer](https://developer-docs.amazon.com/sp-api/docs/check-the-status-of-your-request-to-register-as-a-developer). #### Deprecation notices We have adjusted the removal date for the following APIs: * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#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](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## June 21, 2023 #### API changes ##### Replenishment API * New [Replenishment API v2022-11-07](https://developer-docs.amazon.com/sp-api/reference/replenishment-v2022-11-07) returns a selling partner's replenishment program (Subscribe & Save) metrics and offer information. This API is available in the following Amazon stores: 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`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/marketplaceAsinPageViewMetrics.json) report provides information on the ASIN page view (glance view) metrics for the DE, FR, IT, ES, NL, PL, SE and BE (EU-8) Amazon stores, with data available up to the last seven days. ###### Rapid Retail Analytics * New [`GET_VENDOR_REAL_TIME_SALES_REPORT`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/vendorRealTimeSalesReport.json) shares sales data at an ASIN level, aggregated hourly. Requests can span multiple date range periods. * New [`GET_VENDOR_REAL_TIME_TRAFFIC_REPORT`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/vendorRealTimeTrafficReport.json) shares data on the customer traffic to the detail pages of the vendor's items, aggregated hourly. Requests can span multiple date range periods. * New [`GET_VENDOR_REAL_TIME_INVENTORY_REPORT`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/vendorRealTimeInventoryReport.json) shares inventory data at an ASIN level, aggregated hourly. ##### Listings Items API * [Listings Items API](https://developer-docs.amazon.com/sp-api/reference/listings-items-v2021-08-01) now available in the Belgium (BE) Amazon store. ##### Notifications API * New [`LISTINGS_ITEM_MFN_QUANTITY_CHANGE`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#listings_item_mfn_quantity_change) notification is sent whenever there is change in the available quantity of a listings item. * New [`ORDER_CHANGE`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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 can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour. * New [`ITEM_INVENTORY_EVENT_CHANGE`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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 can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour. * New [`DETAIL_PAGE_TRAFFIC_EVENT`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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 can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour. #### Documentation updates * New [Migrating Listings Management Workflows guide](https://developer-docs.amazon.com/sp-api/docs/migrating-listings-management-workflows) helps you migrate your existing listings management workflows from XML-based and flat file feeds to the Selling Partner Listings Items API and JSON-based feeds. * Updated reports schemas repo includes [`GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/b2bProductOpportunitiesRecommendedForYouReport-2020-11-19.json) and [`GET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON`](https://github.com/amzn/selling-partner-api-models/blob/main/schemas/reports/b2bProductOpportunitiesNotYetOnAmazonReport-2020-11-19.json) #### 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 removal date * [`ORDER_STATUS_CHANGE`](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * [`MFN_ORDER_STATUS_CHANGE`](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) For more detailed information about SP-API deprecation dates, refer to the [Deprecations table](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations). *** ## May 17, 2023 #### API changes ##### [Vendor Direct Fulfillment Shipping v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v2021-12-28) * Updated the dynamic sandbox to include the `createShippingLabels` operation. ##### [Orders V0](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Remove the Generic Orders Approvals workflow. Removed `ItemApprovalTypes` and `ItemApprovalStatus` attributes. #### Documentation updates * New [Reports attributes directory](https://developer-docs.amazon.com/sp-api/docs/reports-attributes) lists all the available attributes in SP-API reports. * New [Vendor Retail Procurement FAQ](https://developer-docs.amazon.com/sp-api/docs/sp-api-vendor-retail-procurement-faq) includes frequently asked questions regarding the SP-API Vendor Retail Procurement API. #### Deprecation notices * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [`POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN`](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) * [`POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN`](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#feeds) *** ## April 19, 2023 #### API changes ##### [Fulfillment Outbound API](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * Updated the `city` property in the `address` attribute from **required** to **optional**. ##### [Fulfillment By Amazon (FBA) Inventory API](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) * Updated the `sellerSku` field to include and parse commas. #### Documentation updates ##### [Product Type Definition Meta Schema](https://developer-docs.amazon.com/sp-api/docs/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 * Added two new C# guides: [Generate a C# SDK with LWA Token Generation and Authentication](https://developer-docs.amazon.com/sp-api/docs/generate-a-c-sharp-sdk-with-lwa-token-generation-and-authentication) and [Connect to the Selling Partner API using a generated C# SDK](https://developer-docs.amazon.com/sp-api/docs/connect-to-the-selling-partner-api-using-a-generated-c-sharp-sdk). #### Deprecation notices * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) *** ## March 29, 2023 #### API changes ##### [Fulfillment By Amazon (FBA) Inventory API](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) * Update `nextToken` to expire after 30 seconds. ##### [Orders API](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added `confirmShipment` operation. ##### [Fulfillment Outbound API](https://developer-docs.amazon.com/sp-api/reference/fulfillment-outbound-v2020-07-01) * 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 * New [Orders API Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-use-case-guide) for the Orders v0 shipment confirmation operation. The `confirmShipment` operation confirms the shipment status for a specified order. It can also be used to edit shipment details of orders that have been shipped. include link to guide (when available) * New use case guide [Fulfillment Outbound API Dynamic Sandbox v2020-07-01](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-dynamic-sandbox-guide) explains how test your applications without affecting production data or initiating real-world events. * Expanded library of reports schemas available on [selling-partner-api-models](https://github.com/amzn/selling-partner-api-models/tree/main/schemas/reports) GitHub repo * Three new Listings Items API resources to address common questions: * [Listings Items API FAQ](https://developer-docs.amazon.com/sp-api/docs/listings-items-faq) * [Listings Items API issues troubleshooting](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-issues-troubleshooting) * [Guidance for complex attributes](https://developer-docs.amazon.com/sp-api/docs/listings-items-guidance-for-complex-attributes) #### Deprecation notices * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) *** ## February 22, 2023 #### API changes ##### [Merchant Fulfillment API](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0) * Updated static sandbox mock responses to display names of select UPS domestic (US) ship methods on SP-API. ##### [Orders V0 API](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Added the following delivery preferences attributes to [`getOrderAddress`](https://developer-docs.amazon.com/sp-api/reference/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](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-orders-v2021-12-28) * The `customizedUrl` attribute of `buyerCustomizedInfo`, returned by the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-2) and [`getOrders`](https://developer-docs.amazon.com/sp-api/reference/getorders-2) operations, is now a Base 64 encoded URL using the UTF-8 character set. ##### [Vendor Retail Procurement Orders API](https://developer-docs.amazon.com/sp-api/reference/vendor-orders-v1) * Updated to pass `six-month-past-in-date` as a query parameter. #### Documentation updates * New [Amazon Business Orders Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/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](https://developer-docs.amazon.com/sp-api/docs/sales-api-v1-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](https://developer-docs.amazon.com/sp-api/docs/fba-small-and-light-v1-use-case-guide) introduces operations to help access the Small and Light FBA program. #### Deprecation notices * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) *** ## January 25, 2023 #### API changes ##### [Product Pricing API](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01) * New `getFeaturedOfferExpectedPriceBatch` operation retrieves responses to a batch of up to 40 featured offer expected price (FOEP) requests. ##### [Vendor Direct Fulfillment Orders API](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-orders-v2021-12-28) * 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](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * New `serialNumber` attribute returns a list of serial numbers for electronic products that are shipped to customers. Returned for FBA orders only. ##### [Finances API](https://developer-docs.amazon.com/sp-api/reference/finances-v0) * New financial event type: `CapacityReservationBillingEventList` allows you to retrieve details related to a Capacity Reservation Billing charge. #### Documentation updates * New use case directories identify the APIs, notifications, and reports that you’ll need for general SP-API [Seller](https://developer-docs.amazon.com/sp-api/docs/sp-api-seller-use-cases) and [Vendor](https://developer-docs.amazon.com/sp-api/docs/sp-api-vendor-use-cases) use cases. Additionally, the [SP-API models table](https://developer-docs.amazon.com/sp-api/docs/sp-api-models) indicates whether each API is available for sellers or vendors and includes links to each model’s reference and any relevant release notes. * New [Vendor Direct Fulfillment Orders API v2021-23-28 use case guide](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-orders-api-2021-12-28-use-case-guide) covers the Vendor DF Orders API, which provides programmatic access to a direct fulfillment vendor's order data. * New [Vendor Direct Fulfillment Transaction Status API v2021-12-28 use case guide](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-transaction-api-2021-12-28-use-case-guide) covers the Vendor DF Transaction Status API, which provides programmatic access to a direct fulfillment vendor's transaction status. * Updated dynamic usage plans topic for the [Usage Plans and Rate Limits in the SP-API Guide](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api) includes the Product Pricing API and `getFeaturedOfferExpectedPriceBatch` operation. #### Deprecation notices * [Feeds API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [Reports API v2020-09-04](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#apis) * [FBA Inventory Reports](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#reports) * [`MFN_ORDER_STATUS_CHANGE` Notification](https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations#notifications) *** ## December 6, 2022 #### API changes ##### [Catalog Items API](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v2022-04-01) 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: * `ItemContributor` * `ItemContributorRole` In addition, the following attributes have been added to `ItemSummaryByMarketplace`: * `adultProduct` * `autographed` * `memorabilia` * `releaseDate` * `tradeInEligible` *** ## November 9, 2022 #### API changes ##### [Reports API](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * New GST Merchant Tax Report B2B [`GET_GST_MTR_B2B_CUSTOM`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#tax-reports) provides detailed information about sales, refunds, and cancellations from Amazon Business invoices issued within a date range that you specify. Only available in the Amazon India store. * New GST Merchant Tax Report B2C [`GET_GST_MTR_B2C_CUSTOM`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#tax-reports) provides detailed information about sales, refunds, and cancellations from consumer invoices issued within a date range that you specify. Only available in the Amazon India store. * New GST Merchant Stock Transfer Report [`GET_GST_STR_ADHOC`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#tax-reports) provides details on inventory movements from Amazon fulfillment centers (FC) (FC removals or FC-to-FC transfers). The report contains transaction level details required for accounting and GST tax filing. Only available in the Amazon India store. #### Documentation updates * New [Building Listings Management Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide) describes the steps you can take to build best-in-class listings creation and management workflows by integrating with the Selling Partner API. *** ## October 19, 2022 #### API changes ##### [Notifications API](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) Updated for new [`FBA_INVENTORY_AVAILABILITY_CHANGES`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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 Amazon stores in a particular region. ##### [Reports API](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Updated [`GET_SALES_AND_TRAFFIC_REPORT`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#seller-retail-analytics-reports), 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`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#fulfillment-by-amazon-fba-reports) 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`](https://developer-docs.amazon.com/sp-api/docs/report-type-values#fulfillment-by-amazon-fba-reports) 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 * New [Selling Partner API Guard Implementation Guide](https://developer-docs.amazon.com/sp-api/docs/sp-api-guard-implementation-guide) describes architectural considerations and configuration steps for deploying Amazon Selling Partner Guard in AWS Cloud. *** ## September 21, 2022 #### API changes ##### [Vendor Direct Fulfillment Shipping API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v2021-12-28) * Updated for new [createShippingLabels](https://developer-docs.amazon.com/sp-api/reference/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](https://developer-docs.amazon.com/sp-api/reference/tokens-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](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * Updated [Inventory Ledger Report](https://developer-docs.amazon.com/sp-api/docs/report-type-values#fulfillment-by-amazon-fba-reports) (`GET_LEDGER_DETAIL_VIEW_DATA`) now includes a new `eventType` filter to filter on particular warehouse events. #### Documentation updates * New [VAT Calculation Service Guide](https://developer-docs.amazon.com/sp-api/docs/vat-calculation-service-guide) provides developers in EU stores with guidance for Amazon’s VAT Calculation Service. * New [Solicitations API v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/solicitations-api-use-case-guide) covers the Selling Partner API for Solicitations (Solicitations API) which helps you build applications that let sellers send consistent, high-quality solicitations to buyers. * New [Messaging API v1 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/messaging-api-v1-use-case-guide) discusses the Messaging API. * New [URL encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding) guide explains how to encode URLs to avoid errors with SKUs. * Updated [Vendor Direct Fulfillment Dynamic Sandbox Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-dynamic-sandbox-guide) includes support for Vendor Direct Fulfillment Shipping v2021-12-28 operations. Note that the createShippingLabels operation does not have any sandbox support at this time. *** ## August 10, 2022 #### API changes ##### [Orders V0 API](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * Improvements to the Orders API in support of Easy Ship shipments. ##### [Services V1 API](https://developer-docs.amazon.com/sp-api/reference/services-v1) * 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](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v2022-04-01) * 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 (such as ASINs, UPCs, and EANs) * 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](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * 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](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * 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](https://developer-docs.amazon.com/sp-api/reference/product-fees-v0) * Updated for new `getMyFeesEstimates` operation that retrieves product fee estimates for a list of products and Amazon stores. ##### [Product Pricing API](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v0) * Updated for new `getItemOffersBatch` and `getListingOffersBatch` operations that retrieve product pricing and offer information in a list for products. ##### [Reports API](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) * New [EPR Monthly Report, EPR Quarterly Report, and EPR Annual Reports](https://developer-docs.amazon.com/sp-api/docs/report-type-values#regulatory-compliance-reports) report types include data on the Extended Producer Responsibility (EPR) declarations for service providers in France and Germany to help sellers maintain compliance with EU regulations. *** ## April 13, 2022 #### API changes ##### [Easy Ship API](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) * New [Easy Ship API](https://developer-docs.amazon.com/sp-api/reference/easy-ship-v2022-03-23) helps you build applications that help sellers manage and ship Amazon Easy Ship orders. ##### [FBA Inventory API](https://developer-docs.amazon.com/sp-api/reference/fba-inventory-v1) * Updated FBA Inventory API for global availability and released new FBA Inventory Use Case Guide. ##### [Notifications API](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * New [`PRICING_HEALTH`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#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`](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#order_status_change) 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](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-apis-use-case-guide) * New [Vendor Direct Fulfillment Orders API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-orders-v2021-12-28) provides programmatic access to a direct fulfillment vendor's order data. This v2021-12-28 release adds support for dynamic sandbox testing. * New [Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-sandbox-test-data-v2021-10-28) provides programmatic access to vendor direct fulfillment sandbox test data. * New [Vendor Direct Fulfillment Shipping API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-shipping-v2021-12-28) reference provides programmatic access to a direct fulfillment vendor's shipping data. This v2021-12-28 release adds support for dynamic sandbox testing. * New [Vendor Direct Fulfillment Transactions API v2021-12-28](https://developer-docs.amazon.com/sp-api/reference/vendor-direct-fulfillment-transactions-v2021-12-28) provides programmatic access to a direct fulfillment vendor's transaction status. This v2021-12-28 release adds support for dynamic sandbox testing. #### Documentation updates * New [Vendor Direct Fulfillment Dynamic Sandbox Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-dynamic-sandbox-guide) introduces the available dynamic sandbox operations for the Vendor Direct Fulfillment APIs. * New [Vendor Retail Analytics Reports Migration Guide](https://developer-docs.amazon.com/sp-api/docs/vendor-retail-analytics-reports-migration-guide) that explains changes to the vendor retail analytics reports and provides steps for migration. *** ## March 23, 2022 #### API changes ##### [Orders API](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * New `buyerRequestedCancel` parameter provides information on whether a buyer requested order cancellation and reason for cancellation. ##### [Reports API](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30) New [Seller retail analytics reports](https://developer-docs.amazon.com/sp-api/docs/report-type-values#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](https://developer-docs.amazon.com/sp-api/docs/report-type-values#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](https://developer-docs.amazon.com/sp-api/docs/report-type-values#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](https://developer-docs.amazon.com/sp-api/docs/report-type-values#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](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v0) * 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` * `CreateInboundShipment` * `UpdateInboundShipment` * `PreviewItemEligibility` Read more about this change on [Seller Central](https://sellercentral.amazon.com/forums/t/new-mws-error-code-for-non-compliant-products-lacking-compliance-documentation/953497). [Orders API](https://developer-docs.amazon.com/sp-api/reference/orders-v0) * New `buyerTaxInformation` attribute for the Amazon Turkey store. This attribute includes business tax information when the buyer is a business. [Notifications API](https://developer-docs.amazon.com/sp-api/reference/notifications-v1) * New **Order Status Change** notification is sent whenever there is a change in the status of order availability. [Reports API](https://developer-docs.amazon.com/sp-api/docs/report-type-values) * 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](https://developer-docs.amazon.com/sp-api/docs/amazon-mws-to-sp-api-migration-guide) * Updated documentation with additional migration guidance and resources, including the [Selling Partner API (SP-API) Video Series on YouTube](https://www.youtube.com/playlist?list=PLyrrqKCT7jFKENJO9n_Y68-5o2GZLgLUU) for step-by-step migration assistance and the [Selling Partner API on AWS Quick Start](https://aws.amazon.com/quickstart/architecture/amazon-selling-partner-api) for configuring IAM resources and deploying SP-API on the AWS Cloud.