eBay Trading API
 

Trading API Release Notes

The latest version of the Trading API has rolled out to all the API machines and is now available! Be sure to check out all the new features and known issues. For older release notes, see the Release Notes Archive.

Release Version Release Date Description of Release
1371 2024-July-17 New schema added to support GPSR information

Removed economic operator fields from Add/Revise/Relist and VerifyItem family of calls.
1367 2024-July-1 Decommissioned GetSuggestedCategories call; removed related types.
1363 2024-May-29 New requirement when adding EPA approved products
1359 2024-May-08 New error codes for 1359.
1357 2024-April-08 New Fee and Credit enumerated values added to GetAccount.
1355 2024-April-02 Decommissioned GetSellerDashboard call; removed related types.
1349 2024-February-26 Decommissioned TicketListingDetails and QuantityInfo containers and their associated fields for the Add/Revise/Relist/Verify and GetItem family of calls; Decommissioned UpdateReturnPolicy and UpdateSellerInfo fields in the ReviseItem call; decommissioned OriginatingPostalCode field.
1345 2024-February-05 New schema added to support economic operator information.

Decommissioned GetOrderTransactions call; cleaned up decommissioned order-related fields in the GetOrders, GetSellerTransactions, GetItemTransactions, and GetMyeBaySelling calls.
1331 2023-October-23 New ListingOnHold field added to GetItem; New error codes for 1331; Logic and behavior changes to support on-hold listings; New enum values added to AccountDetailEntryCodeType
1327 2023-September-18 GetCharities Call Decommissioned
1325 2023-August-29 All DSA-related fields are available on all eBay marketplaces
1323 2023-August-25 New Fee and Credit added to GetAccount; Extended Producer Responsibility IDs set at account level; Several enumerated values deprecated in NotificationEventTypeCodeType; Four fields deprecated in GetMyeBaySelling call; TicketListingDetails and QuantityInfo containers deprecated in Add/Revise/Relist/Verify calls; Czechia and Cyprus added to SiteCodeType; UpdateReturnPolicy and UpdateSellerInfo deprecated in ReviseItem call; OriginatingPostalCode field deprecated
1321 2023-July-17 GetMyeBayReminders Call Decommissioned; CODCost field removed
1319 2023-Jun-26 Added condition grading support for the United Kingdom (GB)
1315 2023-Jun-16 Deprecated CODCost fields and the enumerated value BuyerPaymentMethodCodeType.COD
1313 2023-Jun-2 AddTransactionConfirmationItem and GetContextualKeywords Decommissioned; Logic Change for RefundAmount Field in MonetaryDetails; Logic Change for Modified Line Items in GST and GIT
1311 2023-May-19 Regulatory changes; Numerous fields scheduled for decommission in order management calls; Logic change for Total and AmountPaid fields in GetOrders

Version 1371

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

Index of Changed Calls - 1371

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

New Calls

No new calls in this release.

Changed Calls

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.

Name Part of Schema Type of Change
RegulatoryType Type Modified
DocumentsType Type Added
DocumentType Type Added
ManufacturerType Type Added
ProductSafetyType Type Added
ResponsiblePersonsType Type Added
ResponsiblePersonType Type Added
ResponsiblePersonCodeTypes Type Added
ResponsiblePersonCodeType Type Added

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.

Note: At this time, the new GPSR elements are supported in the Add/Revise/Relist/Verify calls, but GetItem will not be enabled to return GPSR information (when set on the listing) until later in July.

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.

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

Changed Functionality - 1371

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

None for this release.

Documentation Changes and Errata - 1371

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

None for this release.

Version 1367

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

Index of Changed Calls - 1367

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

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1367

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

Name Part of Schema Type of Change
SuggestedCategoryArrayType Type Removed
SuggestedCategoryType Type Removed

Announcements - 1367

Change Requests

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

New Features - 1367

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

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

None for this release.

Changed Functionality - 1367

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

GetSuggestedCategories Call Decommissioned

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

Documentation Changes and Errata - 1367

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

None for this release.

Version 1363

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

Index of Changed Calls - 1363

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

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1363

None for this release.

Announcements - 1363

Change Requests

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

New Features - 1363

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

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

New requirement when adding EPA approved products

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

Changed Functionality - 1363

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

New error messages for 1363

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

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

Documentation Changes and Errata - 1363

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

None for this release.

Version 1359

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

Index of Changed Calls - 1359

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

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1359

None for this release.

Announcements - 1359

