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. For older release notes, see the Release Notes Archive.

Version 1421

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1421

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

• GetItemTransactions
• GetNotificationPreferences
• GetNotificationsUsage
• GetOrders
• SetNotificationPreferences

Schema Changes - 1421

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.

Announcements - 1421

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1421

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

New MotorPurchase container added to TransactionProgramType

A new container, MotorPurchase, has been added to TransactionProgramType and will be returned by GetOrders and GetItemTransactions as applicable. This container provides details on a motor vehicle that is being ordered using Secure Purchase.

Changed Functionality - 1421

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.

Support for easy returns in P&A listings added

To facilitate easy returns on the eBay-US site exclusively, sellers of eligible Parts & Accessories (P&A) listings are required to offer buyers a minimum of 30-day free returns. Initially, starting July 15, 2025, eBay will automatically update return policy settings as applicable and return a warning. Beginning in late August, 2025, listing creation and revision will be blocked with error 2190443 returned. Eligible listings must meet specific criteria. For more information, visit the applicable Seller Center help page. Also see Support for easy returns in Parts and Accessories.

To support the new functionality, the following error message and warning have been added in this release.

• (error) 21920443: This P&A listing has a non-compliant domestic return policy. Please update the return window to 30-days (or more) and/or update return shipping cost payer to Seller, and then make another call. Sellers using business policies must make the same changes to their return business policy and then make another call. To learn more, visit https://www.ebay.com/sellercenter/news/2025-june/parts-accessories-return-policy.
• (warning) 21920444: This P&A listing requires a minimum 30-day return period and seller-paid return shipping. eBay automatically updated the listing's return policy settings to meet these requirements. Sellers using business policies should update their return business policy for future P&A listings. To learn more, visit https://www.ebay.com/sellercenter/news/2025-june/parts-accessories-return-policy.

Item fulfillment location information now returned

Item fulfillment location information can now be returned in the Location field of the GetOrders, GetItemTransactions, and GetSellerTransactions calls if applicable. If the item is shipped from a fulfillment center location through the Multi-Warehouse Program, this field will return the location details (including the country and zip code) of the fulfillment center closest to the buyer.

Removed decommissioned enumerated values from NotificationEventTypeCodeType

The following notification event enumerated values were decommissioned: AccountSuspended, BuyerNoShow, AccountSummary, AccountSuspended, EBNOrderCanceled, EBNOrderPickedUp, EmailAddressChanged, None, PasswordChanged, PasswordHintChanged, PaymentDetailChanged, and WebnextMobilePhotoSync. These values are no longer available for the GetNotificationPreferences, GetNotificationsUsage, and SetNotificationPreferences calls.

Documentation Changes and Errata - 1421

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

None for this release.

Version 1415

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1415

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

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.

Announcements - 1415

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1415

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

None for this release.

Changed Functionality - 1415

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 Message Added in Version 1415

To support EPS URL links now being required to use HTTPS (HyperText Transfer Protocol Secure) for Revise calls, the following error message has been added in this release. It is returned in ReviseFixedPriceItem and ReviseItem calls when attempting to add images using HTTP resources, specifically for the EBAY-US site only.

Note: For ReviseItem/ReviseFixedPriceItem calls, error code 21920412 is no longer returned and has been replaced by 21919490.

• (Error Code: 21919490): eBay security policy only allows HTTPS resources in listings, not HTTP. Please update or remove any HTTP resources.

GetCategoryMappings Call Decommissioned

The GetCategoryMappings call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by getCategoryMappings have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1413

DescriptionReviseMode field use change

The DescriptionReviseMode field, used by the ReviseItem and ReviseFixedPriceItem calls, should no longer be used since it no longer supports the ability to append or prepend text using the Append or Prepend values, but only supports the Replace value. If this field is used and set to Append or Prepend, it will default to Replace, and whatever text is supplied in the Item.Description field will completely overwrite the current description for the active listing. If you wish to update the description for an active listing using a revise call, just provide the full description in the Item.Description field and do not use this field at all. This field will be completely removed from the WSDL within a few months.

Documentation Changes and Errata - 1415

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

None for this release.

Version 1399

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1399

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

• CompleteSale

Schema Changes - 1399

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.

Announcements - 1399

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1399

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

None for this release.

Changed Functionality - 1399

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.

Launch of Buyer Protection for private seller purchases on ebay.co.uk

