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:

Q4 2019
Version Release Date
1133 Not Released
1131 2019-Oct-25
1129 2019-Oct-11
Q3 2019
Version Release Date
1127 Not Released
1125 2019-Sep-13
1123 Not Released
1121 Not Released
1119 2019-Aug-02
1117 Not Released
1115 Not Released
Q2 2019
Version Release Date
1113 2019-Jun-21
1111 2019-Jun-07
1109 Not Released
1107 2019-May-10
1105 Not Released
1103 Not Released
Q1 2019
Version Release Date
1101 2019-Mar-29
1099 2019-Mar-15
1097 Not Released
1095 2019-Feb-15
1093 Not Released
1091 2019-Jan-18

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 1131

Index of Changed Calls - 1131

Schema Changes - 1131

Announcements - 1131

New Features - 1131

Changed Functionality - 1131

Documentation Changes and Errata - 1131

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

Index of Changed Calls - 1131

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 - 1131

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
GetAccountRequest.OrderID Field New
AccountHistorySelectionCodeType.OrderId Enum New

Announcements - 1131

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.

Category and Item Specific Changes

Category and item specific changes were rolled out as part of the 2019 Fall Seller Release.

To get more information on the category changes, and to see the full list of affected categories, go here. For sellers using the add and revise listing calls of the Trading API to add/revise items, old category IDs will automatically be remapped to new category IDs as long as the CategoryMappingAllowed boolean field is not set to false (it's set to true by default).

Item specific changes went into effect on October 15, 2019. To get more information on the item specifics changes, go here. For sellers using legacy APIs (like Trading API), we suggest that you call GetCategorySpecifics for your category to get the required and recommended item specifics for your category. To see if an item specific is required, recommended, or optional, look at the NameRecommendation.ValidationRules.UsageConstraint field for each item specific returned in the response. Sellers will be blocked from listing/revising an item if required item specifics are not included. As long as they are relevant/applicable to the item, sellers should also make sure to include recommended and optional item specifics as well, and this may make it easier for buyers to find your listings. A REST alternative to the Trading API's GetCategorySpecifics is the Taxonomy API's getItemAspectsForCategory call.

Both category metadata calls mentioned above will return the latest item specific metadata, but newly added item specific names can also be found in table format (organized by category) on this page. All of the item specific names on this page are required, so sellers can search for their listing categories on this page to make sure their listings in these categories have these item specfics.

New Features - 1131

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 - 1131.

GetAccount Updated to Retrieve Account Entries Related to a Specific Order

The GetAccount call was updated to retrieve account entries related to a specific order. To search for account entries related to a specific order, the user includes the AccountHistorySelection field in the request and sets it value to (newly-added) OrderId, and includes the newly-added OrderID field and sets its value to the unique identifier of the order. If one or more account entries are found for the specified order, the corresponding AccountEntry.OrderId will be shown for those account entries.

Changed Functionality - 1131

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 Code Added to Cover BIN Prices Exceeding Threshold

A new error code (21920255) was added to cover 'Buy it Now' prices that exceed the maximum thresdhold for a category. If a seller specifies the 'Buy it Now' price at a value above this threshold, this error code is returned and the seller is blocked from listing/revising an item.

Documentation Changes and Errata - 1131

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

None for this release.

Version 1129

Index of Changed Calls - 1129

Schema Changes - 1129

Announcements - 1129

New Features - 1129

Changed Functionality - 1129

Documentation Changes and Errata - 1129

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

Index of Changed Calls - 1129

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 - 1129

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
CollectionMethodCodeType Type New (reserved for future use)
TaxDetailsType.CollectionMethod Field New (reserved for future use)
AccountEntryType.OrderId Field New
AccountDetailsEntryType.PaymentIntermediationFeeCredit Enum New
AccountDetailsEntryType.EbaySendLabelFee Enum New
AccountDetailsEntryType.EbaySendLabelFeeCredit Enum New
AccountDetailsEntryType.USInternetSalesTax Enum New
AccountDetailsEntryType.USInternetSalesTaxCredit Enum New
AccountDetailsEntryType.NewZealandGST Enum New
AccountDetailsEntryType.NewZealandGSTCredit Enum New
AccountDetailsEntryType.AustraliaGST Enum New
AccountDetailsEntryType.AustraliaGSTCredit Enum New
AccountDetailsEntryType.CoFundingCharge Enum New
AccountDetailsEntryType.CoFundingChargeCredit Enum New

Announcements - 1129

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.

Changes to eBay Collect and Remit Taxes

Beginning in early November, for orders subject to eBay 'Collect and Remit' taxes, PayPal will begin distributing order funds to the seller's account with the sales tax included. However, shortly after the order funds clear in the seller's account, the 'Collect and Remit' tax amount will be pulled by PayPal from the seller's account and then disributed to the appropriate taxing authority. Currently, PayPal is stripping this 'Collect and Remit' tax from the buyer's payment and directly submitting this amount to the appropriate taxing authority, and this tax amount never shows up in the sellers account.

eBay 'Collect and Remit' taxes include US state-mandated sales tax and 'Goods and Services' tax that is applicable to Australian and New Zealand sellers. To accomodate for these changes, the order management calls and the GetAccount call was updated. See the Changed Functionality section for more information about how these API calls are handling this logic change.

This change does not affect sellers that are already opted in to eBay managed payments. For these sellers, the sales tax amount will never be included in a seller payout.

New Features - 1129

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 - 1129.

None for this release.

Changed Functionality - 1129

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 Order Management Calls for eBay Collect and Remit Taxes

Beginning in early November, for orders subject to eBay 'Collect and Remit' taxes, PayPal will begin distributing order funds to the seller's account with the sales tax included. eBay 'Collect and Remit' taxes include US state-mandated sales tax and 'Goods and Services' tax that is applicable to Australian and New Zealand sellers. Due to this change, the following updates were made to GetOrders (and other order management calls):

This change does not affect sellers that are already opted in to eBay managed payments. For these sellers, the sales tax amount will never be included in a seller payout. For sellers that are opted in to eBay managed payments, the 'Collect and Remit' tax will only be shown in the Transaction.eBayCollectAndRemitTaxes container, and not in the Transaction.Taxes. For sellers not opted in to eBay managed payments, both of these containers will appear in the response showing the 'Collect and Remit' tax details.

Update to GetAccount Call for eBay Collect and Remit Taxes

Six new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for the eBay 'Collect and Remit' tax that is distributed to the seller's account by PayPal, and then pulled from the account by PayPal and sent to the appropriate tax authority. The enumeration values include:

See these new values in AccountDetailEntryCodeType for more information.

A new OrderId field was also added to the AccountEntry container of GetAccount to indicate the order associated with the 'Collect and Remit' tax account entry.

GetCategorySpecifics Updated to Return All Available Item Specific Metadata

The GetCategorySpecifics call has been updated to return all available item specific name-value pairs by default. Before this change, 30 item specific names would be returned by default and 25 corresponding values for each returned item specific name. The maximum amount of item specific names that could be returned was 50, and this limitation was also lifted.

The MaxNames and MaxValuesPerName request filters can still be used if the user wishes to limit the number of item specific names and/or values that are returned in the GetCategorySpecifics response. To account for this change, the Max constraints and the Default values were removed from these request filter field descriptions.

Documentation Changes and Errata - 1129

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

None for this release.

Version 1125

Index of Changed Calls - 1125

Schema Changes - 1125

Announcements - 1125

New Features - 1125

Changed Functionality - 1125

Documentation Changes and Errata - 1125

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

Index of Changed Calls - 1125

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 - 1125

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
AccountDetailsEntryType.AdFeePremium Enum New
AccountDetailsEntryType.AdFeePremiumCredit Enum New
AccountDetailsEntryType.CanadaPostLabelFee Enum New
AccountDetailsEntryType.CanadaPostLabelFeeCredit Enum New
AccountDetailsEntryType.PerListingPaymentsFee Enum New
AccountDetailsEntryType.PerListingPaymentsFeeCredit Enum New
AccountDetailsEntryType.SendLabelFee Enum New
AccountDetailsEntryType.SendLabelFeeCredit Enum New
AccountDetailsEntryType.UpsLabelFee Enum New
AccountDetailsEntryType.UpsLabelFeeCredit Enum New
AccountDetailsEntryType.VehiclesListingBasicPackageFee Enum New
AccountDetailsEntryType.VehiclesListingBasicPackageCredit Enum New
AccountDetailsEntryType.VehiclesListingPlusPackageFee Enum New
AccountDetailsEntryType.VehiclesListingPlusPackageCredit Enum New
AccountDetailsEntryType.VehiclesListingPremiumPackageFee Enum New
AccountDetailsEntryType.VehiclesListingPremiumPackageCredit Enum New
SubscriptionLevel.Starter Enum New
SubscriptionLevel.Enterprise Enum New

Announcements - 1125

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 - 1125

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 - 1125.

New eBay Store Subscription Levels

Two new enumeration values, Starter and Enterprise, were added to StoreSubscriptionLevelCodeType to account for the two new eBay Store subscription levels. An eBay user's store subscription level is returned in the GetStore call.

A user must use the 1125 WSDL or set Compatibility Level to '1125' to see these two enumeration values (when applicable) in the GetStore call response.

New Fee/Credit Enum Values Added for GetAccount

16 new enumeration values were added to AccountDetailEntryCodeType to represent the new fees and credits that were added to account for new ad fees, payment fees, vehicle listing fees, and shipping label fees. See the GetAccount Change History section for a full list of the new enum values.

Changed Functionality - 1125

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 - 1125

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

Added Note to all OrderID Fields to Describe Unpaid/Paid Behavior

A note was added to all OrderID fields to call out how OrderID (and ExtendedOrderID) values change as orders go from unpaid to paid (for sellers integrated with the new order ID format). When using a GetOrders or GetOrderTransactions call (or any other call that uses OrderID in request), either of these order IDs (paid or unpaid status) can be used to identify an order.

Added Note About Updating Payload Version of Platform Notifications

Added a note to the Platform Notifications Landing Page (Notification Payloads section) about the requirement For sellers to upload the Payload Version of their Platform Notifications in order to retrieve the new order ID format for order-related Platform Notifications that are returned in the GetItemTransactions response (when triggered/applicable). A SetNotificationPreferences call should be run to update the payload version of Platform Notifications to '1113' or above.

Added Min/Max Values for WeightMinor Field

Added Min/Max value constraints to the WeightMinor field that is used under ShippingPackageDetails container to express the number of ounces or grams for the weight of a package. The weight of the package is necessary when creating listings that use calculated shipping costs. For ounces, the maximum value is '15', and for grams, the maximum value is '999'.

Version 1119

Index of Changed Calls - 1119

Schema Changes - 1119

Announcements - 1119

New Features - 1119

Changed Functionality - 1119

Documentation Changes and Errata - 1119

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

Index of Changed Calls - 1119

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 - 1119

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 - 1119

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 - 1119

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 - 1119.

None for this release.

Changed Functionality - 1119

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.

Flat or Calculated Shipping Requires at Least One Valid Shipping Service Option

If the seller is using Flat or Calculated shipping, at least one actual shipping service option must be specified through a ShippingDetails.ShippingServiceOptions container when using an Add or Revise Item call. In the past, eBay allowed users to set the shipping cost model to 'Flat' or 'Calculated', and then just pass in one ShippingServiceOptions container with the ShippingServiceOptions.ShipppingServicevalue set to a 'Local Pickup' option. Now, sellers must pass in at least one actual domestic shipping service option in addition to any 'Local Pickup' option, or the listing will be blocked with the following error: 17510 - You must specify at least one domestic shipping service, other than or in addition to Local Pickup.

The Featured Gallery Listing Feature is Scheduled for Deprecation

The Feature Gallery listing feature, currently only available for Top-Rated sellers on the Germany site, has been scheduled for deprecation. Below is the deprecation schedule for the feature:

the GalleryDuration in PictureDetailsType has been removed from the Trading WSDL. In an Add/Revise/Relist call, the value of the GalleryType field in the PictureDetails container should no longer be set to Featured. The ListingEnhancementDurationCodeType, only used to set the duration of the Featured Gallery feature, and the Featured enumeration value of GalleryTypeCodeType have also been marked as no longer applicable due to the impending end of this feature.

ShippingSurcharge Field Removed from Trading WSDL

The ShippingSurcharge field in ShippingServiceOptionsType has been removed from the Trading WSDL. For the next 18 months, this field will still be supported if used in a Add/Revise/Relist call, but it is recommended that sellers configure shipping surcharges in Shipping rate tables instead. Shipping rate tables can be added and modified through the Shipping Preferences in My eBay.

Documentation Changes and Errata - 1119

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

SellerInventoryID Field removed from Trading WSDL

The SellerInventoryID field in ItemType has been removed from the Trading WSDL. This field was no longer applicable as soon as the Half.com site was shut down.

Semicolons cannot be used in PictureURL Fields

Semicolons cannot be used in a PictureURL field. Unlike a blank space, a semicolon cannot be "escaped" with %20. If a semicolon is used in a PictureURL field, that picture will not be allowed.

Version 1113

Index of Changed Calls - 1113

Schema Changes - 1113

Announcements - 1113

New Features - 1113

Changed Functionality - 1113

Documentation Changes and Errata - 1113

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

Index of Changed Calls - 1113

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 - 1113

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 - 1113

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 Format for Order Identifiers Rolled Out

The new format for eBay orders has been implemented. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. This new format will now appear in the order details section of the View Order Details page, in Seller Hub, in reports, and in email correspondence. Both the old format and the new order ID format will be supported in all API calls. See the Changed Functionality section for current details on how order IDs will work with Trading API calls.

New Features - 1113

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 - 1113.

None for this release.

Changed Functionality - 1113

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.

Using Old or New Order ID Format in API calls.

The new format for eBay orders has been implemented, and this new format will now appear in the order details section of the View Order Details page, in Seller Hub, in reports, and in email correspondence.

Whether the old or new format for Order IDs is returned in OrderID fields in Trading API call responses is determined by the WSDL version being used and on the X-EBAY-API-COMPATIBILITY-LEVEL request header value. See below for more details on version control:

Regardless of the WSDL version number or the X-EBAY-API-COMPATIBILITY-LEVEL, both old and new order ID formats can be used to identify an order in all Trading API call requests. These calls include the following:

eBay will support the old identifier format in APIs until at least Q1 2020, but it is a good idea that developers integrate with the new format as soon as possible just for ease of management of orders, as only the new order ID format will be showing up elsewhere - Order Details, Seller Hub, email correspondence, etc.

If a user is using Version 1113 (or using an older version with the X-EBAY-API-COMPATIBILITY-LEVEL value set to '1113', the new order ID format will be seen in the OrderID field for the following call responses:

For the ExtendedOrderID field (returned in all order management calls), the new order ID format will be returned, regardless of the WSDL version number or compatibility level. The ExtendedOrderID was previously created to distinguish between legacy and REST API-based order identifiers. Now, with the rollout of the new order ID format, the same order identifiers will be used for both legacy and REST-based APIs, although the legacy APIs will support both the old and the new formats until 2020.

Transient Behavior of New Order IDs

For sellers integrated with the new order ID format, please note that the identifier for an order will change as it goes from unpaid to paid status. However, when using a GetOrders or GetOrderTransactions call to retrieve specific order(s), either of these order IDs (paid or unpaid status) can be used to retrieve an order. Sellers can also check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment.

Once you integrate with the new order ID format, it is possible that you will retrieve an order that you had already acknowledged and fulfilled, but you may not recognize that order because the order ID value has changed. To help avoid this scenario and shipping the same order twice, you can consider taking the following approaches:

Notes on Version Control for Order-Related Platform Notifications

For sellers that are subscribed to order-related Platform Notifications that are returned in the GetItemTransactions response (when triggered/applicable), and also integrated with the new order ID format, a SetNotificationPreferences call should be run to upload the payload version of Platform Notifications to '1113' or above. This is necessary so that the order ID values that are returned in the GetItemTransactions response and the order ID values that are returned in the XML SOAP messages sent to servers and/or email addresses are in synch with one another. To update the payload version of Platform Notifications using the SetNotificationPreferences call, the user would just pass in the ApplicationDeliveryPreferences.PayloadVersion field and set its value to '1113' or above, as demonstrated below:

<ApplicationDeliveryPreferences> 
 <PayloadVersion>1113</PayloadVersion> 
</ApplicationDeliveryPreferences>

Platform Notifications can be configured to be sent to servers and/or email addresses by using the ApplicationDeliveryPreferences container in a SetNotificationPreferences call. Order-related Plaform Notifications include the following:

Notes on Version Contol for OrderLineItemCount Field.

The OrderLineItemCount field, introduced with Version 1107, is used to indicate the total number of line items in an order. Similar to the order ID format change, the OrderLineItemCount field was released with version/compatibility control. This field will be returned under the ContainingOrder container of the GetItemTransactions or GetSellerTransactions calls if the following is true:

Documentation Changes and Errata - 1113

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

Max Length Added for OrderID and ExtendedOrderID Fields

The maximum length has been published for all occurrences of OrderID and ExtendedOrderID fields. The maximum length is 40 characters. Previously, the maximum length value was not stated in the API documentation. This maximum length value applies to both the old and the new order ID format.

Version 1111

Index of Changed Calls - 1111

Schema Changes - 1111

Announcements - 1111

New Features - 1111

Changed Functionality - 1111

Documentation Changes and Errata - 1111

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

Index of Changed Calls - 1111

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 - 1111

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
UsageConstraintCodeType Type New
ValidationRules.UsageConstraint Field New

Announcements - 1111

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 - 1111

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 - 1111.

New GetCategorySpecifics Field Added to Indicate Importance of Item Specific

The NameRecommendation.ValidationRules.UsageConstraint field was added to the GetCategorySpecifics response to indicate whether the item specific is required, recommended, or optional. Previously, returned item specifics were only 'marked' as required or optional. With the introduction of this new field, eBay is able to specify to sellers which item specifics are highly recommended, although not required. The item specifics that are recommended can possibly improve search results and/or sales conversion.

Changed Functionality - 1111

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 - 1111

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

None for this release.

Version 1107

Index of Changed Calls - 1107

Schema Changes - 1107

Announcements - 1107

New Features - 1107

Changed Functionality - 1107

Documentation Changes and Errata - 1107

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

Index of Changed Calls - 1107

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 - 1107

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
OrderType.OrderLineItemCount Field New

Announcements - 1107

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 - 1107

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 - 1107.

New OrderLineItemCount Field Added to GetSellerTransactions/GetItemTransactions

New OrderLineItemCount field added to OrderType. This field will indicate the total number of line items in an order. This field will be returned under the ContainingOrder container of the GetItemTransactions or GetSellerTransactions calls. In order for the ContainingOrder container to be returned, a user must include the IncludeContainingOrder field in the call request and set its value to true.

This field has yet to be wired on, so will not be currently returned in any circumstance. However, once this field is wired on, the user must be using Version 1107 of the Trading WSDL (or newer, as versions roll out), and the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value must be set to '1113' in order to see this field in the response.

Changed Functionality - 1107

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.

Format Change Coming to Order IDs

Starting in June 2019, eBay will start changing the format of order identifier values. The new format will be a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. These order identifiers will be automatically generated after buyer payment, and unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support.

For developers and sellers who are already integrated with the Trading API's order management calls, this change shouldn't impact your integration unless you parse the existing order identifiers (e.g., OrderID or OrderLineItemID), or otherwise infer meaning from the format (e.g., differentiating between a single line item order versus a multiple line item order). Because we realize that some integrations may have logic that is dependent upon the identifier format, eBay is rolling out this Trading API change with version control to support a transition period of approximately 9 months before applications must switch to the new format completely.

During the transition period, developers/sellers will use the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header in API calls to control whether the new or old OrderID format is returned in all Trading API call response payloads. The compatibility version is expected to be Version 1113. During the transition period and even after, the new and old OrderID formats will still be supported in all Trading API call request payloads. After the transition period (which will be announced), only the new OrderID format will be returned in all Trading API call response payloads, regardless of the Trading WSDL version used or specified compatibility level.

You can read more about this change in the Spring 2019 Seller Updates.

Change to 'GTC' Automatic Renewal Schedule

Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). You can read more about this change in the Spring 2019 Seller Updates.

Documentation Changes and Errata - 1107

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

Corrected the Occurrence Value of CityName Field

The occurrence value of the CityName field of AddressType was incorrectly stated as 'Always' being returned. This was not correct, and the occurrence value was changed to 'Conditionally' returned instead. Although most addresses include a city name, some do not. For example, Singapore is an island city-state, and the CityName field would not be applicable to any address in Singapore.

Added Note About Buyer's Email Address Being Masked After Two Weeks

For the GetOrders call, the buyer's email address will be returned (to the seller only) for orders less than two weeks old, but for orders that occurred more than two weeks in the past, the buyer's email address will no longer be returned. The Buyer.Email field will still be returned, but 'dummy data', such as Invalid Request will replace the actual email address.

Version 1101

Index of Changed Calls - 1101

Schema Changes - 1101

Announcements - 1101

New Features - 1101

Changed Functionality - 1101

Documentation Changes and Errata - 1101

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

Index of Changed Calls - 1101

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 - 1101

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.HighlineSearchFee Enum New
AccountDetailEntryCodeType.HighlineSearchFeeCredit Enum New
AccountDetailEntryCodeType.SnadOutlierFinalValueFee Enum New
AccountDetailEntryCodeType.SnadOutlierFinalValueFeeCredit Enum New
AccountDetailEntryCodeType.SnadOutlierFinalValueFeeOnShipping Enum New
AccountDetailEntryCodeType.SnadOutlierFinalValueFeeOnShippingCredit Enum New

Announcements - 1101

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.

Product-Based Shopping Experience Mandate Rolled Back

Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories (and brands within those categories), sellers will no longer be required to associate an eBay catalog product to the listing in any categories. Although the mandate has been rolled back, it can still be very useful to sellers (and buyers searching for their items) if a listing is associated with an eBay catalog product, if one is available for their product. Sellers can use the the search operation in the Catalog API or the FindProducts call in the Shopping API to search for matching eBay catalog products. If a matching product is found, the seller will need the catalog product's eBay Product Identifier (ePID) value when they list their item. The ePID value will be passed in to the ProductListingDetails.ProductReferenceID when using the AddItem call.

Due to this rollback, sellers will no longer need to use GetCategoryFeatures to see if a listing category requires association with an eBay catalog product, nor will they need to use GetCategorySpecifics to see if a product brand within a listing category requires association with an eBay catalog product.

New Features - 1101

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 - 1101.

Three New Charges and Three New Credits Added to GetAccount

Six new enumeration values were added to AccountDetailEntryCodeType to account for the three new charges (and three corresponding credits). These three sets of charges/credits are summarized below:

Changed Functionality - 1101

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.

'CreditCard' Enum Value Returned for eBay Managed Payments Orders

For sellers opted in to the eBay Managed Payments program, the enumeration value returned in the Transaction.Status.PaymentMethodUsed field will be CreditCard, regardless of the actual payment method used by the buyer to pay for the order.

Similarly, if a seller wants/needs to pass a payment method in when using the AddOrder or SendInvoice calls, a seller opted in to eBay Managed Payments should only pass a value of CreditCard into the Order.PaymentMethods and PaymentMethods fields, respectively.

eBay Managed Payments is currently only available to a limited number of sellers on the US site. For sellers in the eBay Managed Payments program, a payment method does not need to be specified at listing/checkout time.

Last Two Digits of ABN Returned for Orders Subject to GST

For orders subject to Australian 'Goods and Services' tax (GST), in addition to the unique identifier for a user's address, the AddressID field returned for a shipping address will also contain the last two digits of the user's Australian Business Number (ABN), if applicable. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site.

Catalog Change Request URLs No Longer Returned in GeteBayDetails

The three catalog change request URLs (CreateProductUrl, AppealProductUrl, or ManageProductUrl) will no longer be returned in the URLDetails.URLType field of GeteBayDetails since catalog change requests through the UI flow are currently not available.

Documentation Changes and Errata - 1101

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

Documentation Updated to Account for Managed Payments and PBSE Rollback

Numerous documentation updates and notes were made in type documentation to account for recent changes related to eBay Managed Payments and the rollback of the Product-Based Shopping Experience mandate.

Version 1099

Index of Changed Calls - 1099

Schema Changes - 1099

Announcements - 1099

New Features - 1099

Changed Functionality - 1099

Documentation Changes and Errata - 1099

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

Index of Changed Calls - 1099

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 - 1099

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 - 1099

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 Fixed-Priced Listings to Become Good 'Til Cancelled

Beginning on March 18, 2019 on North American (US and Canada) and all Asian eBay sites, and followed shortly after (around April 1) on all European sites, the only supported listing duration for all new fixed-price listings will be Good 'Til Cancelled (GTC). Existing fixed-price listings with non-GTC durations will not be affected until it becomes time for the seller to relist that item, in which case the seller will have to relist it with the GTC listing duration.

As soon as this change rolls out, only the GTC enumeration value will be accepted in the Item.ListingDuration field of an Add/Revise/Relist/Verify listing call. Any other value that is passed into this field will be ignored, and the listing duration will be set to GTC automatically. The metadata in the GetCategoryFeatures call response will be updated to reflect this change. When using GetCategoryFeatures to retrieve supported listing durations for different listing types and categories for a particular eBay site, the seller includes the FeatureID field in the response and sets its value to ListingDurations.

IMCC Payments Will No Longer Be Accepted

Beginning May 1, 2019, eBay will no longer support electronic payments through a seller's Integrated Merchant Credit Card account. To accept online credit card payments from buyers, a seller must either specify PayPal as an accepted payment method, or opt in to the eBay Managed Payments program (currently only available to sellers in US).

Once this change takes affect, if IMCC is passed in as a value in an Item.PaymentMethods field of an Add/Revise/Relist call, this value will be ignored and dropped (and listing will possibly get blocked if IMCC is the only specified payment method). Once a seller is opted in to eBay Managed Payments, no Item.PaymentMethods values will need to be specified as eBay controls the accepted payment methods for each marketplace.

New Features - 1099

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 - 1099.

None for this release.

Changed Functionality - 1099

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.

Maximum Number of Item Specifics Increased

The maximum number of item specifics that may be defined for a listing has increased from 30 to 45. In Add/Revise/Relist calls, item specific name-value pairs are specified through the ItemSpecifics.NameValueList container.

Documentation Changes and Errata - 1099

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

Numerous Doc Improvements

Numerous documentation improvements were made for this release.

Version 1095

Index of Changed Calls - 1095

Schema Changes - 1095

Announcements - 1095

New Features - 1095

Changed Functionality - 1095

Documentation Changes and Errata - 1095

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

Index of Changed Calls - 1095

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 - 1095

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 - 1095

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 Fixed-Priced Listings to Become Good 'Til Cancelled

Starting in mid-March 2019 on North American (US and Canada) and all Asian eBay sites, and followed shortly after (around April 1) on all European sites, the only supported listing duration for all new fixed-price listings will be Good 'Til Cancelled (GTC). Existing fixed-price listings with non-GTC durations will not be affected until it becomes time for the seller to relist that item, in which case the seller will have to relist it with the GTC listing duration.

GTC listings renew automatically every 30 days as long as the listing is showing quantity available (1 or more), an insertion fee may be charged for each 30-day period in which the listing is renewed. With GTC listings, it may also be a good idea to take advantage of the out-of-stock feature. With the out-of-stock feature, your fixed-price listing will retain its purchase and search history, but will display to potential buyers as being 'out of stock' if the quantity reaches 0. Then, the seller will just have to revise their listing with more inventory to make purchases possible again. The out-of-stock feature is set in My eBay Selling Preferences.

As soon as this change rolls out, only the GTC enumeration value will be accepted in the Item.ListingDuration field of an Add/Revise/Relist/Verify listing call. Any other value that is passed into this field will be ignored, and the listing duration will be set to GTC automatically. The metadata in the GetCategoryFeatures call response will be updated to reflect this change. When using GetCategoryFeatures to retrieve supported listing durations for different listing types and categories for a particular eBay site, the seller includes the FeatureID field in the response and sets its value to ListingDurations.

IMCC Payments Will No Longer Be Accepted

Beginning May 1, 2019, eBay will no longer support electronic payments through a seller's Integrated Merchant Credit Card account. To accept online credit card payments from buyers, a seller must either specify PayPal as an accepted payment method, or opt in to the eBay Managed Payments program (currently only available to sellers in US).

Once this change takes affect, if IMCC is passed in as a value in an Item.PaymentMethods field of an Add/Revise/Relist call, this value will be ignored and dropped (and listing will possibly get blocked if IMCC is the only specified payment method). Once a seller is opted in to eBay Managed Payments, no Item.PaymentMethods values will need to be specified as eBay controls the accepted payment methods for each marketplace.

2019 Early Seller Update Now Available

The 2019 Early Seller Update is now available. Seller updates generally affect all or most sellers, but generally aren't specific to sellers and developers using the public APIs. This update covers the following topics:

New Features - 1095

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 - 1095.

None for this release.

Changed Functionality - 1095

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.

Only 'GTC' Supported for Fixed-Priced Listings in Australia

The only supported listing duration for all new fixed-price listings on the eBay Australia site is Good 'Til Cancelled (GTC). Existing fixed-price listings with non-GTC durations will not be affected until it becomes time for the seller to relist that item, in which case the seller will have to relist it with the GTC listing duration.

With this change, only the GTC enumeration value will be accepted in the Item.ListingDuration field of an Add/Revise/Relist/Verify listing call. Any other value that is passed into this field will be ignored, and the listing duration will be set to GTC automatically. The metadata in the GetCategoryFeatures call response has been updated to reflect this change to fixed-price listings.

Documentation Changes and Errata - 1095

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

Added Note About 500 Pixels Requirement for Listing Photos

Added a note in the PictureDetails.PictureURL field about the 500 pixels requirement for all listing photos. With this requirement, all photos being added to a listing must be at least 500 pixels on its longest side. Any photos that do not meet this requirement will not be published to the listing.

Version 1091

Index of Changed Calls - 1091

Schema Changes - 1091

Announcements - 1091

New Features - 1091

Changed Functionality - 1091

Documentation Changes and Errata - 1091

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

Index of Changed Calls - 1091

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 - 1091

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
Item.MotorsGermanySearchable Field Deprecated
Item.ShippingTermsInDescription Field Deprecated
Seller.MotorsDealer Field Deprecated
SellerContactDetails.Phone2CountryCode Field Deprecated
SellerContactDetails.Phone2CountryPrefix Field Deprecated
SellerContactDetails.Phone2AreaOrCityCode Field Deprecated
SellerContactDetails.Phone2LocalNumber Field Deprecated

Announcements - 1091

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 - 1091

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 - 1091.

Best Offer Feature Enabled for Auction Listings on More Sites

Previously, beginning with Version 1027, sellers on the US, UK, and DE sites gained the capability to accept Best Offers on auction listings. This capability is now also available to sellers on Canada sites (English and French), and to the eBay marketplaces in Australia, France, Italy, and Spain.

Sellers using auctions must choose between using the Best Offer or Buy It Now feature, as both features cannot be enabled on the same auction listing. If an auction listing is enabled with Best Offer, this feature will no longer be applicable once the listing receives its first qualifying bid.

Changed Functionality - 1091

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.

Change to Minimum Best Offer Price Threshold in Auction Listings

Sellers accepting Best Offers for an auction listing can now set the Best Offer Auto Reject threshold price (Item.ListingDetails.MinimumBestOfferPrice) to a dollar value higher than the auction starting price (Item.StartPrice).

Best Offers in auction listings are available to sellers on the US, Canada, UK, Germany, Australia, France, Italy, and Spain sites. Note that the Best Offer feature in auction listings is no longer applicable once the listing receives its first qualifying bid.

New Category Mapping Now Done by Default

Previously, sellers using the Add/Revise/Relist calls had to include the CategoryMappingAllowed field and set its value to true. Now, eBay will do category mapping automatically (CategoryMappingAllowed field defaults to true instead of false, so sellers can now just omit the CategoryMappingAllowed field in an Add/Revise/Relist call.

With category mapping, eBay will automatically 'map' or 're-route' and outdated/deprecated Category ID to the updated/correct Category ID. The primary Category ID is specified in Add/Revise/Relist calls in the PrimaryCategory.CategoryID field, and the secondary listing category (if used) is specified in Add/Revise/Relist calls in the SecondaryCategory.CategoryID field. And if eBay does category mapping, the new Category IDs will appear in the response of a successful Add/Revise/Relist call.

Secondary Phone Numbers No Longer Supported in Classified Ad Listings

The following fields under the SellerContactDetails container in an Add/Revise/Relist call have been deprecated since adding a secondary contact number is no longer supported for Classified Ad listings. If any of these fields are included in an Add/Revise/Relist call, they will be ignored:

Two eBay Motors-related Fields Deprecated

The following two eBay Motors-related fields were deprecated. Previously, both of these boolean fields were set through an Add/Revise/Relist call.

ShippingTermsInDescription Field Deprecated

The Item.ShippingTermsInDescription field used in Add/Revise/Relist calls is deprecated. If this field is included in an Add/Revise/Relist call, it will be ignored.

Documentation Changes and Errata - 1091

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

None for this release.

Copyright © 2005–2019 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.