Trading API

Trading API Release Notes

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

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

Q4 2017
Version Release Date
1043 2017-Nov-24
1041 2017-Nov-10
1039 2017-Oct-27
1037 Not Released
Q3 2017
Version Release Date
1035 2017-Sep-29
1033 2017-Sep-15
1031 2017-Sep-01
1029 2017-Aug-18
1027 2017-Aug-04
1025 2017-Jul-21
1023 Not Released
Q2 2017
Version Release Date
1021 Not Released
1019 2017-Jun-09
1017 2017-May-26
1015 2017-May-12
1013 2017-Apr-28
1011 2017-Apr-14
Q1 2017
Version Release Date
1009 2017-Mar-31
1007 2017-Mar-17
1005 2017-Mar-03
1003 2017-Feb-17
1001 2017-Feb-03
999 Skipped
997 2017-Jan-20
995 2017-Jan-06

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

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

Version 1039

Index of Changed Calls - 1039

Schema Changes - 1039

Announcements - 1039

New Features - 1039

Changed Functionality - 1039

Documentation Changes and Errata - 1039

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

Index of Changed Calls - 1039

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

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

None for this release.

Change Requests

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

New Features - 1039

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

None for this release.

Changed Functionality - 1039

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

Change to Shipping Rate Table Functionality

Once a seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId fields of the RateTableDetails container in an Add/Revise/Relist call, and the DomesticRateTable and InternationalRateTable tags will no longer work. The unique identifiers for all shipping rate tables defined for a seller's account can be retrieved with the getRateTables method of the Account API.

The seller can also apply domestic and international to a shipping business policy and then apply this business policy to the listing through the SellerProfiles.SellerShippingProfile container. Shipping business policies can be created and managed with the Account API.

Shipping rate tables are currently only available for US, Australia, UK, and Germany sites.

Change to Restocking Fee Functionality

For US and Canada sellers charging a restocking fee for non-SNAD returns, the seller can now use the Percent_20 value in the ReturnPolicy.RestockingFeeValueOption to reserve the right to charge a restocking fee percentage for returned items of up to 20 percent (of sale price), but at the seller's discretion, they can also charge less than 20 percent.

The seller can also set a restocking fee in a return business policy and then apply this business policy to the listing through the SellerProfiles.SellerReturnProfile container. Business policies can be created and managed with the Account API.

GetCategorySpecifics Call Returns More Item Specifics

The maximum number of Item Specifics returned in the response of the GetCategorySpecifics call has been increased from 15 to 25. The caller can control how many Item Specifics are returned by setting the MaxNames value in the GetCategorySpecifics call request. If the MaxNames field is omitted, its value defaults to 25, and up to 25 Item Specifics are returned for that category.

Documentation Changes and Errata - 1039

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

Minor Edits and Cleanup for Numerous Trading Type Files

A general documentation cleanup was performed for numerous Trading type definitions.

Version 1035

Index of Changed Calls - 1035

Schema Changes - 1035

Announcements - 1035

New Features - 1035

Changed Functionality - 1035

Documentation Changes and Errata - 1035

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

Index of Changed Calls - 1035

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

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

Change Requests

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

eBay Guaranteed Delivery Now Available on US Site

The eBay Guaranteed Delivery feature has rolled out to the US site. Eligible sellers must opt in to this program. This feature will allow buyers to select items that are guaranteed to be delivered in 1 day, 2 days, 3 days, or 4 days. For general information about this feature, see the Fall 2017 Seller Update. For sellers looking for more technical information on how to integrate with and enabled eBay Guaranteed Delivery through eBay APIs, see the API Integration Playbook for eBay Guaranteed Delivery document.

New Features - 1035

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

None for this release.

Changed Functionality - 1035

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

Maximum Amount of Shipping Rate Tables Increased to 40