Going forward, buyers on UK marketplace will be charged a buyer protection fee. These fees will be reflected in the calls as noted in the applicable fields. For UK-based private sellers (excluding Vehicles, Classified Ads, and Property), a Buyer Protection fee will be added to their listings. This fee will be paid for by the buyer. See Changed Calls - 1399 for calls which have fields affected.

Added error message for 1399

In order to support the new functionality of Buyer Protection, the following error message has been added in this release and is returned in CompleteSale:

• (error) 21920438: Invalid request: one of the items cannot be marked as paid.

GeteBayOfficialTime Call Decommissioned

The GeteBayOfficialTime call has been decommissioned decommissioned as of January 27, 2025, and the call reference documentation has been removed. Additionally, all types exclusively used by GeteBayOfficialTime have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1399

ValidateTestUserRegistration Call Decommissioned

The ValidateTestUserRegistration call has been decommissioned as of January 30, 2025, and the call reference documentation has been removed. Additionally, all types exclusively used by ValidateTestUserRegistration have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1399

Challenge Calls Decommissioned

• GetChallengeToken
• ValidateChallengeInput

Additionally, all types exclusively used by either call have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1399

Documentation Changes and Errata - 1399

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

None for this release.

Version 1395

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1395

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

• AddFixedPriceItem
• AddItem
• AddItems
• GetItem
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyRelistItem

Schema Changes - 1395

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.

Announcements - 1395

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1395

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

New ContactURL field added to ManufacturerType and ResponsiblePersonType

A new field, ContactURL, has been added to ManufacturerType and ResponsiblePersonType. This field allows users to input a manufacturer's and/or a Responsible Person's contact URL as an electronic contact method when inputting GPSR information for a listing.

The following error message has rolled out with the 1395 release. The long version of the message is used below:

• (error) 21920435: The contact URL is incorrectly formatted. Please update the formatting.

Changed Functionality - 1395

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.

Two new pre-owned item conditions available for apparel categories in Australia

As of January 22, the following two Pre-owned item conditions are now supported for 222 apparel categories in Australia:

• ConditionID 2990 for Pre-owned - Excellent
• ConditionID 3010 for Pre-owned - Fair

For the affected categories, the condition name for ConditionID 3000 has been changed from Pre-owned to Pre-owned - Good. The item condition names for all active listings with ConditionID 3000 will automatically be updated from Pre-owned to Pre-owned - Good. However, we strongly encourage you to revise your existing listings with Pre-owned Excellent (2990) or Pre-owned Fair (3010) if either of those conditions more accurately describe the condition of your item.

See the Q4 2024 Newsletter for more information on the affected categories, or you can also use getItemConditionPolicies or GetCategoryFeatures to see which apparel categories support the new item conditions.

These same changes are expected to roll out to all eBay marketplaces in early February, and we will update release notes when that happens.

Updated error messages for 1395

In order to support the new ContactURL field, the following error messages have been updated with the 1395 release. The long version of each message is used below:

• (error) 21920432: Seller must provide at least one form of contact info for Manufacturer - address, email, contact URL or phone.
• (error) 21920433: Seller must provide at least one form of contact info for Responsible Person - address, email, contact URL or phone.

Documentation Changes and Errata - 1395

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

None for this release.

Version 1391

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1391

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

• GetItemTransactions
• GetOrders
• GetSellerTransactions

Schema Changes - 1391

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.

Announcements - 1391

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1391

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

None for this release.

Changed Functionality - 1391

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 enumerated values added to ValueTypeCodeType

Three new enumerated values were added to ValueTypeCodeType to support Mexican and Chilean Tax IDs. See Schema Changes - 1391 for specifics.

Updated restrictions for P&A tuners category listings

When creating a listing in the Auto Performance Tuning Devices & Software category, sellers must use an eBay catalog product. Previously, if a seller added any additional product details, like additional item specifics, the listing would be blocked and an error would occur. With this release, if a seller provides any additional product information, that information will now just be dropped, and a warning will be returned.

To support this, the following error message has been added in the 1391 release. The long version of the message is used:

• (warning) 21920437: When listing in replaceable_value, all product details come from eBay catalog. Any product information provided by the seller will be dropped.

Documentation Changes and Errata - 1391

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

None for this release.

Version 1379

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1379

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

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.

Announcements - 1379

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1379

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

None for this release.

Changed Functionality - 1379

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.

GetClientAlertsAuthToken Call Decommissioned

The GetClientAlertsAuthToken call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetClientAlertsAuthToken have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1379

Documentation Changes and Errata - 1379

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

None for this release.

Version 1375

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1375

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

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.

