Traditional Order Management APIs Release Notes

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

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

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

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

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

None for this release.

Changed Functionality - 1475

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.

GetCategoryFeatures call decommissioned

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

Documentation Changes and Errata - 1475

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

None for this release.

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

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

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

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

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

None for this release.

Changed Functionality - 1455

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.

FinalDestinationAddress field added

A new optional FinalDestinationAddress field has been added to MultiLegShippingDetailsType for multi-leg shipping orders. This field may be returned in applicable calls for multi-leg shipments. When returned, it can include CityName, StateOrProvince, Country, PostalCode, and street name.

For GetItemTransactions and GetOrders calls, this functionality was released on 2026-06-01. For GetSellerTransactions calls, it was released on 2026-06-24.

Note: The street name may not always be populated.

ShippingLabelPolicy field added

A new optional ShippingLabelPolicy field has been added to ShippingDetailsType. This field may be returned for applicable order line items. When present, the seller must generate and use a shipping label in accordance with the specified policy. If the field is not returned, no shipping label policy is enforced. Possible value: EBAY_ONLY, which indicates the item must be shipped using an eBay-provided shipping label.

For GetItemTransactions and GetOrders calls, this functionality was released on 2026-06-01. For GetSellerTransactions calls, it was released on 2026-06-24.

Added warning and error message for 1455

For the Australia (AU) marketplace only, this release introduces new Pro subscriptions functionality. To support this, the following warning and error messages may be returned in the AddItem, AddFixedPriceItem, ReviseItem, and ReviseFixedPriceItem calls:

• (warning) 21920459: This listing has been updated to single quantity. To create multi-quantity listings, upgrade to a Pro subscription.
• (error) 21920460: You can't have item variations in a single listing. To create multi-variation listings, upgrade to a Pro subscription.

Support for Size Standardization for eBay Fashion Listings

To support size standardization for Apparel & Footwear listings, the following new warning messages were added in the 1455 release. The long version of each message is used below.

• (warning) 21920466: The product aspects for this category no longer support custom replaceable_value. We updated your custom replaceable_value value to our standard replaceable_value value and saved your listing. Buyers will see the updated replaceable_value value.
• (warning) 21920467: The product aspects for this category no longer support custom replaceable_value. Requests with custom replaceable_value values will be rejected starting July 2026. Update your request to send our standard replaceable_value values.

For more information, see Size Standardization for eBay Fashion Listings.

Documentation Changes and Errata - 1455

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

None for this release.

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

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

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

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

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

None for this release.

Changed Functionality - 1453

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.

GetCategories call decommissioned

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

Documentation Changes and Errata - 1453

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

None for this release.

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

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

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

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

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

None for this release.

Changed Functionality - 1451

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.

VeRo Calls Decommissioned

The GetVeROReportStatus, GetVeROReasonCodeDetails, and VeROReportItems calls have been decommissioned, and the associated call reference documentation has been removed. Additionally, all types exclusively used by these calls have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1451

Documentation Changes and Errata - 1451

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

None for this release.

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

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
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• UploadSiteHostedPictures

Schema Changes - 1423

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

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

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

Provided Inventory Mapping API support to the Add/Revise/Relist family of calls

A reference identifier, introduced through the MappingReferenceId field, has been added to attribute the source of data across API families. This ID is returned in the response of a call to the Inventory Mapping API. Using this ID helps associate requests with the original source used to create the listing.

Changed Functionality - 1423

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.

ExtendSiteHostedPictures Call Decommissioned

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

ExtensionInDays field decommissioned

The ExtensionInDays field of the UploadSiteHostedPictures call has been decommissioned and removed from the WSDL, as eBay no longer supports extending the life of unused EPS URLs beyond 30 days.

New seller accepted value added to BestOfferStatusCodeType

A new enumerated value, SellerAccept, was added to the BestOfferStatusCodeType to support seller acceptance of a buyer's offer. The Accepted enumerated value is now returned only after the buyer has completed the payment. See Schema Changes - 1423 for specifics.

Documentation Changes and Errata - 1423

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

None for this release.

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.

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.

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.

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.

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.

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.

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

DeletedFromUnsoldList DeletedFromSoldList GetMyeBaySelling

SummarySchedule and SMSSubscription containers decommissioned

UserData.SummarySchedule UserData.SMSSubscription GetNotificationPreferences SetNotificationPreferences

Removed non-working UserIDChanged enumerated value from NotificationEventTypeCodeType

UserIDChanged NotificationEventTypeCodeType GetNotificationPreferences GetNotificationsUsage SetNotificationPreferences

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.

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.

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.

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.

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.

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.

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.

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.

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.

GetOrderTransactions GetOrders GetItemTransactions GetSellerTransactions GetMyeBaySelling Deprecated Trading Order Management Fields

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.

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

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
• GetItem

Schema Changes - 1331

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

By January 22nd, 2024, all existing listings must be modified with either Condition ID 2750 or Condition ID 4000 and applicable ConditionDescriptors name-value pairs.

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

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

New ListingOnHold field added to GetItem

The ListingOnHold field has been added to SellingStatusType and will be returned in GetItem as applicable. See SellingStatusType for details on this new field.

Changed Functionality - 1331

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

New error codes for 1331