Change Requests

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

New Features - 1359

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

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

None for this release.

Changed Functionality - 1359

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

New error messages for 1359

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

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

Documentation Changes and Errata - 1359

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

None for this release.

Version 1357

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

Index of Changed Calls - 1357

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

New Calls

No new calls in this release.

Changed Calls

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.

Name Part of Schema Type of Change
AccountDetailEntryCodeType Type Modified
AccountDetailEntryCodeType.RegulatoryOperatingFee Enum Added
AccountDetailEntryCodeType.RegulatoryOperatingFeeCredit Enum Added
AccountDetailEntryCodeType.DHLPaymentProcessingFee Enum Added
AccountDetailEntryCodeType.DHLPaymentProcessingFeeCredit Enum Added

Announcements - 1357

Change Requests

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

New Features - 1357

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

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

None for this release.

Changed Functionality - 1357

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

New Fee and Credit enumerated values added to GetAccount

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

Documentation Changes and Errata - 1357

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

None for this release.

Version 1355

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

Index of Changed Calls - 1355

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

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1355

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

NamePart of SchemaType of Change
BuyerSatisfactionDashboardTypeTypeRemoved
BuyerSatisfactionStatusCodeTypeTypeRemoved
PerformanceDashboardTypeTypeRemoved
PerformanceStatusCodeTypeTypeRemoved
PolicyComplianceDashboardTypeTypeRemoved
PolicyComplianceStatusCodeType TypeRemoved
PowerSellerDashboardTypeTypeRemoved
SearchStandingDashboardTypeTypeRemoved
SearchStandingStatusCodeTypeTypeRemoved
SellerAccountDashboardTypeTypeRemoved
SellerAccountStatusCodeTypeTypeRemoved
SellerDashboardAlertSeverityCodeTypeTypeRemoved
SellerDashboardAlertTypeTypeRemoved
SellerFeeDiscountDashboardTypeTypeRemoved

Announcements - 1355

Change Requests

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

New Features - 1355

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

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

None for this release.

Changed Functionality - 1355

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

GetSellerDashboard Call Decommissioned

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

Documentation Changes and Errata - 1355

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

None for this release.

Version 1349

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

Index of Changed Calls - 1349

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

New Calls

No new calls in this release.

Changed Calls

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.

Name Part of Schema Type of Change
TicketListingDetailsType Type Removed
QuantityInfoType Type Removed
UpdateReturnPolicy Field Removed
UpdateSellerInfo Field Removed
OriginatingPostalCode Field Removed

Announcements - 1349

Change Requests

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

New Features - 1349

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

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

None for this release.

Changed Functionality - 1349

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

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

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

UpdateReturnPolicy and UpdateSellerInfo decommissioned in ReviseItem call

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

OriginatingPostalCode field decommissioned

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

Documentation Changes and Errata - 1349

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

None for this release.

Version 1345

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

Index of Changed Calls - 1345

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

New Calls

No new calls in this release.

Changed Calls

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

NamePart of SchemaType of Change
EconomicOperatorTypeAdded
RegulatoryTypeTypeModified
AddressUsageCodeTypeTypeRemoved
ExternalTransactionTypeTypeRemoved
GetOrderTransactionsRequestTypeTypeRemoved
GetOrderTransactionsResponseTypeTypeRemoved
ItemTransactionIDArrayTypeTypeRemoved
ItemTransactionIDTypeTypeRemoved
PaymentHoldDetailTypeTypeRemoved
PaymentHoldReasonCodeTypeTypeRemoved
PaymentTransactionStatusCodeTypeTypeRemoved
RequiredSellerActionArrayTypeTypeRemoved
RequiredSellerActionCodeTypeTypeRemoved
SellingManagerProductDetailsTypeTypeRemoved
UnpaidItemCaseOpenTypeCodeTypeTypeRemoved
UnpaidItemCaseStatusTypeCodeTypeTypeRemoved
UnpaidItemTypeTypeRemoved
Fields used exclusively by GetOrderTransactions were removed. Also, numerous fields in the response payloads of the GetOrders, GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling calls were removed. See the Deprecated Trading Order Management Fields document for a complete list of these fields and reasons.

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.

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.

Version 1331

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

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.