With the rollout of eBay Guaranteed Delivery, the maximun number of combined domestic and international shipping rate tables has increased from 20 to 40. Shipping rate tables are required for sellers using the Door-to-Door Option of eBay Guaranteed Delivery, and these tables are used to define shipping cost and delivery times for specific regions and for the different shipping speed categories (Overnight, Expedited, Standard, Economy).

Documentation Changes and Errata - 1035

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

PrivateNotes Field was Erroneously Appearing in GetOrders Call Reference

Although it is not returned in GetOrders, the PrivateNotes field was erroneously appearing in the GetOrders Call Reference documentation. It has been removed in the 1035 Version of the document.

PaymentProfileID Field was Missing from GetMyeBaySelling Call Reference

Although it is returned in GetMyeBaySelling, the PaymentProfileID field was erroneously missing from the GetMyeBaySelling Call Reference documentation. It has been added in the 1035 Version of the document.

General Cleanup of Numerous Trading Complex and Enumeration Type Docs

A general documentation cleanup was performed for several calls and type docs.

Version 1033

Index of Changed Calls - 1033

Schema Changes - 1033

Announcements - 1033

New Features - 1033

Changed Functionality - 1033

Documentation Changes and Errata - 1033

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

Index of Changed Calls - 1033

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

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

Change Requests

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

eBay Guaranteed Delivery Set to Roll Out

The eBay Guaranteed Delivery feature is set to roll out in October 2017. Eligible sellers must opt in to this program. This feature will allow buyers to select items that are guaranteed to be delivered in 1 day, 2 days, 3 days, or 4 days. For general information about this feature, see the Fall 2017 Seller Update. For sellers looking for more technical information on how to integrate with and enabled eBay Guaranteed Delivery through eBay APIs, see the API Integration Playbook for eBay Guaranteed Delivery document.

New Features - 1033

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

None for this release.

Changed Functionality - 1033

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

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

None for this release.

Version 1031

Index of Changed Calls - 1031

Schema Changes - 1031

Announcements - 1031

New Features - 1031

Changed Functionality - 1031

Documentation Changes and Errata - 1031

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

Index of Changed Calls - 1031

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

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

Change Requests

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

2017 Fall Seller Update Released

See the 2017 Fall Seller Update for information about upcoming selling changes, including the eBay Guaranteed Delivery feature, integration of Markdown Manager into Seller Hub, new Q&A feature on product pages, information on eBay policy updates, and updates to Returns.

New Features - 1031

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

None for this release.

Changed Functionality - 1031

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.

InsuranceDetailsType Removed from WSDL

With Trading WSDL Version 1031, the InsuranceDetailsType has been removed. This type was used by the InsuranceDetails and InternationalInsuranceDetails containers in Add/Revise/Relist/Verify calls for sellers to offer shipping insurance to buyers on any eBay site. This feature is no longer applicable/supported on any eBay sites.

Documentation Changes and Errata - 1031

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

SellerProfiles Container Added to Numerous 'Get' Calls

Although the SellerProfiles container has always been returned by 'Get' calls like GetItem since Business Policies have been supported by the Trading API, this container was missing in the Call Reference pages for the 'Get' calls. This container now appears in the Call Reference pages for the following calls:

Improved ShippingTimeMax and ShippingTimeMin Descriptions

In the ShippingTimeMax and ShippingTimeMin fields of ShippingServiceDetails, ShippingServiceOptionsType, and MultiLegShipmentType, it was clarified that the shipping times are based on business days only. For ShippingServiceDetails (returned in the GeteBayDetails call), it was also stated that the seller should look at the ShippingTimeMax value for a shipping service when setting up a listing for eBay Guaranteed Delivery. With eBay Guaranteed Delivery, becoming available in October 2017, the seller's handling time and the shipping time must be four days or less.

Version 1029

Index of Changed Calls - 1029

Schema Changes - 1029

Announcements - 1029

New Features - 1029

Changed Functionality - 1029

Documentation Changes and Errata - 1029

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

Index of Changed Calls - 1029

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

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

Change Requests

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

End of Life for Half.com Site