Below is a list of the new error messages that rolled out with the 1331 release. All of these messages are related to on-hold listings. The long version of each message is used below:

• (warning) 21920396: This listing has a policy violation.

• (error) 21920397: This listing has been removed for a policy violation.

• (error) 21920398: This listing has a policy violation. replaceable_value is not possible.

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

Logic and behavior changes to support on-hold listings

Various logic/behavior changes have been made to several Trading calls that return listing data to indicate if a listing is currently on hold due to an eBay policy violation. These changes are covered in the list below:

• GetItemTransactions: If the item ID passed into the ItemID field is for a listing that is on hold, existing error code 17 ("This item cannot be accessed because the listing has been deleted or you are not the seller.") will be triggered.
• GetOrders: If the Order ID passed into the OrderID field is for a single line item ordered spawned from a listing that is on hold, existing error code 21917182 ("OrderLineItemIDs replaceable_value could not be found. Associated Items may have been deleted or removed.") will be triggered.
• GetOrderTransactions: If the Order ID passed in the OrderID field is for a single line item order spawned from a listing that is on hold, or if the ItemID, SKU, or OrderLineItemID (or ItemID/TransactionID combo specified through the TransactionID container) involves an order line item spawned from a listing that is on hold, existing error code 21917182 ("OrderLineItemIDs replaceable_value could not be found. Associated Items may have been deleted or removed.") will be triggered.
• GetSellerList: When making a GetSellerList call, items that are on-hold due to an eBay policy violation will not be returned in the response.
• GetSellerEvents: When making a GetSellerEvents call, the item.Title field will be returned masked as ***************** for listings on hold due to a policy violation.
• GetSellerTransactions: When making a GetSellerTransactions call, the ItemId value of the listing will be returned in the item.Title field, in place of the item title, to indicate that the listing is on hold due to a policy violation.
• GetMyeBaySelling: When making a GetMyeBaySelling call, the ItemId value of the listing will be returned in the item.Title field, in place of the item title, to indicate that the listing is on hold due to a policy violation.

New enum values added to AccountDetailEntryCodeType

HermesReturnLblSellerPaidShpFee, HermesReturnLblSellerPaidShpFeeCr, DHLReturnLblShippingFee, and DHLReturnLblShippingFeeCredit have been added to AccountDetailEntryCodeType as enum values and will be returned by GetAccount as applicable.

Documentation Changes and Errata - 1331

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

None for this release.

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

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

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

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

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

None for this release.

Changed Functionality - 1327

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.

GetCharities Call Decommissioned

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

Documentation Changes and Errata - 1327

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

None for this release.

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

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

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

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

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

None for this release.

Changed Functionality - 1325

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.

All DSA-related fields are available on all eBay marketplaces

All DSA-related fields are now available on all eBay marketplaces (no longer restricted to specific marketplaces). The Trading API now supports the following features:

• Energy Efficiency Labels
• Hazmat
• Regional Product Compliance Policies
• Regional Take-back Policies
• Repair Score
• Eco-Participation Fee

Documentation Changes and Errata - 1325

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

None for this release.

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

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
• GetAccount
• GetAllBidders
• GetBidderList
• GeteBayDetails
• GetItem
• GetItemShipping
• GetItemTransactions
• GetMyeBayBuying
• GetMyeBaySelling
• GetNotificationPreferences
• GetNotificationsUsage
• GetOrders
• GetOrderTransactions
• GetSellerDashboard
• GetSellerEvents
• GetSellerList
• GetSellerTransactions
• GetUser
• GetVeROReasonCodeDetails
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• SetNotificationPreferences
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1323

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

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

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

New Fee and Credit added to GetAccount

The following new fee and credit fields were added to AccountDetailEntryCodeType, and will be returned in GetAccount as applicable. See AccountDetailEntryCodeType for details on this new fee and credit.

• ExpressPayoutFee
• ExpressPayoutFeeCredit

Changed Functionality - 1323

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.

Extended Producer Responsibility IDs set at account level

For sellers selling on the eBay France Marketplace, Extended Producer Responsibility ID fields are no longer set at the listing level and have been removed from the Trading WSDL. Instead, sellers must provide these IDs for each applicable category in their My eBay accounts. The URL will be based on the seller's home/registration site, and will use this pattern: https://accountsettings.*/epr-fr. Sellers based in the US will use https://accountsettings.ebay.com/epr-fr, sellers based in France will use https://accountsettings.ebay.fr/epr-fr, and so on. The ExtendedProducerResponsibilityType fields removed were: ProducerProductID, ProductPackageID, ShipmentPackageID, and ProductDocumentationID. These fields are no longer usable; if used, the user will get a warning about the fields no longer being supported.

Several enumerated values deprecated in NotificationEventTypeCodeType

Because some of the order inquiry series events have been deprecated, the following enumerated values in NotificationEventTypeCodeType (used in the GetNotificationPreferences, GetNotificationsUsage, and SetNotificationPreferences methods) were also deprecated:

• OrderInquiryClosed
• OrderInquiryOpened
• INRBuyerOpenedDispute
• OrderInquiryProvideShipmentInformation
• OrderInquiryEscalatedToCase
• INRBuyerClosedDispute
• INRSellerRespondedToDispute

NotificationEventTypeCodeType

Four fields deprecated in GetMyeBaySelling call