Announcements - 1375

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1375

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

None for this release.

Changed Functionality - 1375

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.

DeletedFromUnsoldList and DeletedFromSoldList containers decommissioned

SummarySchedule and SMSSubscription containers decommissioned

Removed non-working UserIDChanged enumerated value from NotificationEventTypeCodeType

Documentation Changes and Errata - 1375

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

None for this release.

Version 1371

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1371

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

• AddFixedPriceItem
• AddItem
• AddItems
• GetItem
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyRelistItem

Schema Changes - 1371

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.

Announcements - 1371

Economic Operator is being decommissioned and should no longer be used for the Add/Revise/Relist and VerifyItem family of calls. As it is currently still supported, Economic Operator-related fields will be returned if applicable for the GetItem call.

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1371

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

New schema added to support GPSR information

In preparation for new legal requirements by the European Union taking effect on December 13th 2024, schema changes have been made to support GPSR related fields. The Documents, Manufacturer, ProductSafety, and ResponsiblePersons containers provide GPSR information for products shipped or sold in the EU and Northern Ireland.

The following new error messages related to using GPSR information were added in the 1371 release. The long version of each message is used below.

• (error) 21920418: Regulatory document ID(s) replaceable_value not found. Please use valid ID(s).
• (error) 21920419: Duplicate regulatory document ID(s) replaceable_value sent in the request. Duplicate ID(s) have been ignored.
• (error) 21920420: Regulatory document structure incorrect. Max allowed number of entries is replaceable_value.
• (error) 21920421: Invalid document state for ID(s) replaceable_value. Documents must be in the SUBMITTED or ACCEPTED state.
• (error) 21920422: Product Safety structure incorrect for replaceable_value. Max allowed number of entries is replaceable_value.
• (error) 21920423: Product Safety information incomplete. Your listing must include product safety pictograms & statements.
• (error) 21920424: Manufacturer address information is incomplete. When providing the address, please provide the street, city, postal code and country
• (error) 21920425: Manufacturer information is incomplete. Please provide the company name.
• (error) 21920426: Responsible Person structure incorrect for replaceable_value. Max allowed number of entries is replaceable_value.
• (error) 21920427: Responsible Person address information is incomplete. When providing the address, please provide the street, city, postal code and country
• (error) 21920428: Responsible Person information is incomplete. Please provide the company name.
• (error) 21920429: Either the Manufacturer or at least one of the Responsible Persons must be located in the EU.
• (error) 21920430: Please provide a minimum of replaceable_value and a maximum of replaceable_value types for a Responsible Person.
• (error) 21920431: Seller must provide at least one form of contact info for Economic Operator - either phone, email or address.
• (error) 21920432: Seller must provide at least one form of contact info for Manufacturer - either phone, email or address.
• (error) 21920433: Seller must provide at least one form of contact info for Responsible Person - either phone, email or address.

These error messages can be viewed in the Errors by Number page.

Changed Functionality - 1371

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

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

None for this release.

Version 1367

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1367

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

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.

Announcements - 1367

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1367

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

None for this release.

Changed Functionality - 1367

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.

GetSuggestedCategories Call Decommissioned

The GetSuggestedCategories call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetSuggestedCategories have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1367

Documentation Changes and Errata - 1367

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

None for this release.

Version 1363

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1363

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

None for this release.

Announcements - 1363

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1363

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

New requirement when adding EPA approved products

A new requirement adding support for EPA approved tuning devices and software products was added to category Id 173651 (Auto Performance Tuning Devices & Software). See New error messages for 1363 for updated errors. Note: When listing in categoryID 173651 (Tuning devices & software), use of catalog products is required. For more information, see Tuning devices and software.

Changed Functionality - 1363

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 messages for 1363

Below is a list of new or changed error and warning messages that rolled out with the 1363 release and are related to specific parts and accessory categories. The long version of each message is used below:

• (error) 21920416: When listing in replaceable_value, key information such as replaceable_value comes from eBay's catalog and should be left blank.
• (error) 21920417: When listing in replaceable_value, sellers are required to adopt eBay's catalog data which will provide all the necessary details for the product.

These error messages can be viewed in the Errors by Number page.

Documentation Changes and Errata - 1363

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

None for this release.

Version 1359

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1359

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

None for this release.

Announcements - 1359

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1359

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

None for this release.

Changed Functionality - 1359

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 messages for 1359

Below is a list of new or changed error and warning messages that rolled out with the 1359 release. The long version of each message is used below:

