Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

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

API Method(s)/Field(s) Deprecation Date Decommission Date Notes
Listing Recommendation API All 2024/01/30 2024/07/31 All calls in the Listing Recommendation API have been deprecated and will be decommissioned on July 31, 2024.

We recommend that you integrate with the RESTful Recommendation API to retrieve recommendations for improving your listings and sales performance, or with the Compliance API to discover non-compliant listings or listings that are at risk at becoming non-compliant in the future.
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.
Trading API

GetSuggestedCategories

2023/11/29 2024/07/01
The GetSuggestedCategories call has been deprecated and will be decommissioned on July 1st, 2024.

The alternative to this call is the getCategorySuggestions method of the Taxonomy API, which also returns suggested eBay categories based on keywords.
Trading API

The TicketListingDetails and the QuantityInfo containers, and their associated fields in the following calls:

* TicketListingDetails only
2023/08/23 2024/02/26 These containers and their associated fields have been deprecated for the Add/Revise/Relist/Verify and GetItem family of calls. They are not usable and ignored if sent, and are scheduled for decommissioning.
Trading API

UpdateReturnPolicy and UpdateSellerInfo fields in the ReviseItem call.

OriginatingPostalCode field in the following calls:

2023/08/23 2024/02/26
These fields have been deprecated for the listed calls. They are not usable and ignored if sent, and are scheduled for decommissioning.

For the OriginatingPostalCode field, specify the postal code of the item's location in the request field. For example, in the AddItem call specify the item's location using the Item.PostalCode field.
Trading API

GetSellerDashboard

2023/05/12 2024/04/02

The GetSellerDashboard call of the Trading API will be decommisioned on April 2, 2024. The alternative for this API is Seller Standards Profile methods of the Seller Analytics API.

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 in 2022. 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.
Finding API findCompletedItems 2020/10/15 2025/02/05 The findCompletedItems call is deprecated as of October 15, 2020, and access is restricted. All calls in the Finding API will be decommissioned on February 5, 2025.

An alternative to the findCompletedItems call is the Marketplace Insights API, but please note that this API is restricted and requires eBay Business approval for access. Please contact the Developer Technical Support team if you are interested in getting access to the Marketplace Insights API.