Because the data is no longer being actively maintained by eBay, the following four fields in GetMyeBaySelling have been deprecated and scheduled for decommission on 02-06-2024: Summary.AuctionBidCount, Summary.ClassifiedAdOfferCount, Summary.TotalLeadCount, and SellingSummary.AuctionBidCount.

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

The TicketListingDetails and QuantityInfo container fields in Add/Revise/Relist/Verify and related calls have been deprecated and are not usable. They will be ignored if sent.

Added Czechia and Cyprus to SiteCodeType

Czechia and Cyprus have been added to SiteCodeType as enumeration values.

UpdateReturnPolicy and UpdateSellerInfo deprecated in ReviseItem call

The UpdateReturnPolicy and UpdateSellerInfofields fields in the ReviseItem call have been deprecated and are not usable. They will be ignored if sent.

OriginatingPostalCode field deprecated

The OriginatingPostalCode was deprecated in Add/Revise/Relist/Verify family, GetItem family, GetSeller family, and GetOrders calls. To specify the postal code of the item's location, using the Item.PostalCode field in the request. For example, in the AddItem call specify the item's location using the Item.PostalCode field.

Documentation Changes and Errata - 1323

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

None for this release.

Index of Changed Calls - 1321

Schema Changes - 1321

Announcements - 1321

New Features - 1321

Changed Functionality - 1321

Documentation Changes and Errata - 1321

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

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
• AddOrder
• GetItem
• GetItemShipping
• GetItemTransactions
• GetOrders
• GetOrderTransactions
• GetSellerTransactions
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• SendInvoice
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1321

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

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

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

None for this release.

Changed Functionality - 1321

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.

GetMyeBayReminders Call Decommissioned

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

Instead of this API, buyers and sellers can go to My eBay to see all of their selling/buying reminders.

CODCost field removed

The deprecated CODCost fields in Add/Revise/Relist/Verify calls and related calls such as SendInvoice have been removed. This field is no longer returned in GetItem/GetOrder/GetSeller responses.

Documentation Changes and Errata - 1321

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

None for this release.

Index of Changed Calls - 1319

Schema Changes - 1319

Announcements - 1319

New Features - 1319

Changed Functionality - 1319

Documentation Changes and Errata - 1319

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

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
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1319

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.

Changed Schema

Announcements - 1319

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

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

Condition grading

Note: The ConditionDescriptors and the ConditionDescriptor containers are currently available only in the United Kingdom (GB), with rollout to other markets in early July 2023.

To provide support for condition grading, the ConditionDescriptors container, and the ConditionDescriptor container and its child fields AdditionalInfo, Name, and Value, can be used by the seller to provide information about the specific condition of an item. This information is passed in using the Add/Revise/Relist/Verify calls and returned by calling GetItem.

Changed Functionality - 1319

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

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

None for this release.

Index of Changed Calls - 1315

Schema Changes - 1315

Announcements - 1315

New Features - 1315

Changed Functionality - 1315

Documentation Changes and Errata - 1315

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

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
• AddOrder
• GetItem
• GetItemShipping
• GetItemTransactions
• GetOrders
• GetOrderTransactions
• GetSellerTransactions
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• SendInvoice
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1315

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

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

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

None for this release.

Changed Functionality - 1315

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.

ShippingDetailsType.CODCost and SendInvoiceRequest.CODCost fields were deprecated

The ShippingDetailsType.CODCost and SendInvoiceRequest.CODCost fields, and the enumerated value BuyerPaymentMethodCodeType.COD was deprecated, as COD is no longer a supported payment method on any marketplace. See Index of Changed Calls - 1315 for affected methods.

Documentation Changes and Errata - 1315

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

None for this release.

Index of Changed Calls - 1313

Schema Changes - 1313

Announcements - 1313

New Features - 1313

Changed Functionality - 1313

Documentation Changes and Errata - 1313

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

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
• GetItemTransactions
• GetOrders
• GetSellerTransactions

Schema Changes - 1313

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

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.

AddTransactionConfirmationItem and GetContextualKeywords Decommissioned

The AddTransactionConfirmationItem and GetContextualKeywords calls have been decommissioned and removed from the Trading WSDL and documentation.

New Features - 1313

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

New Fees and Credits Added to GetAccount

The following new fees and credits were added to AccountDetailEntryCodeType, and will be returned in GetAccount as applicable. See AccountDetailEntryCodeType for details on these new fees and credits.

• PromotedDisplayFee
• PromotedDisplayFeeCredit
• USWHTFederal
• USWHTFederalCredit
• USWHTState
• USWHTStateCredit
• EPRFee
• EPRFeeCredit
• CAPostReturnLabelFee
• CAPostReturnLabelFeeCredit
• HermesReturnLabelFee
• HermesReturnLabelFeeCredit
• BankPayoutFee
• BankPayoutFeeCredit
• CharityDonation
• CharityDonationCredit

Changed Functionality - 1313

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.

Logic Change for RefundAmount Field in MonetaryDetails

