The table below lists the API capabilities that are deprecated and scheduled for decommission.
| API | Method(s)/Field(s) | Deprecation Date | Decommission Date | Notes |
|---|---|---|---|---|
|
Store.SubscriptionLevel field returned in the GetStore call. |
2022/09/30 |
2023/03/23 |
This field is deprecated and will stop being returned beginning on March 31, 2023. The getSubscription method of the Account API can be used to retrieve information on a seller's eBay store subscription. |
|
|
2022/09/30 |
2023/04/03 |
The fundingModels array of the createReportTask method will stop supporting multiple values. During the deprecation period, a warning response header will be returned. After decommission date arrives, using multiple values in fundingModels array will be a blocking error. Transaction reports will stop supporting the following metric keys: impressions, clicks, ctr, avg_cost_per_sale, pl_transactions, cpc_impressions, cpc_clicks, cpc_ctr, cpc_conversion_rate, cpc_return_on_ad_spend, cpc_avg_cost_per_sale, cpc_transactions, cpc_ad_fees_listingsite_currency, cpc_ad_fees_payout_currency, cost_per_click. During the deprecation period, a warning response header will be returned specifically calling out these deprecated metrics. |
|
| AddDispute AddDisputeResponse DisableUnpaidItemAssistance GetDispute GetUserDisputes SellerReverseDispute |
2022/09/19 |
2023/01/31 |
These six Dispute calls in the Trading API are deprecated and are scheduled for decommission on January 31, 2023. The DisableUnpaidItemAssistance, AddDisputeResponse, and SellerReverseDispute calls do not have alternative APIs to use since the Unpaid Item Assistant feature and Unpaid Item cases are deprecated. However, there is a page in Selling Preferences in My eBay that allows a seller to cancel and relist any items that have not been paid for after a specified amount of days. There are REST API equivalents for the other three calls as follows:
|
|
| getCharityOrgByLegacyId |
2022/09/12 |
2023/01/16 |
The getCharityOrgByLegacyId method requires a PayPal Giving Fund ID to retrieve an eBay charitable organizaiton, and eBay will no longer support these IDs beginning on January 16, 2023. The alternative to this method is the getCharityOrg method, and this method requires the eBay-generated ID for a charitable organization. |
|
|
2022/08/22 |
2023/03/10 |
GetApiAccessRules is deprecated and is scheduled for decommission on March 10, 2023. Starting on August 22, 2022, this call will only return the ApplicationAggregate container, and no usage data on specific Trading calls. Going forward, we recommend that you make plans to migrate to the Developer Analytics API, an API that retrieves all usage data on all RESTful APIs and the Trading API. |
||
|
The CharityNumber field returned in the following calls: |
2022/07/28 |
2023/01/16 |
The CharityNumber field will stop being returned in the GetSingleItem and GetMultipleItems calls after January 16, 2023. This field is used to specify the PayPal Giving Fund identifier of a non-profit organization and the CharityID field is used to specify the unique eBay-generated identifier of a non-profit organization. All non-profit organizations registered as a charity organization on eBay's platform have both identifiers, but the eBay ID should start being used exclusively going forward. |
|
|
Charity.ExternalID field returned in the GetCharities call. |
2022/07/28 |
2023/01/16 |
The Charity.ExternalID field will stop being returned in the GetCharities call after January 16, 2023. The Charity.ExternalID field is used to specify the PayPal Giving Fund identifier of a non-profit organization and the id attribute of the root Charity field is used to specify the unique eBay-generated identifier of a non-profit organization. All non-profit organizations registered as a charity organization on eBay's platform have both identifiers, but the eBay ID should start being used exclusively going forward. |
|
|
CharityNumber field used by the following calls: |
2022/06/23 |
2023/01/16 |
The CharityNumber field is used by the AddItem family of calls to specify a non-profit organization that will receive sale proceeds from the listing. The CharityNumber field is used to specify the PayPal Giving Fund identifier of a non-profit organization and the CharityID field is used to specify the unique eBay-generated identifier of a non-profit organization. All non-profit organizations registered as a charity organization on eBay's platform have both identifiers, but the CharityNumber field will stop being accepted after January 16, 2023. CharityNumber will also stop being returned in GetBidderList, GetItem, GetOrderTransactions, and GetSellerList after January 16, 2023, and it will be removed from the Trading WSDL. |
|
| 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 | TBD | The findCompletedItems call is deprecated as of October 15, 2020, and access is restricted. 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. |