• (warning) 21919456: (changed severity and message text) Seller has opted into business policies. Please use policy IDs rather than legacy fields for Shipping, Payments or Returns or new policies may be automatically created seller's behalf.
• (error) 21920409: A minimum of replaceable_value photos is required to list in category replaceable_value.
• (warning) 21920410: The selected shipping service replaceable_value is not supported with the selected shipping package type. The shipping service has been dropped from the listing.
• (warning) 21920411: The field replaceable_value is deprecated and will be decommissioned as of replaceable_value and will no longer be recognized or accepted.
• (warning) 21920412: eBay Picture Service (EPS) URL links are now required to be HTTPS links. HTTP links are converted to HTTPS links right now. Starting August 2024, HTTP EPS links will not be supported.
• (error) 21920413: The category chosen is not valid for this auto related item. Please choose another category.
• (error) 21920414: Seller is not eligible for Managed Shipping. Please opt out of Managed Shipping.
• (error) 21920415: The package dimensions required for calculated shipping are missing. Provide valid numbers for the dimensions.

These error messages can be viewed in the Errors by Number page.

Documentation Changes and Errata - 1359

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

None for this release.

Version 1357

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1357

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

• GetAccount

Schema Changes - 1357

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.

Announcements - 1357

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1357

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

None for this release.

Changed Functionality - 1357

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 Fee and Credit enumerated values added to GetAccount

Four enumerated values were added. See Schema Changes - 1357 for specifics.

Documentation Changes and Errata - 1357

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

None for this release.

Version 1355

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1355

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

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.

Announcements - 1355

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1355

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

None for this release.

Changed Functionality - 1355

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.

GetSellerDashboard Call Decommissioned

The GetSellerDashboard call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetSellerDashboard have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1355. The alternative for this API is Seller Standards Profile methods of the Sell Analytics API.

Documentation Changes and Errata - 1355

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

None for this release.

Version 1349

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1349

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

• AddFixedPriceItem
• AddItem
• AddItems
• GetItem
• GetItemShipping
• GetItemTransactions
• GetOrders
• GetSellerList
• GetSellerTransactions
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1349

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.

Announcements - 1349

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1349

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

None for this release.

Changed Functionality - 1349

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.

TicketListingDetails and QuantityInfo containers decommissioned in Add/Revise/Relist/Verify calls

The TicketListingDetails and QuantityInfo containers and their associated fields in Add/Revise/Relist/Verify and related calls have been decommissioned and removed from the WSDL.

UpdateReturnPolicy and UpdateSellerInfo decommissioned in ReviseItem call

The UpdateReturnPolicy and UpdateSellerInfofields fields in the ReviseItem call have been decommissioned and removed from the WSDL.

OriginatingPostalCode field decommissioned

The OriginatingPostalCode field, used by the Add/Revise/Relist/Verify and GetItem family, has been decommissioned and removed from the WSDL.

Documentation Changes and Errata - 1349

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

None for this release.

Version 1345

For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.

Index of Changed Calls - 1345

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

• AddFixedPriceItem
• AddItem
• AddItems
• GetItem
• GetMyeBaySelling
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

• GetOrders *
• GetSellerTransactions *
• GetItemTransactions *
• GetOrderTransactions (decommissioned)

* See Schema Changes - 1345 for numerous fields removed from response payloads.

Schema Changes - 1345

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.

Announcements - 1345

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

New Features - 1345

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

New schema added to support Economic Operator information

To support new legal requirements by the European Union and the UK to provide Economic Operator information, schema changes have been made. The EconomicOperator container (EconomicOperatorType) provides required Economic Operator information about the manufacturer and/or supplier of the item. The EconomicOperator field has also been added to Regulatorytype.

The following new error messages related to using Economic Operator information were added in the 1345 release. The long version of each message is used below.

• (Error) 21920388: Economic Operator address information is incomplete. When providing the address, please provide the company name, street, city, postal code and country.
• (Error) 21920399: Economic Operator information is incomplete. Please provide the company name.
• (Error) 21920403: The email address provided is formatted incorrectly.

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

Changed Functionality - 1345

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.

GetOrderTransactions Call Decommissioned

The GetOrderTransactions call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetOrderTransactions have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1345

Numerous Order-related Fields Decommissioned

Removed numerous order-related fields in the GetOrders, GetSellerTransactions, GetItemTransactions, and GetMyeBaySelling calls. See the Deprecated Trading Order Management Fields document for a complete list of these fields and reasons.

Documentation Changes and Errata - 1345

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

None for this release.