For GetOrders call, there has been a logic change for the RefundAmount field under MonetaryDetails container. Previously, the final value fee amount deducted from the seller's payout funds for the sale was not included in this field, which means that the amount in this field may not reflect the buyer's actual refund amount. The GetOrders call will be updated to include the seller's final value fee amount in this field, so the amount in this field should match the buyer's actual refund amount. To pick up this new logic in GetOrdersresponses, a Trading WSDL version of 1311 or above must be used, or the user can use an older Trading WSDL version but include and set the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1311 or above.

Logic Change for Modified Line Items in GST and GIT

For GetSellerTransactions and GetItemTransactions calls, please note that for a multiple line item order, all line items of that order that meet the filter criteria may be returned in the responses, even the line item(s) that were not actually modified. In other words, if any part of the order was modified, all line items of that order may be returned.

Documentation Changes and Errata - 1313

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

None for this release.

Index of Changed Calls - 1311

Schema Changes - 1311

Announcements - 1311

New Features - 1311

Changed Functionality - 1311

Documentation Changes and Errata - 1311

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

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
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1311

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.

Changed Schema

Announcements - 1311

None for this release.

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

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

Regulatory changes

Note: The EnergyEfficiencyLabel and the Hazmat containers are initially available only on the German (DE) marketplace. The RepairScore field is provided for future use (not presently available).

As a part of Digital Services Act (DSA) requirements, the EnergyEfficiencyLabel container and its child fields ImageDescription, ImageURL, and ProductInformationsheet, can be used by the seller to provide Energy Efficiency Label related information for the listing. This information is passed in using the Add/Revise/Relist/Verify calls and returned by calling GetItem.

RegionalProductCompliancePolicies and RegionalTakeBackPolicies fields were added, providing compliance functionality specified by region, and ProductCompliancePolicyID now applies to Global product compliance policies.

Numerous fields scheduled for decommission in order management calls

Numerous fields in the response payloads of the GetOrders, GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling calls are being deprecated. See the Deprecated Trading Order Management Fields document for the complete list of deprecated fields and reasons for deprecation.

Changed Functionality - 1311

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.

Documentation Changes and Errata - 1311

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

Logic change for Total and AmountPaid fields in GetOrders

The field descriptions for Order.Total and Order.AmountPaid fieldsin GetOrders incorrectly stated that sales tax was included in those two amounts, but that was not the case prior to Version 1307. Going foward, sales tax will be included in these amounts if using Trading WSDL Version 1307 or above. If using a Trading WSDL older than Version 1307, the amount in thes fields will not include sales tax. To incorporate the new logic (sales tax included) while using a Trading WSDL that is older than 1307, developers can also use the X-EBAY-API-COMPATIBILITY-LEVEL header and set its value to 1307 or higher.

Index of Changed Calls - 1305

Schema Changes - 1305

Announcements - 1305

New Features - 1305

Changed Functionality - 1305

Documentation Changes and Errata - 1305

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

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
• GetOrderTransactions

Schema Changes - 1305

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
AuthenticityVerification	Type	Modified
AuthenticityVerification.Status	Field	Modified
Order.ShippingAddress	Field	Modified

Announcements - 1305

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

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

None for this release.

Changed Functionality - 1305

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.

Vault in-hand submission shipping address returned

For Vault in-hand submission orders, the warehouse address is now available for the buyer view. For these orders, the address returned for the Buyer View will be the authenticator's address.

New status for AuthenticityVerificationType

The status PASSED_WITH_PARTIAL_FAILURE was added as a possible returned value for AuthenticityVerification.Status field of the following calls:

• GetOrders
• GetOrderTransactions
• GetItemTransactions

Documentation Changes and Errata - 1305

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

None for this release.

Index of Changed Calls - 1303

Schema Changes - 1303

Announcements - 1303

New Features - 1303

Changed Functionality - 1303

Documentation Changes and Errata - 1303

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

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

• GetOrders
• GetStore

Schema Changes - 1303

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
Transaction.LinkedLineItemArray	Container	New
LinkedLineItemArray.LinkedLineItem	Container	New
LinkedLineItemArray.LinkedLineItem.EstimatedDeliveryTimeMax	Field	New
LinkedLineItemArray.LinkedLineItem.EstimatedDeliveryTimeMin	Field	New
LinkedLineItemArray.LinkedLineItem.Item	Container	Added
LinkedLineItemArray.LinkedLineItem.OrderID	Field	New
LinkedLineItemArray.LinkedLineItem.OrderLineItemID	Field	New
LinkedLineItemArray.LinkedLineItem.SellerUserID	Field	New
LinkedLineItemArrayType	Type	New
LinkedLineItemType	Type	New
StoreType	Type	Modified
StoreType.StoreSubscriptionLevelCodeType	Type	Removed
StoreType.StoreSubscriptionLevel	Field	Removed

Announcements - 1303

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

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

Added Support for Linking Separate Orders

Schema was added that links items from separate orders which may be from different sellers. This can be used to provide details about a component (purchased from one seller) needed for its installation (purchased from a different seller). Details can identify the linked seller and also include delivery times, item information, and order information.

Changed Functionality - 1303

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.

SubscriptionLevel field removed from GetStore

The SubscriptionLevel field has been removed from the GetStore call. Use the getSubscription method of the Account API to retrieve information on a seller's eBay store subscription.

Documentation Changes and Errata - 1303

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

None for this release.

Index of Changed Calls - 1301

Schema Changes - 1301

Announcements - 1301

New Features - 1301