Starting on September 1, 2017, sellers will no longer be able to list and buyers will no longer be able to buy on Half.com. Beginnning on this date, Half.com will redirect to eBay.com. Returns and refunds for Half.com listings will continue to be processed until October 31, 2017. Half.com users will still have access to their My Account Page until November 30, 2017. For more information on this change, please see the Half.com Closing FAQ page.

New Features - 1029

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

None for this release.

Changed Functionality - 1029

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.

Gift Services and the Gift Icon No Longer Supported

Gift Services and the Gift Icon (in listings) are no longer supported on any eBay Marketplace sites. This means that the Item.GiftServices and Item.GiftIcon fields should no longer be used in Add/Revise/Relist/Verify calls.

Some Listing Enhancements No Longer Supported

The following listing enhancements are no longer supported on any eBay Marketplace sites. This means that the enumeration values associated with this listing enhancements should no longer be passed in through the Item.ListingEnhancement field. Here are the deprecated listing enhancements along with their associated enumeration values:

Documentation Changes and Errata - 1029

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

None for this release.

Version 1027

Index of Changed Calls - 1027

Schema Changes - 1027

Announcements - 1027

New Features - 1027

Changed Functionality - 1027

Documentation Changes and Errata - 1027

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

Index of Changed Calls - 1027

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

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

Change Requests

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

API Support for Half.com Listings is Getting Deprecated

Beginning on August 31, 2017, API support for Half.com listings is being fully deprecated. For a full list of API calls, types, fields, and enumeration values affected by this change, see the Documentation Changes and Errata section.

New Features - 1027

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

Best Offer Feature Enabled for Auction Listings

Beginning with Version 1027, sellers on the US, UK, and DE sites can offer the Best Offer feature in auction listings. The seller can offer Buy It Now or Best Offer in an auction listing, but not both features.

Changed Functionality - 1027

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

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

API Calls, Types, Fields, and Enumeration Values Affected by Half.com Deprecation

Beginning on August 31, 2017, API support for Half.com listings is being fully deprecated. This section will discuss the full list of API calls, types, fields, and enumeration values affected by this change.

The following Trading API calls are exclusively for Half.com listings, and these calls will no longer function beyond August 31:

The following Trading API types are exclusively for Half.com listings, and these types will no longer be applicable beyond August 31:

The following Trading API fields and enumeration values are exclusively for Half.com listings, and these fields/values will no longer be applicable beyond August 31:

Version 1025

Index of Changed Calls - 1025

Schema Changes - 1025

Announcements - 1025

New Features - 1025

Changed Functionality - 1025

Documentation Changes and Errata - 1025

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

Index of Changed Calls - 1025

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

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
MembershipDetailsType Type New
MembershipDetailType Type New
UserType.Membership Element New

Announcements - 1025

Change Requests

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

Best Offer Feature Enabled for Auction Listings

Beginning with Version 1027, sellers on the US, UK, and DE sites will be able to offer the Best Offer feature in auction listings. Once this new capability rolls out, the seller can offer Buy It Now or Best Offer in an auction listing, but not both.

New Features - 1025

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

Membership Details to be Returned in GetUser Call

If a seller is enrolled in one or more membership programs, such as eBay Plus, a Membership container will be returned in the GetUser call. This Membership container will provide details about the seller's membership, including the applicable eBay site and the membership expiration date.

Changed Functionality - 1025

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

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

Best Offer Documentation Updated

All applicable Best Offer calls, fields, and feature guide documentation was updated to reflect the fact that Best Offers will soon be available for auction listings on the US, UK, and DE sites.

Version 1019

Index of Changed Calls - 1019

Schema Changes - 1019

Announcements - 1019

New Features - 1019

Changed Functionality - 1019

Documentation Changes and Errata - 1019

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

Index of Changed Calls - 1019

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

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
RateTableDetailsType.DomesticRateTableId Element New
RateTableDetailsType.InternationalRateTableId Element New
TransactionType.GuaranteedDelivery Element New

Announcements - 1019

