Trading API

Trading API Release Notes

The latest version of the Trading API has rolled out to all the API machines and is now available! Be sure to check out all the new features and known issues.

If you are getting started with the API, the following locations have information about joining the eBay Developers Program, creating test users, and other steps to getting your application certified to go live against the eBay production servers:

Q3 2021
Version Release Date
1225 2021-Sep-24
1223 2021-Sep-10
1221 2021-Aug-27
1219 2021-Aug-13
1217 2021-Jul-30
1215 2021-Jul-16
1213 2021-Jul-02
Q2 2021
Version Release Date
1211 2021-Jun-18
1209 2021-Jun-04
1207 2021-May-21
1205 No Schema or Doc Updates
1203 2021-Apr-23
1201 2021-Apr-09
Q1 2021
Version Release Date
1199 2021-Mar-26
1197 2021-Mar-12
1195 No Schema or Doc Updates
1193 2021-Feb-12
1191 Not Released
1189 2021-Jan-15
1187 Not Released
Q4 2020
Version Release Date
1185 No Schema or Doc Updates
1183 No Schema or Doc Updates
1181 No Schema or Doc Updates
1179 2020-Nov-06
1177 2020-Oct-23
1175 No Schema or Doc Updates

These release notes go back four quarters. For older release notes, see the Release Notes archive.

The lowest supported version is 941.
To learn how versioning works in the Trading API, see eBay's Schema Versioning Strategy.

Version 1211

Index of Changed Calls - 1211

Schema Changes - 1211

Announcements - 1211

New Features - 1211

Changed Functionality - 1211

Documentation Changes and Errata - 1211

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1211

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1211

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1211

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1211

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1211.

None for this release.

Changed Functionality - 1211

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

New Marketplaces Supported for Adding Videos to Listings

The capability to add videos to eBay listings is now supported on the UK and eBay Motors sites. For more information, please visit the Managing videos page on the developer portal.

Documentation Changes and Errata - 1211

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1211 and Changed Functionality - 1211.

None for this release.

Version 1209

Index of Changed Calls - 1209

Schema Changes - 1209

Announcements - 1209

New Features - 1209

Changed Functionality - 1209

Documentation Changes and Errata - 1209

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1209

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1209

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

Name Part of Schema Type of Change
eBayTaxReferenceValue Type New
TaxesType.eBayReference Field New
ValueTypeCodeType.VATIN Enum New
AccountDetailEntryCodeType.DepositProcessingVariableFee Enum New
AccountDetailEntryCodeType.DepositProcessingVariableFeeCredit Enum New
AccountDetailEntryCodeType.DepositProcessingFixedFee Enum New
AccountDetailEntryCodeType.DepositProcessingFixedFeeCredit Enum New

Announcements - 1209

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1209

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1209.

New Schema Added to Support the Return of VAT Identifier Numbers in Order Management Calls

When VAT is applicable to an order, a buyer's VAT Identifier Number (VATIN) will be returned at the order level, and eBay's VAT tax ID will be returned at the line item level for all order management calls. This VAT information will be returned in the following locations:

Note: The eBay VAT ID and buyer VATIN fields will not start getting returned until June 30, 2021.

Going forward after June 30, developers will need to use a Trading WSDL with a version number of 1211 (or newer) for the VAT ID/VATIN values to be returned in the new fields. Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using an older version than 1211, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or higher.

On January 31, 2022, the Order.ShippingAddress.Street2 will stop being used to return VAT information regardless of WSDL version or compatibility level.

Changed Functionality - 1209

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

Update to GetAccount Call for New Deposit Processing Fees/Credits

Four new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for new deposit processing fees/credits. The enumeration values include:

See these new values in AccountDetailEntryCodeType for more information.

All Remaining Selling Manager Calls Now Decomissioned

All of the remaining Selling Manager calls have been decommissioned and removed from the Trading WSDL and docs.

Listing Recommendations in Responses of Add/Revise/Relist/Verify Calls No Longer Supported

Sellers no longer have the option of choosing to have applicable Listing Recommendations returned in the responses of Add/Revise/Relist/Verify calls. The IncludeRecommendations boolean field has been removed from ItemType, and all ListingRecommendations containers have been removed from the response types of the Add/Revise/Relist/Verify calls.

Documentation Changes and Errata - 1209

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1209 and Changed Functionality - 1209.

None for this release.

Version 1207

Index of Changed Calls - 1207

Schema Changes - 1207

Announcements - 1207

New Features - 1207

Changed Functionality - 1207

Documentation Changes and Errata - 1207

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1207

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1207

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1207

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1207

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1207.

None for this release.

Changed Functionality - 1207

Behavior Changes for the VATPercent Value

The float value input for the VATDetails.VATPercent field in an Add/Revise/Relist call can only have one digit beyond the decimal point (e.g. 12.3). Previously, three digits after the decimal point were allowed.