Changed Functionality - 1301

Documentation Changes and Errata - 1301

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

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

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
GetApiAccessRules	Call	Removed
ApiAccessRuleType	Type	Removed
AccessRuleCurrentStatusCodeType	Type	Removed
AccessRuleStatusCodeType	Type	Removed
GetApiAccessRulesRequestType	Type	Removed
GetApiAccessRulesResponseType	Type	Removed

Announcements - 1301

Buyers in the EU must be allowed to return an item within 14 days or more

As a part of Digital Services Act (DSA) requirements, as of April 3, 2023, buyers in the EU must be allowed to return an item within 14 days or more, unless the item is exempt. Where applicable, sellers should update their return policies to reflect this requirement of accepting returns from EU buyers. This update can be made through the ReturnPolicy container or through a return business policy that is referenced through the SellerProfiles.SellerReturnProfile container.

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

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

None for this release.

Changed Functionality - 1301

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.

GetApiAccessRules Call Decommissioned

The GetApiAccessRules call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetApiAccessRules have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes - 1301 section. We recommend that you use the Developer Analytics API, an API that retrieves all usage data on all RESTful APIs and the Trading API.

Documentation Changes and Errata - 1301

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

None for this release.

Index of Changed Calls - 1299

Schema Changes - 1299

Announcements - 1299

New Features - 1299

Changed Functionality - 1299

Documentation Changes and Errata - 1299

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

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

• VeROReportItems

Schema Changes - 1299

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

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

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

None for this release.

Changed Functionality - 1299

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 Schema Added to Support VeRO Violation Reporting

The field Brand was added to the ReportItem container to provide the brand name of the item being reported for VeRO violation.

Documentation Changes and Errata - 1299

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

None for this release.

Index of Changed Calls - 1295

Schema Changes - 1295

Announcements - 1295

New Features - 1295

Changed Functionality - 1295

Documentation Changes and Errata - 1295

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

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

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
AddDispute	Call	Removed
AddDisputeResponse	Call	Removed
DisableUnpaidItemAssistance	Call	Removed
GetDispute	Call	Removed
GetUserDisputes	Call	Removed
SellerReverseDispute	Call	Removed
AddDisputeRequestType	Type	Removed
AddDisputeResponseType	Type	Removed
AddDisputeResponseRequestType	Type	Removed
AddDisputeResponseResponseType	Type	Removed
DisableUnpaidItemAssistanceRequestType	Type	Removed
DisableUnpaidItemAssistanceResponseType	Type	Removed
GetDisputeRequestType	Type	Removed
GetDisputeResponseType	Type	Removed
GetUserDisputesRequestType	Type	Removed
GetUserDisputesResponseType	Type	Removed
SellerReverseDisputeRequestType	Type	Removed
SellerReverseDisputeResponseType	Type	Removed
DisputeActivityCodeType	Type	Removed
DisputeArrayType	Type	Removed
DisputeCreditEligibilityCodeType	Type	Removed
DisputeExplanationCodeType	Type	Removed
DisputeFilterCountType	Type	Removed
DisputeFilterTypeCodeType	Type	Removed
DisputeIDType	Type	Removed
DisputeMessageSourceCodeType	Type	Removed
DisputeMessageType	Type	Removed
DisputeReasonCodeType	Type	Removed
DisputeRecordTypeCodeType	Type	Removed
DisputeResolutionReasonCodeType	Type	Removed
DisputeResolutionRecordTypeCodeType	Type	Removed
DisputeResolutionType	Type	Removed
DisputeSortTypeCodeType	Type	Removed
DisputeStateCodeType	Type	Removed
DisputeStatusCodeType	Type	Removed
DisputeType	Type	Removed

Announcements - 1295

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

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

None for this release.

Changed Functionality - 1295

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.

Six Dispute Calls Decommissioned

The following six Dispute calls have been decommissioned as of January 31, 2023. These calls and their exclusively used types have been removed from the Trading WSDL and from reference documentation:

• AddDispute
• AddDisputeResponse
• DisableUnpaidItemAssistance
• GetDispute
• GetUserDisputes
• SellerReverseDispute

The DisableUnpaidItemAssistance, AddDisputeResponse, and SellerReverseDispute calls do not have alternative APIs to use since the Unpaid Item Assistant feature and Unpaid Item cases are deprecated. However, there is a page in Selling Preferences in My eBay that allows a seller to cancel and relist any items that have not been paid for after a specified amount of days.

There are REST API equivalents for the other three calls as follows:

• AddDispute: Use the Create Cancellation Request method of the Post-Order API to make an order cancellation request.
• GetDispute: Use the Get Cancellation method of the Post-Order API to retrieve details on a specific cancellation request.
• GetUserDisputes: Use the Search Cancellations method of the Post-Order API to search for cancellation requests using a variety of search filters.

GetOrderTransactions Call Deprecated

The GetOrderTransactions call is deprecated and will be decommissioned on January 31, 2024. No further updates are planned for this API during the deprecation period. Developers have the option of migrating to the GetOrders call in the Trading API, or the getOrders method of the Fulfillment API. Please note that the Fulfillment API only returns paid orders, so if your use case calls for retrieving both paid and unpaid orders, we recommend migrating to the GetOrders call in the Trading API.

