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 Call(s)/Method(s)/Field(s) Deprecation Date Decommission Date Notes
Trading API

2024/06/14

2025/01/30

The GetChallengeToken and ValidateChallengeInput calls are deprecated, and will be decommissioned on January 30th, 2025.
Trading API
UserData.SummarySchedule and UserData.SMSSubscription containers in the following calls:

2024/05/28

2024/08/26

These containers have been deprecated for the listed calls. They are not usable and ignored if sent, and will be decommissioned on August 26, 2024.
Trading API
DeletedFromUnsoldList and DeletedFromSoldList containers in the GetMyeBaySelling call

2024/04/17

2024/08/19

The DeletedFromUnsoldList and DeletedFromSoldList containers in the GetMyeBaySelling call have been deprecated and will be decommissioned on August 19, 2024. If this container is included in the request after this date, a warning is triggered and the containers are ignored.
Trading API GeteBayOfficialTime 2024/03/20 2025/01/27 The GeteBayOfficialTime call has been deprecated and will be decommissioned on January 27, 2025.
  • If you were using the GeteBayOfficialTime call to validate Auth & Auth tokens, please use GetTokenStatus instead.
  • If you are using this call just to get the time, eBay uses UTC so any internet time server can be used to keep the client in sync with UTC time.
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.
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.