Change Requests

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

Spring and Summer Seller Update Changes

The following changes, announced in the Spring and Summer Seller Update, are going into effect soon:

For more information on any of these changes, you can visit the 2017 Spring and Summer Updates.

New Features - 1019

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

New Shipping Rate Tables

eBay is rolling out new domestic and international shipping rate tables to My eBay Shipping Preferences and to the Seller Hub page. Each seller will be able to create a maximum of 20 domestic and/or international shipping rate tables. These shipping rate tables can be applied to a listing by using the new DomesticRateTableId and InternationalRateTableId fields that were added to the ShippingDetails.RateTableDetails container. Sellers will still be able use the old domestic and international shipping rate tables, but they cannot combine old and new tables. They have to use one or the other. These shipping rate tables are being rolled out to US and Australia sellers this month, and rolled out to UK and Germany sellers next month.

eBay Guaranteed Delivery Flag Added to Order Management Calls

A GuaranteedDelivery boolean field was added to TransactionType, and will be returned in the GetOrders, GetOrderTransactions, GetItemTransactions, and GetSellerTransactions calls to indicate whether or not the seller is committed to eBay Guaranteed Delivery. With eBay Guaranteed Delivery, the seller is committing to getting the order to the buyer within three business days. To enable this possibility, the seller must offer 0 or 1-day handling and a one-day or expedited shipping service. This feature will first become available to US sellers in late summer 2017.

Changed Functionality - 1019

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.

Increased Max Length for eBay Category Names

The maximum length of a single eBay category name has increased from 30 to 50 characters. This constraint change is applicable to the eBay category names that are returned in the CategoryName field that is returned in the GetCategories, GetContextualKeywords, GetSellingManagerTemplates, and GetSuggestedCategories calls.

Numerous Confidential Data Fields Hidden in Order Management Calls

Numerous confidential/sensitive data fields have been hidden to any party other than buyer or seller in the responses of the order management calls (GetOrders, GetOrderTransactions, GetItemTransactions, and GetSellerTransactions). If a third party caller is using a Trading WSDL older than 1019, these confidential/sensitive data fields will not even be returned. If a third party caller is using a Trading WSDL 1019 or above, these confidential/sensitive data fields will be returned but will contain dummy/masked data. Below is the list of data fields that this change affects:

Documentation Changes and Errata - 1019

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

None for this release.

Version 1017

Index of Changed Calls - 1017

Schema Changes - 1017

Announcements - 1017

New Features - 1017

Changed Functionality - 1017

Documentation Changes and Errata - 1017

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

Index of Changed Calls - 1017

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

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

Change Requests

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

New Features - 1017

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

None for this release.

Changed Functionality - 1017

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1015

Index of Changed Calls - 1015

Schema Changes - 1015

Announcements - 1015

New Features - 1015

Changed Functionality - 1015

Documentation Changes and Errata - 1015

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

Index of Changed Calls - 1015

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

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

Change Requests

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

New Features - 1015

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

None for this release.

Changed Functionality - 1015

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1013

Index of Changed Calls - 1013

Schema Changes - 1013

Announcements - 1013

New Features - 1013

Changed Functionality - 1013

Documentation Changes and Errata - 1013

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

Index of Changed Calls - 1013

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

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

Change Requests

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

New Features - 1013

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

None for this release.

Changed Functionality - 1013

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1011

Index of Changed Calls - 1011

Schema Changes - 1011

Announcements - 1011

New Features - 1011

Changed Functionality - 1011

Documentation Changes and Errata - 1011

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

Index of Changed Calls - 1011

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

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

Change Requests

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

New Features - 1011

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

None for this release.

Changed Functionality - 1011

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1009

Index of Changed Calls - 1009

Schema Changes - 1009

Announcements - 1009

New Features - 1009

Changed Functionality - 1009

Documentation Changes and Errata - 1009

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

Index of Changed Calls - 1009

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

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

Change Requests

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

New Features - 1009

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

None for this release.