Documentation Changes and Errata - 1295

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

None for this release.

Index of Changed Calls - 1291

Schema Changes - 1291

Announcements - 1291

New Features - 1291

Changed Functionality - 1291

Documentation Changes and Errata - 1291

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

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
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem

Schema Changes - 1291

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

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

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

New Schema Added to Support Hazardous Material Label Related Information and Repair Score

Due to regulatory requirement changes, sellers now have the ability to provide hazardous material related information and the repair score for listings.

Changed Functionality - 1291

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

New Error Codes for 1291

Below is the list of the new error messages that rolled out with the 1291 release. All of these messages are related to using hazardous material related information and repair score. The long version of each message is used below.

• (Warning) 21920371: replaceable_value ID(s) replaceable_value not found. Please use valid ID(s).
• (Warning) 21920372: Duplicate Regulatory ID(s) replaceable_value sent in the request. Duplicate ID(s) have been ignored.
• (Warning) 21920373: Hazmat structure incorrect for replaceable_value.
• (Error) 21920374: Repair score invalid. Repair score must be in the range from replaceable_value to replaceable_value with one decimal place.
• (Error) 21920375: The value of the replaceable_value field is invalid. Field must not exceed replaceable_value characters.

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

Documentation Changes and Errata - 1291

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

None for this release.

Index of Changed Calls - 1285

Schema Changes - 1285

Announcements - 1285

New Features - 1285

Changed Functionality - 1285

Documentation Changes and Errata - 1285

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

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
• GetBidderList
• GetItem
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1285

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

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

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

None for this release.

Changed Functionality - 1285

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

Updated Picture Limit

This release of the Trading API updates the picture limit. With the exception of motor vehicle listings on the US and Canada marketplaces, sellers can now include up to 24 pictures in a listing free of charge in all categories on all marketplaces. The number of included pictures in motor vehicle listings depend on the selected vehicle package (see Fees for selling vehicles on eBay Motors).

Documentation Changes and Errata - 1285

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

None for this release.

Index of Changed Calls - 1281

Schema Changes - 1281

Announcements - 1281

New Features - 1281

Changed Functionality - 1281

Documentation Changes and Errata - 1281

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

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
• GetItem

Schema Changes - 1281

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

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.

EU and UK Payments regulations update: Digital Signatures

Due to EU and UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers, including GetAccount. Refer to Digital Signatures for APIs for information about creating signatures to be included in the HTTP payload.

New Features - 1281

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

New item eligibility flag for shipping managed by eBay

The new boolean field IsItemEMSEligible was added to the GetItem call (in ItemType). If true, the item is eligible for shipping managed by eBay; false, the item is not eligible for shipping managed by eBay.

Changed Functionality - 1281

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.

Updates to GetAccount Call

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

• FedExReturnLabelFee
• FedExReturnLabelFeeCredit
• AUPostReturnLabelFee
• AUPostReturnLabelFeeCredit
• UpsCaLabelFee
• UpsCaLabelFeeCredit
• FedExCaLabelFee
• FedExCaLabelFeeCredit
• HubbedReturnLabelFee
• HubbedReturnLabelFeeCredit
• RoyalMailReturnLabelFee
• RoyalMailReturnLabelFeeCredit
• ParcelForcePostReturnLabelFee
• ParcelForcePostReturnLabelFeeCredit
• OffsiteAdsFee
• OffsiteAdsFeeCredit

See these new values in AccountDetailEntryCodeType for more information.

Updates to CancelReasonCodeType type

A new enumerated value AddressIssues was added and the enumerated value BuyerCancelOrAddressIssue was Deprecated.

See the new value in CancelReasonCodeType for more information.

Shipping service override changes to business policies

When revising or relisting an item that is using business policies and has one or more shipping service cost overrides set up, the Item.SellerProfiles.SellerShippingProfile container and the Item.ShippingServiceCostOverrideList.ShippingServiceCostOverride container(s) must be included even if no changes are being made.

Australia sellers offering freight shipping changes

Sellers offering freight shipping on the Australia (AU) marketplace must now use the AU_Freight enumeration value for ShippingServiceCodeType. For these sellers, the Freight value will no longer be accepted and may lead to a blocking error.

Documentation Changes and Errata - 1281

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

None for this release.

Index of Changed Calls - 1279

Schema Changes - 1279

Announcements - 1279

New Features - 1279

Changed Functionality - 1279

Documentation Changes and Errata - 1279

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

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
• GetOrderTransactions
• GetSellerTransactions

Schema Changes - 1279

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

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

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

Added support for eBay shipping

The return of the eBayEstimatedLabelCost field with a value of 0.0 indicates that a free shipping label by eBay is downloadable by the seller via the eBay website. See more details about Authenticity Guarantee and how eBay shipping applies to eligible sneaker listings.

Changed Functionality - 1279

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

New Error Codes for 1279

Below is the list of the new error messages that rolled out with the 1279 release. All of these messages are related to using eBay Shipping. The long version of each message is used below.

• (Warning) 21920343: replaceable_value. // Mapped to authenticity guarantee notification message
• (Warning) 21920344: replaceable_value. // Mapped to eBay shipping notification message
• (Warning) 21920345: This listing is not eligible for eBay shipping. Option ignored.
• (Error) 21920346: This listing qualifies for eBay shipping. Local pickup only is not a valid shipping option.
• (Error) 21920347: This listing qualifies for eBay shipping. Handling time must not exceed 3 days.
• (Warning) 21920348: replaceable_value has been dropped as no domestic shipping service was provided.

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