The maximum VAT percentage allowed has also been reduced from 30 percent to 27 percent. To account for this change, the existing 21916387 Error Code has been revised to say: The VAT rate needs to be between 0% and 27% with at most one decimal digit. (instead of 0% and 30%).

Documentation Changes and Errata - 1207

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1207 and Changed Functionality - 1207.

Some Minor Doc Cleanup to AccountDetailEntryCodeType Enums

Made some minor documentation updates to some of the enum values in AccountDetailEntryCodeType.

Version 1203

Index of Changed Calls - 1203

Schema Changes - 1203

Announcements - 1203

New Features - 1203

Changed Functionality - 1203

Documentation Changes and Errata - 1203

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1203

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1203

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

Name Part of Schema Type of Change
VideoDetailsType Type New
Item.VideoDetails Field New

Announcements - 1203

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1203

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1203.

Videos Now Supported in Listings

eBay has added the capability to add videos to listings. At this time, only one video can be added per listing, and the video must be uploaded to eBay via the Media API.

The VideoDetails container has been added to all Add/Revise/Relist/Verify calls, and passing in the ID for the video will add the video to the listing. eBay will perform a validation check on each specified VideoID value to verify that the video belongs to, and was uploaded by the seller.

The GetItem call will return the VideoDetails container if the listing contains a video, and the seller of the item is the one making the call.

At present, videos can be attached to listings on the eBay US marketplace and can be viewed through the native apps (iOS and Android) only. Additional sites and platforms will be supported in the near future.

Changed Functionality - 1203

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

None for this release.

Documentation Changes and Errata - 1203

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1203 and Changed Functionality - 1203.

None for this release.

Version 1201

Index of Changed Calls - 1201

Schema Changes - 1201

Announcements - 1201

New Features - 1201

Changed Functionality - 1201

Documentation Changes and Errata - 1201

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1201

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1201

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

Name Part of Schema Type of Change
AccountDetailEntryCodeType.AdFeeExpress Enum New
AccountDetailEntryCodeType.AdFeeExpressCredit Enum New

Announcements - 1201

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1201

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1201.

None for this release.

Changed Functionality - 1201

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

Update to GetAccount Call for New Promoted Listing Fee/Credit

Two new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for the new Promoted Listing Express feature. The enumeration values include:

See these new values in AccountDetailEntryCodeType for more information.

New Error Code Added for 1201

The following new error messages that rolled out with the 1201 release:

Documentation Changes and Errata - 1201

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1201 and Changed Functionality - 1201.

VariationTitle Field was Missing MaxLength Constraint Value

Althougth the max length constraint value has always existed for the VariationTitle field, it was not documented until now. The maximum character length for this field is 120 characters. This field is returned in the response of the following calls for multiple-variation listings:

Version 1199

Index of Changed Calls - 1199

Schema Changes - 1199

Announcements - 1199

New Features - 1199

Changed Functionality - 1199

Documentation Changes and Errata - 1199

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1199

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1199

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1199

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1199

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1199.

None for this release.

Changed Functionality - 1199

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

The Max Length of Feedback Comment Fields Increased to 500 Characters.

The maximum length of a Feedback comment has been increased to 500 characters. The table below summarizes the Trading API calls and fields to which this change applies:

Call Field Input/Output?
GetFeedback CommentText Output
FeedbackResponse Output
Followup Output
LeaveFeedback CommentText Input
RespondToFeedback ResponseText Input

Documentation Changes and Errata - 1199

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1199 and Changed Functionality - 1199.

None for this release.

Version 1197

Index of Changed Calls - 1197

Schema Changes - 1197

Announcements - 1197

New Features - 1197

Changed Functionality - 1197

Documentation Changes and Errata - 1197

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1197

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1197

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

Name Part of Schema Type of Change
Category.SpecialFeatures Field New
SiteDefaults.SpecialFeatures Field New

Announcements - 1197

None for this release.

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1197

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1197.

New SpecialFeatures Container Added to GetCategoryFeatures