Name Part of Schema Type of Change
SellingStatusType Type Modified
Item.SellingStatus.ListingOnHold Field Added
AccountDetailEntryCodeType Type Modified
AccountDetailEntryCodeType.HermesReturnLblSellerPaidShpFee Enum Added
AccountDetailEntryCodeType.HermesReturnLblSellerPaidShpFeeCr Enum Added
AccountDetailEntryCodeType.DHLReturnLblShippingFee Enum Added
AccountDetailEntryCodeType.DHLReturnLblShippingFeeCredit Enum Added

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:

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:

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.

Version 1327

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.

Name Part of Schema Type of Change
CharityInfoType Type Removed
StringMatchCodeType Type Removed
GetCharitiesRequestType Type Removed
GetCharitiesResponseType Type Removed
NonProfitAddressType Type Modified

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.

Version 1325

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:

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.

Version 1323

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

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.

Name Part of Schema Type of Change
AccountDetailEntryCodeType Type Modified
AccountDetailEntryCodeType.ExpressPayoutFee Enum Added
AccountDetailEntryCodeType.ExpressPayoutFeeCredit Enum Added
ExtendedProducerResponsibilityType.ProducerProductID Field Removed
ExtendedProducerResponsibilityType.ProductPackageID Field Removed
ExtendedProducerResponsibilityType.ShipmentPackageID Field Removed
ExtendedProducerResponsibilityType.ProductDocumentationID Field Removed
NotificationEventTypeCodeType.OrderInquiryClosed Enum Deprecated
NotificationEventTypeCodeType.OrderInquiryOpened Enum Deprecated
NotificationEventTypeCodeType.INRBuyerOpenedDispute Enum Deprecated
NotificationEventTypeCodeType.OrderInquiryProvideShipmentInformation Enum Deprecated
NotificationEventTypeCodeType.OrderInquiryEscalatedToCase Enum Deprecated
NotificationEventTypeCodeType.INRBuyerClosedDispute Enum Deprecated
NotificationEventTypeCodeType.INRSellerRespondedToDispute Enum Deprecated
Summary.AuctionBidCount Field Deprecated
Summary.ClassifiedAdOfferCount Field Deprecated
Summary.TotalLeadCount Field Deprecated
SellingSummary.AuctionBidCount Field Deprecated
TicketListingDetailsType Type Deprecated
TicketListingDetailsType.EventTitle Field Deprecated
TicketListingDetailsType.PrintedDate Field Deprecated
TicketListingDetailsType.PrintedTime Field Deprecated
TicketListingDetailsType.Venue Field Deprecated
SiteCodeType Type Modified
SiteCodeType.Czechia Enum Added
SiteCodeType.Cyprus Enum Added
UpdateReturnPolicy Field Deprecated
UpdateSellerInfo Field Deprecated
OriginatingPostalCode Field Deprecated
QuantityInfo Field Deprecated

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.

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:

See NotificationEventTypeCodeType for additional information.

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.

Version 1321

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

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.

Name Part of Schema Type of Change
ReminderCustomizationType Type Removed
RemindersType Type Removed
ShippingDetailsType.CODCost Field Removed
SendInvoiceRequest.CODCost Field Removed

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.

Version 1319

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

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

Name Part of Schema Type of Change
ConditionDescriptorsType Type New
Item.ConditionDescriptors Field New
ConditionDescriptorType Type New
ConditionDescriptors.AdditionalInfo Field New
ConditionDescriptors.Name Field New
ConditionDescriptors.Value Field New

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.

Version 1315

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

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.

Name Part of Schema Type of Change
ShippingDetailsType.CODCost Field Deprecated
SendInvoiceRequest.CODCost Field Deprecated
BuyerPaymentMethodCodeType.COD Enum Deprecated

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.

Version 1313

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

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.

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.

Version 1311

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

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

Name Part of Schema Type of Change
EnergyEfficiencyType Type New
Item.Regulatory.EnergyEfficiencyLabel Field New
Item.Regulatory.EnergyEfficiencyLabel.ImageDescription Field New
Item.Regulatory.EnergyEfficiencyLabel.ImageURL Field New
Item.Regulatory.EnergyEfficiencyLabel.ProductInformationsheet Field New
Item.Regulatory.RepairScore Field Modified
CustomPolicies.RegionalProductCompliancePolicies Field Added
CustomPolicies.RegionalProductCompliancePolicies.CountryPolicies Field Added
RegionalProductCompliancePolicies.CountryPolicies Field Added
RegionalProductCompliancePolicies.CountryPolicies.Country Field Added
RegionalProductCompliancePolicies.CountryPolicies.PolicyID Field Added
Item.CustomPolicies Field Modified

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.