Documentation Changes and Errata - 1279

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

None for this release.

Index of Changed Calls - 1275

Schema Changes - 1275

Announcements - 1275

New Features - 1275

Changed Functionality - 1275

Documentation Changes and Errata - 1275

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

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

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

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

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

A new intermediated international shipping program has been added

A new intermediated international shipping program called eBay International Shipping is available. On the US marketplace, the Global Shipping Program is scheduled to be replaced by this new intermediated shipping program (eBay International Shipping). US Sellers opted in to the Global Shipping Program will automatically get opted into eBay International Shipping once it becomes available to them. All US sellers will be migrated by March 31, 2023. As long as the US seller's account is opted in to eBay International Shipping, this shipping option will be automatically enabled for all listings where international shipping is available.

Support for eBay International Shipping has been added to GetOrders, GetSellerTransactions, GetItemTransactions, and GetOrderTransactions calls. The eBay International Shipping partner's address is shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. Additionally, similar to the ReferenceID field provided for the Global Shipping Program, the eBay Virtual Tracking number (eVTN) that is used for the domestic leg of the shipment is appended to the Street2 field (not in the ReferenceID field).

Changed Functionality - 1275

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

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

None for this release.

Index of Changed Calls - 1267

Schema Changes - 1267

Announcements - 1267

New Features - 1267

Changed Functionality - 1267

Documentation Changes and Errata - 1267

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

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

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

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.

Four Store Calls Scheduled for Decommission on September 30

The new Stores platform no longer supports custom store pages and other customization functionality, so the following four store calls are deprecated and scheduled for decommission on September 30, 2022:

• GetStoreCustomPage
• GetStoreOptions
• SetStore
• SetStoreCustomPage

Although these four calls still work and will continue to work up until the decommission date, it is recommended that they are no longer used since none of the customization features in these calls can be applied to stores in the Production environment

Additionally, the following containers and fields related to store customization in the GetStore call are also deprecated and scheduled for decommission on September 30, 2022:

• CustomHeader (string)
• CustomHeaderLayout (enum)
• CustomListingHeader (whole container)
• ExportListings (boolean)
• HeaderStyle (enum)
• HomePage (long)
• ItemListLayout (enum)
• ItemListSortOrder (enum)
• Logo.LogoID (int)
• Logo.Name (string)
• Theme (whole container)
• TitleWithCompatibility (boolean)

New Features - 1267

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

None for this release.

Changed Functionality - 1267

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

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

None for this release.

Index of Changed Calls - 1257

Schema Changes - 1257

Announcements - 1257

New Features - 1257

Changed Functionality - 1257

Documentation Changes and Errata - 1257

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

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

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

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

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

None for this release.

Changed Functionality - 1257

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.

HitCounter field removed from WSDL

The HitCounter field has been removed from the WSDL. It can no longer be used in Add/Revise calls, nor will it be returned in GetItem, GetBidderList, GetSellerEvents, or GetSellerList.

HitCount field updates

The HitCount field will no longer be returned in GetItem or GetBidderList, but it will continue to be returned in GetSellerEvents and GetSellerList, but with a logic change. Instead of the HitCount value representing the lifetime hit count for listings, the value will be the total number of page hits within the latest 30-day period.

Quantity and StartPrice no longer returned in ReviseInventoryStatus

The Quantity and StartPrice fields will no longer be returned in the ReviseInventoryStatus response. However, these fields will function the same as before in ReviseInventoryStatus request. If users would like to verify if their price and/or quanity changes were successfully pushed out to the listing (or variation within a listing), they can use the GetItem call to verify the changes.

Documentation Changes and Errata - 1257

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

None for this release.

Index of Changed Calls - 1255

Schema Changes - 1255

Announcements - 1255

New Features - 1255

Changed Functionality - 1255

Documentation Changes and Errata - 1255

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

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

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

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.

GetCategorySpecifics Call Decommisioned

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

The alternative solution to GetCategorySpecifics is the getItemAspectsForCategory method of the Taxonomy API. For more information about migrating to the Taxonomy API and using the Taxonomy SDK, see the Taxonomy API migration guide.

New Features - 1255

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

None for this release.

Changed Functionality - 1255

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

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

None for this release.

Index of Changed Calls - 1249

Schema Changes - 1249

Announcements - 1249

New Features - 1249

Changed Functionality - 1249

Documentation Changes and Errata - 1249

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

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

• GetItem

Schema Changes - 1249

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

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

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

None for this release.

Changed Functionality - 1249

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.

Extended producer responsibility related information returned

Sellers can now return their listing's extended producer responsibility related information using the GetItem call.

Documentation Changes and Errata - 1249

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

None for this release.

Index of Changed Calls - 1247

Schema Changes - 1247

Announcements - 1247

New Features - 1247

Changed Functionality - 1247

Documentation Changes and Errata - 1247

For a current list of known issues, see the API Status page and the Knowledge Base.

Index of Changed Calls - 1247

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
• GetBidderList
• GetItem
• GetSellerEvents
• GetSellerList
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1247

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

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.