Changed Functionality - 1009

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1007

Index of Changed Calls - 1007

Schema Changes - 1007

Announcements - 1007

New Features - 1007

Changed Functionality - 1007

Documentation Changes and Errata - 1007

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

Index of Changed Calls - 1007

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

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

Change Requests

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

New Features - 1007

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

None for this release.

Changed Functionality - 1007

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

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

Minor Edits to Some Call/Type Documentation

General documentation cleanup was performed for several calls and types.

Version 1005

Index of Changed Calls - 1005

Schema Changes - 1005

Announcements - 1005

New Features - 1005

Changed Functionality - 1005

Documentation Changes and Errata - 1005

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

Index of Changed Calls - 1005

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

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

Change Requests

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

Max Length of Category Names Increasing

The maximum length of an eBay category name (returned in CategoryName field of numerous Trading API calls will be increasing from 30 characters to 50 characters. This change is expected to go into effect on train 1019, scheduled for release in the middle of June 2017. This change will affect the following calls:

New Features - 1005

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

None for this release.

Changed Functionality - 1005

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

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

Cleanup of Some Types

General documentation cleanup was performed for several types.

Version 1003

Index of Changed Calls - 1003

Schema Changes - 1003

Announcements - 1003

New Features - 1003

Changed Functionality - 1003

Documentation Changes and Errata - 1003

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

Index of Changed Calls - 1003

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

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

Change Requests

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

New Features - 1003

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

None for this release.

Changed Functionality - 1003

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

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

Cleanup of Some Types

General documentation cleanup was performed for several types.

Version 1001

Index of Changed Calls - 1001

Schema Changes - 1001

Announcements - 1001

New Features - 1001

Changed Functionality - 1001

Documentation Changes and Errata - 1001

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

Index of Changed Calls - 1001

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

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

Change Requests

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

Product Identifiers Update

Although new schema has recently been added the Add/Revise/Relist/Verify calls and the GetCategorySpecifics call to support a new method of specifying/using product identifiers, this schema will not be available for use in the Sandbox or Production Environments until later in 2017. Expected wire-on dates are expected to be announced as we get close to the second half of 2017. See the Required Product Identifiers Mandate (Current Phase) topic for more information on how product identifiers are currently used/specified in the Trading API, and see the Required Product Identifiers Mandate (Future Phase) topic for more information on how product identifiers will be used/specified in the Trading API beginning later in 2017.

New Features - 1001

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

None for this release.

Changed Functionality - 1001

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

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

None for this release.

Cleanup of Some Types

General documentation cleanup was performed for several types.

Version 997

Index of Changed Calls - 997

Schema Changes - 997

Announcements - 997

New Features - 997

Changed Functionality - 997

Documentation Changes and Errata - 997

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

Index of Changed Calls - 997

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

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
CalculatedShippingRateType.PackageDepth Element Removed
CalculatedShippingRateType.PackageLength Element Removed
CalculatedShippingRateType.PackageWidth Element Removed
CalculatedShippingRateType.ShippingPackage Element Removed
CalculatedShippingRateType.WeightMajor Element Removed
CalculatedShippingRateType.WeightMinor Element Removed
ItemType.ListingCheckoutRedirectPreference Element Removed
ItemType.PostCheckoutExperienceEnabled Element Removed
ItemType.SkypeContactOption Element Removed
ItemType.SkypeEnabled Element Removed
ItemType.SkypeID Element Removed
ItemType.ThirdPartyCheckout Element Removed
ItemType.ThirdPartyCheckoutIntegration Element Removed
ItemType.UseRecommendedProduct Element Removed
ListingCheckoutRedirectPreferenceType Type Deprecated
PictureDetailsType.GalleryURL Element Removed
PictureFormatCodeType.PNG Enum New
ProductListingDetailsType.NameValueList Element New
ReturnPolicyType.EAN Element Removed
ShippingDetailsType.InsuranceFee Element Removed
ShippingDetailsType.InsuranceOption Element Removed
VariationProductListingDetailsType.NameValueList Element New

Announcements - 997

Change Requests

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

Coming Soon: New Way to Specify Product Identifiers in Listing Calls

The NameValueList container was added to the ProductListingDetails and VariationProductListingDetails container in Add/Revise/Relist/Verify calls. Although the NameValueList container was added, it will not be available for use in the Sandbox environment until late in the second quarter, and not available in the Production environment until after June.

Ultimately, specifying product identifiers through the NameValueList container will replace the process of specifying product identifiers through the BrandMPN container, or through the EAN, ISBN, or UPC fields. For more information on how product idenfiers are specified now, see the Required Product Identifiers Mandate (Current Phase) topic. For more information on how product idenfiers will be specified in the future, see the Required Product Identifiers Mandate (Future Phase) topic.

Fields Deprecated from Several Complex Types

Several complex types were cleaned up for 997. The changes are summarized in the table below.

Type Field(s) Deprecation Reason
CalculatedShippingRateType PackageDepth, PackageLength, PackageWidth, ShippingPackage, WeightMajor, WeightMinor Package type, Package dimensions, and package weight should be specified in the ShippingPackageDetails container instead.
ItemType ListingCheckoutRedirectPreference, PostCheckoutExperienceEnabled, SkypeContactOption, SkypeEnabled, SkypeID, ThirdPartyCheckout, ThirdPartyCheckoutIntegration, UseRecommendedProduct Third-party checkout, Post-Checkout Experience, and member communication through Skype have all been deprecated, and the UseRecommendedProduct is also no longer applicable.
PictureDetailsType GalleryURL This field is only used internally.
ReturnPolicyType EAN An EAN should be specified through the ProductListingDetails or VariationProductListingDetails (multiple-variation listings only) containers instead.
ShippingDetailsType InsuranceFee, InsuranceOption If applicable, the shipping insurance option and fee should be specified in the ShippingDetails.InsuranceDetails or ShippingDetails.InternationalInsuranceDetails containers instead.

New Features - 997

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

None for this release.

PNG Now a Supported Picture Format in UploadSiteHostedPictures

A PNG enumeration value was added to PictureFormatCodeType to support PNG format pictures in the UploadSiteHostedPictures call.

Changed Functionality - 997

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.

Valid Product Identifiers are now Required in Item Specifics

Sellers are encouraged to provide product identifying information for all listings. If you're using the ItemSpecifics container to provide product identifiers for a catalog-enabled category, you must comply with new validation requirements for the ItemSpecifics.Name and ItemSpecifics.Value fields.

Valid types of product identifiers in the Name field are:

For any of these Names, the Value field must comply with the new guidelines to avoid an error condition. See Product Identification Using Item Specifics for the detailed guidelines.

Valid product identifiers help sellers populate their listings with product information from the eBay catalog; they help your sellers' listings appear in search engine results (such as Google or Bing) so buyers can find what they're looking for; and they also help to include features in the listing such as product reviews. Without valid product identifiers, your sellers will lose out on these enhancements and the sales they generate.

For more information about product identifiers, see Listing for Advanced Sellers.

Documentation Changes and Errata - 997

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

None for this release.

Version 995

Index of Changed Calls - 995

Schema Changes - 995

Announcements - 995

New Features - 995

Changed Functionality - 995

Documentation Changes and Errata - 995

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

Index of Changed Calls - 995

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

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
ShippingPackageInfoType.HandleByTime Element New
ShippingPackageInfoType.MaxNativeEstimatedDeliveryTime Element New
ShippingPackageInfoType.MinNativeEstimatedDeliveryTime Element New

Announcements - 995

Change Requests

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

New Features - 995

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

New Estimated Delivery Fields Returned in Order Management Calls

The following three fields are now conditionally returned through the ShippingPackageInfo container in GetOrders, GetItemTransactions, GetSellerTransactions, and GetOrderTransactions:

Changed Functionality - 995

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

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

None for this release.

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