Skip to main content

  • Due to maintenance, marketplace account deletion notifications have been paused. These notifications will resume again when the maintenance is complete. We appreciate your patience.
    Update: Marketplace account deletion notifications have been resumed.
  • NEW Exciting updates and expanded benefits are coming to eBay’s Developer Loyalty Program. Don’t miss out! Learn more.
  • Boost Your eBay Integration Today! Discover the Latest Seller Performance Metrics now available to you via the Notifications Platform. Gain proactive management of the seller standard for your sellers with these valuable insights. Click here to explore now.

The table below lists the API capabilities that are deprecated and scheduled for decommission.

API Call(s)/Method(s)/Field(s) Deprecation Date Decommission Date Notes
legacyOrderId field in the following methods:
2024/12/18 2025/02/24 This field is deprecated and will stopped being returned on February 24, 2025. Please exclusively use the orderId field going forward.
Trading API 2024/10/29 2025/04/28 This call has been deprecated and will be decommissioned on April 28th, 2025.
Trading API 2024/11/04 2025/06/02 This call has been deprecated and will be decommissioned on June 2nd, 2025. This call is being replaced by the getExpiredCategories method of the Taxonomy API.
Product API 2024/09/09 2025/03/31 These calls have been deprecated and will be decommissioned on March 31st, 2025.
Product Metadata API 2024/09/09 2025/03/31 These calls have been deprecated and will be decommissioned on March 31st, 2025.
Merchandising API All 2024/07/29 TBD All calls in the Merchandising API have been deprecated and will be decommissioned at a later date.
Finding API All 2024/01/04 2025/02/05 All calls in the Finding API have been deprecated and will be decommissioned on February 5, 2025.

The alternative to this API is the Browse API, which also has advanced search capabilities.
Shopping API All 2024/01/04 2025/02/05 All calls in the Shopping API have been deprecated and will be decommissioned on February 5, 2025.

The alternative to this API is the Browse API, which also has advanced search capabilities.
Return Management API

All

2023/02/03 TBD

All methods of the Return Management API are scheduled to be decommisioned. The official decommission date will be announced once determined. This API is now out of synch with return management flows on eBay. Current users of the Return Management API and all users interested is programmatically managing return requests should make plans to migrate to the Post-Order API.

Business Policies Management API All 2021/03/23 TBD The Business Policies Management API is deprecated and is scheduled for decommission at a later date. We recommend that you migrate to the fulfillment_policy, payment_policy, and return_policy resources of the Account API to set up and manage all of your fulfillment, payment, and return business policies.