A new SpecialFeatures container was added to GetCategoryFeatures. This container will be returned if the user is searching for item condition values (by including and setting a FeatureID field to ConditionValues and the corresponding category supports special item conditions such as Certified Refurbished (Condition ID 2000). This item condition value will no longer be returned under the ConditionValues container.

A seller must be pre-qualified by eBay to list items with the Certified Refurbished condition.

Changed Functionality - 1197

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

New Error Codes Added for 1197

Below is the list of the new error messages that rolled out with the 1197 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1197

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1197 and Changed Functionality - 1197.

None for this release.

Version 1193

Index of Changed Calls - 1193

Schema Changes - 1193

Announcements - 1193

New Features - 1193

Changed Functionality - 1193

Documentation Changes and Errata - 1193

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1193

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1193

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

Name Part of Schema Type of Change
FulfillmentType Type New
Program.Fulfillment Field New
ShippingServiceCostOverride.ShippingSurcharge Field Removed

Announcements - 1193

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1193

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1193.

New eBay Fulfillment Tags Returned in Order Management Calls

A new Fulfillment container will be returned in GetOrders, GetOrderTransactions, GetItemTransactions (to seller only), and GetSellerTransactions for paid orders being fulfilled by eBay or an eBay fulfillment partner.

Changed Functionality - 1193

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

Certified Refurbshed Program has Rolled Out Globally

In all eBay marketplaces, Condition ID 2000 now maps to an item condition of 'Certified Refurbished', and not 'Manufacturer Refurbished'. To list an item as 'Certified Refurbished', a seller must be pre-qualified by eBay for this feature. Condition ID 2500, 'Seller Refurbished' is the other option for sellers.

Any seller that is interested in eligibility requirements to list with 'Certified Refurbished' should see the Certified refurbished program page in Seller Center.

Multiple Shipping Rate Tables Enabled in UK and DE

The capability for sellers to create and maintain multiple domestic and international shipping rate tables has rolled out to the UK and Germany marketplaces. Prior to this, these sellers only had one 'default' domestic shipping rate table and one 'default' international shipping rate table.

In Add/Revise/Relist calls, a seller specifies the domestic and/or international shipping rate table to use for the listing through the ShippingDetails.RateTableDetails container.

Multiple shipping rate tables are now supported in the following marketplaces: US, Australia, Canada (English and French), Italy, UK, and Germany.

ShippingServiceCostOverride.ShippingSurcharge Field Removed from WSDL

The ShippingServiceCostOverride.ShippingSurcharge has been removed from WSDL. This field was already not usable and was marked as deprecated. Sellers can only apply shipping surcharges to shipping service options through the Shipping rate tables tool in My eBay.

Documentation Changes and Errata - 1193

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1193 and Changed Functionality - 1193.

None for this release.

Version 1189

Index of Changed Calls - 1189

Schema Changes - 1189

Announcements - 1189

New Features - 1189

Changed Functionality - 1189

Documentation Changes and Errata - 1189

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1189

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1189

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1189

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

All Selling Manager Pro Calls to be Decommissioned

All Selling Manager Pro calls are being deprecated. Selling Manager Pro calls will start being decommissioned beginning on June 1, 2021.

New Features - 1189

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1189.

None for this release.

Changed Functionality - 1189

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

Error Message Updates

The following warning message was added:

The existing 21916605 error message was updated to: Only single item quantity is permitted when the listing is in auction-style or under selected categories in FixedPrice format. Before the update, this error message text was not covering the fixed-price use case.

Documentation Changes and Errata - 1189

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1189 and Changed Functionality - 1189.

ShippingSurcharge Field Marked as Deprecated

The ShippingSurcharge field in ShippingServiceCostOverrideType marked as deprecated. Sellers can no longer directly apply shipping surcharges to listings through Add/Revise calls or through shipping business policies. Shipping surcharges can only be applied to shipping service options through the Shipping rate tables tool in My eBay.

Item.eBayPlus Field not Supported for Australian Sellers

Added a note to Item.eBayPlus field description about the field not being supported for Australian sellers. In Australia, eBay will evaluate/determine whether a listing is eligible for eBay Plus, and the seller has no control over setting the feature for a listing.

Version 1179

Index of Changed Calls - 1179

Schema Changes - 1179

Announcements - 1179

New Features - 1179

Changed Functionality - 1179

Documentation Changes and Errata - 1179

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1179

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1179

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1179

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

Some Trading API Calls are Scheduled for Deprecation

The GetPromotionalSaleDetails, SetPromotionalSaleListings, and SetPromotionalSale calls are being deprecated, and they will no longer be supported after March 31, 2021. eBay recommends that sellers use the Marketing API, which provides all Promotions Manager capabilities. The Marketing API will continue to be improved and enhanced as more marketing features become available to sellers.

New Features - 1179

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1179.

None for this release.

Changed Functionality - 1179

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

None for this release.

Documentation Changes and Errata - 1179

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1179 and Changed Functionality - 1179.

Documentation Maintenance and Minor Updates

Some minor documentation updates were made to various type files.

Version 1177

Index of Changed Calls - 1177

Schema Changes - 1177

Announcements - 1177

New Features - 1177

Changed Functionality - 1177

Documentation Changes and Errata - 1177

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1177

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1177

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1177

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1177

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1177.

New enumeration values added for authenticity inspection

New enumeration values were added to AuthenticityVerificationType. Values now account for order line items that fail authentication and are not able to be returned to the seller because of legal constraints, and for order line items that are passed with exception.

Changed Functionality - 1177

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

Updated Error Messages

Below is the list of updated error messages that rolled out with the 1177 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1177

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1177 and Changed Functionality - 1177.

None for this release.

Copyright © 2005–2021 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.