Winter 2022 Seller Updates Available

The Winter 2022 Seller Updates have been released. Below is a high-level summary of the updates:

• More robust sales data available under Performance tab in Seller Hub
• Updates and expansion for all Promoted Listings products (Standard, Express, and Advanced)
• More sellers will get the option of requiring all buyers to provide payment details before making a Best Offer on a listing, reducing the risk of Unpaid Items for Best Offer transactions
• More sellers will get the option of requiring all buyers to provide payment details before making a Best Offer on a listing, reducing the risk of Unpaid Items for Best Offer transactions
• Upcoming updates to order fees and credits
  • Sellers will now be refunded the $0.30 per-order fee for orders that are cancelled at the buyer's request
  • The additional final value fee charged to Below Standard sellers will increase from 5% to 6% (of sales price)
  • Final value fees will have a slight increase for most categories (0.3% for Store sellers and 0.35% for non-Store sellers). See the Selling Fees Updates table for the full list of fee increases.
  • Listing Subtitle fee increases by $0.50 for both fixed-price and auction listings
  • Starting in May 2022, sellers will get partial final value fee credits for partial refunds
  • Starting in June 2022, the Promoted Listings Standard fee will be calculated based on the total order cost (including applicable taxes and shipping), and not just the sales price

New Features - 1247

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

None for this release.

Changed Functionality - 1247

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.

HitCounter and HitCount Fields Deprecated

Hit counters are no longer displayed in View Item pages, so the HitCounter and HitCount fields are no longer applicable and are scheduled for decommission. For developers/sellers who are interested in seeing page views and listing performance, the getTrafficReport method of the Sell Analytics API can be used.

Currently, if the HitCounter field is used in the request payload of an add/revise/relist/verify call, the field will be ignored and a warning message will be returned.

Until both fields are decommissioned, the HitCounter and HitCount fields will still be returned in GetItem, GetBidderList, GetSellerEvents, and GetSellerList. For HitCounter, the default value for the marketplace will be returned, such as NoHitCounter or HiddenStyle.

Documentation Changes and Errata - 1247

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

None for this release.

Index of Changed Calls - 1235

Schema Changes - 1235

Announcements - 1235

New Features - 1235

Changed Functionality - 1235

Documentation Changes and Errata - 1235

For a current list of known issues, see the API Status page and the Knowledge Base.

Index of Changed Calls - 1235

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
• RelistFixedPriceItem
• RelistItem
• ReviseFixedPriceItem
• ReviseItem
• VerifyAddFixedPriceItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 1235

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.

Note: Support for extended producer responsibility regulations and custom policies will become active mid-December 2021. Additional resources such as the custom policies resource (for the Account API), the getExtendedProducerResponsibilityPolicies method (for the Sell Metadata API), and the Custom Policies help page will also become active.

Announcements - 1235

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

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

Note: Support for extended producer responsibility regulations and custom policies will become active mid-December 2021. Additional resources such as the custom policies resource (for the Account API), the getExtendedProducerResponsibilityPolicies method (for the Sell Metadata API), and the Custom Policies help page will also become active.

New Schema added to support custom policies

To support custom policies, policy IDs can be specified in add, revise, relist, or verify calls. This feature is supported by a limited number of sites and specific categories. Refer to the Metadata API to return the enabled sites and categories. To create and manage custom policies, see the Account API.

• CustomPolicies: This container and its child fields are used to specify custom policy IDs.

New Schema added to support extended producer responsibility regulations

To support new extended producer responsibility regulations, information about the producer of a new item can be specified in add, revise, relist, or verify calls. This feature is supported by a limited number of sites and specific categories. Refer to the Metadata API to return the enabled sites and categories.

• ExtendedProducerResponsibility: This container field provides information about the producer of the new item. This includes producer, packaging, shipment packaging, and added documentation IDs, and the EcoParticipationFee.
• VariationExtendedProducerResponsibility: This container field defines variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee in add, revise, relist, or verify calls.

Changed Functionality - 1235

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

New Error Codes for 1235

Below is the list of the new error messages that rolled out with the 1235 release. All of these messages are related to using Extended Producer Responsibility. The long version of each message is used below.

• (Warning) 21920322: replaceable_value is not applicable and has been dropped.
• (Error) 21920323: replaceable_value is required for this category.
• (Warning) 21920324: Eco Participation Fee is not applicable for the condition and has been dropped.
• (Error) 21920325: Eco Participation Fee is not valid and needs to be a number between replaceable_value and replaceable_value.
• (Error) 21920326: replaceable_value is not valid.
• (Error) 21920327: replaceable_value cannot be revised if the item has a bid or is ending within 12 hours.replaceable_value business day(s).
• (Warning) 21920328: Same policy ID(ies) replaceable_value cannot be specified multiple times.
• (Error) 21920329: Only replaceable_value policies can be specified, But given policies are replaceable_value.
• (Error) 21920330: The specified replaceable_value policy(ies) replaceable_value are not found.
• (Error) 21920331: The policy(ies) replaceable_value is not of type replaceable_value.
• (Warning) 21920332: Item level Eco Participation Fee will be ignored for MSKU items.

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

Documentation Changes and Errata - 1235

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

None for this release.