eBay Trading Web Services
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:

• eBay Developer Documentation Center
• eBay Web Services - Quick Start

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

Version 563

Index of Changed Calls - 563

Schema Changes - 563

Announcements - 563

New Features - 563

Changed Functionality - 563

Documentation Changes and Errata - 563

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 563

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

• GetSellerDashboard

Changed Calls

• AddItem
• GetAdFormatLeads
• GetBidderList
• GetCategoryFeatures
• GetFeedback
• GetItem
• GetItemTransactions
• GetMyeBayBuying
• GetOrderTransactions
• GetSellerList
• GetSellerTransactions
• GetUser
• RelistItem
• ReviseItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 563

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 563

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 563

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

Promotional Sales Support for Auctions and Auction/Buy It Now Formats via Free Shipping

Store owners can create promotional sales to offer free shipping. Previously, promotional sales could only be created for price discount sales. Store owners can use the new PromotionalSaleType in SetPromotionalSale to create a price discount only sale, a free shipping only sale, or a price discount and free shipping sale.

Auction and auction/Buy It Now listings can be added to free shipping only sales. Free shipping sales for auction and auction/Buy It Now listings are supported for US and international sites, with the following exceptions: DE (77), AU (15), CH (193), AT (16), UK (3), and IE (205).

For more information, see Putting Store Items On Sale.

Enhancements to PayPal Buyer Protection

On the Australia site (site ID 15), by early June 2008, enhancements to PayPal Buyer Protection will be available. For information about PayPal Buyer Protection on the Australia site, see the following location: https://www.paypal.com/au/cgi-bin/webscr?cmd=p/gen/ua/policy_buyer_complaint-outside. For information about the API changes, see the change histories for the following affected calls: GetBidderList, GetCategoryFeatures, GetItem, GetItemTransactions, GetOrderTransactions, GetSellerList, and GetSellerTransactions.

Preview: Use Your Seller Dashboard To Check Your Selling Performance

Your Seller Dashboard provides a brief summary of your status as an eBay seller. This status information can help you monitor your selling performance and keep your account in good standing.

A new API call, GetSellerDashboard, will be available in production in late May 2008. It will give you a quick view of the following information:

• The placement your listings can get in search results (for Best Match searches)
• The PowerSeller discount you have earned, if any
• Your current PowerSeller level
• Your risk of losing privileges due to violations of eBay policies
• Your overall buyer satisfaction rating (quality of customer service)
• The status of your latest account invoice

We are providing the schema and documentation for GetSellerDashboard early to help you plan how to modify your applications. Additional details may be provided when this functionality becomes available in production.

Changed Functionality - 563

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.

Changes to the eBay Feedback System

As announced back in February, beginning in May 2008, the eBay Feedback system will evolve to improve the accuracy and accountability of feedback given to our buyers and sellers. A few API calls have been updated to account for these changes.

The GetUser call now returns a new element called SellerInfo.TransactionPercent. This value is calculated by taking the ratio of the number of times a seller has sold successfully and the number of times a seller has bought an item throughout the past 365 days. This field is used to gather the seller's activity percentage.

The GetFeedback call now returns these three elements:

• FeedbackSummary.BuyerRoleMetrics
• FeedbackSummary.SellerRoleMetrics
• FeedbackSummaryType.SellerRatingSummaryArray

• AverageRatingSummaryType
• BuyerRoleMetricsType
• SellerRatingSummaryArrayType
• SellerRoleMetricsType
• FeedbackSummaryPeriodCodeType

For more information about the new types and elements, see the GetFeedback and GetUser I/O Call Reference.

The LeaveFeedback call will no longer let a seller leave a Neutral or Negative feedback for a buyer. Also, if a member attempts to leave feedback after 60 days from the end of the transaction, an error is returned. The existing error for leaving feedback after 90 days will remain the same. For buyers, they will not be able to leave Neutral or Negative feedback within 7 days from the end of the transaction, for active PowerSellers who have been on eBay for 12 months.

Note that in New Features - 549, buyers and sellers can earn repeat feedback from other members. As for 563 release, the logic behind unique and repeat feedback is changed to include repeat feedback only and all other feedback will be retroactively recalculated for each member. Further details can be found in the Upcoming Changes to Feedback announcement under the Repeat Feedback Credit section.

New Creation Time Filter for GetAdFormatLeads

As of the first week of June, you can use two new fields in GetAdFormatLeads (StartCreationTime and EndCreationTime) to retrieve only those leads for a user that fall within a specified time window.

Specifying Freight Shipping when Listing

The eBay US seller who uses a freight service other than FreightQuote.com can either select "other freight" on the eBay Web site or can set ShippingType to FreightFlat (a new value in ShippingTypeCodeType) when listing the item. Listings using a non-FreightQuote.com service will return a ShippingService value of FreightOtherShipping (a new value in ShippingServiceCodeType). The seller who specifies FreightFlat cannot set ShippingServiceCost and cannot set ShippingService.

For a broader discussion of freight, see the "Shipping Types" discussion in Shipping.

Affected calls: AddItem family of calls, GetItem, GetItemTransactions, GetItemShipping.

GetMyeBayBuying Allows You to Use the Trading and Shopping APIs Together

GetMyeBayBuying now returns each search element within a user's Favorite Searches. The search name, search query, and search elements, such as QueryKeywords, SortOrder, and Condition are returned for each Favorite Search. The search elements that are returned by this call can be used as input for the Shopping API FindItemsAdvanced request. Using the Shopping API to find the search elements can result in faster search times.

You can also paste the Search Query response, that comes back as a URL, into a browser to re-play the Favorite Search using the Trading API.

The following types (that were previously only in the Shopping API) have been added to the Trading API to support this feature: SimpleItemSortCodeType, ItemTypeCodeType, SearchFlagCodeType, and PreferredLocationCodeType.

The MyeBayFavoriteSearchType has been modified to include elements that match the input values for the FindItemsAdvanced call.

Items Under Minimum Not Returned In Searches

By the beginning of May 2008, the response for Search related calls will not return an item with a listed price that is less than the Minimum Listing Amount (MLA) threshold on the eBay site where the item was originally listed.

The following calls are affected by this change:

• GetSearchResults
• GetCategoryListings
• GetProducts

The MLA varies by site ID (e.g. $0.99 on the US site and 1 euro on the UK site) and is an additional transparent filter that will not affect any existing functionality of the affected calls. The MLA filtering will automatically be applied to the following listing formats for items returned in the response of the calls:

• Buy It Now (BIN) Format and Store Inventory Format
• Chinese Auction Format and Chinese Auction + BIN Format in 1, 3, and 5 day listings.

However, MLA filtering will not apply to Chinese Auction and Chinese Auction + BIN Format for listings lasting 6 days or more.

Whenever the response of these calls returns items listed on another (international) eBay site, the price of those items is first converted to the local country currency and is then compared to the local MLA threshold.

The MLA will be applied across all eBay sites, including eBay Express and Motors (does not include Half.com).

ReviseItem: Shipping Details and Multi-Quantity Listings

(Prior announcements had set this as end of April.) Starting in mid May 2008, for multi-quantity Store Inventory Format listings and for multi-quantity Fixed Price listings, a seller can revise all shipping details of the listing (except for sales tax and for shipping type of Freight) for all unsold items. This applies to both domestic and international shipping. Checkout is not affected for those who bought items prior to the seller's shipping changes--the shipping details that were in effect at the time of purchase are used for that buyer at the time of checkout.

Documentation Changes and Errata - 563

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

eBay Web Site Differences for Third Party Checkout

The eBay Web site has no way of specifying or changing the "ThirdPartyCheckout" field. Further, consequences related to ThirdPartyCheckout are different on the site for relisting and revising an item: site:

• If you relist an item via the eBay Web site, the ThirdPartyCheckout setting is dropped (set to false).
• If you revise an item via the eBay Web site, the existing ThirdPartyCheckout setting is preserved.

Improvement of and Migration of Samples

As noted in the Documentation Changes and Errata section for Version 561, one of the API Docs team's tasks is to improve samples for the Trading API and move them from the WebHelp to the Input/Output Reference. In Version 563 documentation, these were added: AddItem Samples, RelistItem Samples.

Version 561

Index of Changed Calls - 561

Schema Changes - 561

Announcements - 561

New Features - 561

Changed Functionality - 561

Documentation Changes and Errata - 561

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 561

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

• AddItem
• GetAdFormatLeads
• GetBidderList
• GetCategoryListings
• GetItem
• GetItemRecommendations
• GetItemTransactions
• GetMyeBayBuying
• GetMyeBaySelling
• GetOrderTransactions
• GetProducts
• GetSearchResults
• GetSellerEvents
• GetSellerList
• GetSellerTransactions
• GetUser
• RelistItem
• VerifyAddItem

Schema Changes - 561

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 561

Retiring UK and Germany eBay Express

Starting at the end of April 2008, UK and Germany eBay Express will be shutdown. The sites will no longer be accessible to all users and visitors. Those who try to access the sites will be redirected to a holding page to explain the shutdown. All users previously registered on UK or Germany eBay Express will have their registered status revoked and become ineligible for UK or Germany eBay Express.

For revoked seller's items, any active Express only items will be ended and moved to the unsold items folder and the full insertion fee credit will be issued to the seller. Any scheduled Express only items are also moved to the unsold items folder but not credited since the items were never charged. All other listings in any other format owned by revoked UK or Germany Express sellers will remain on the site as they were.

Existing Charity Sellers Are No Longer Considered Registered

Beginning in May 2008, existing charity sellers will no longer be considered registered charity sellers until they agree to the new Terms & Conditions and create a donation account on eBay. After this date, any charity seller that tries to sell an item as a donation will be taken to the new Terms & Conditions page. When accepted, sellers will be marked as accepted and can continue being registered charity sellers as before.

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 561

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

Improved Lead Gathering

The lead form for vehicle classified listings is being improved to allow prospective buyers to leave more information. New fields have been added to gather the following types of information about prospective buyers:

• Whether the buyer has a vehicle he would like to trade in and, if so, the year, make and model of the trade-in (AdFormatType.TradeInYear, AdFormatType.TradeInMake, AdFormatType.TradeInModel)
• Whether the prospective buyer would like to learn more about financing options (AdFormatType.FinancingAnswer)
• When the buyer would like to purchase his vehicle (AdFormatType.PurchasingTimeFrame)
• email address (AdFormatType.ExternalEmail)

Buyers do not need to log in to use the lead form.

For more information on how to use the GetAdFormatLeads call, see Local Market Listings in the "eBay Motors" chapter of the eBay Trading Web Services Guide.

For more information on the input and output fields for GetAdFormatLeads call see GetAdFormatLeads in the Input/Output Reference.

PayPal Integration on HK, SG, MY, and PH Sites

PayPal is now a supported payment method for the Hong Kong (201), Singapore (216), Malaysia (207), and Philippines (211) sites. Sellers who offer PayPal as a payment option in their eBay listings must comply with the PayPal Payments Policy.

Changed Functionality - 561

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.

Changes to Charity Seller Details for eBay Giving Works

The new User.SellerInfo.CharityAffiliationDetails container will have a child element, CharityAffiliationDetail, which contains three fields:

• AffiliationType
• CharityID
• LastUsedTime

Documentation Changes and Errata - 561

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

Improvement of and Migration of Samples

One of the API Docs team's tasks is to improve samples for the Trading API and move them from the WebHelp to the Input/Output Reference, as you can see for a couple of the first to be refined and moved: ReviseItem Samples, GetItemShipping Samples. In coming months, more and more of the samples will be improved and moved to this new home, as the API Docs team works toward the Input/Output Reference being the consolidated reference for calls.

BuyItNowAvailable Field for Chinese Auctions

The documentation previously stated that Item.ListingDetails.BuyItNowAvailable was only returned for Dutch auctions on the eBay Germany site. This is no longer true. Currently, BuyItNowAvailable is also returned for Chinese auctions on US, UK, AU, and other sites, as long as the Buy It Now option is still available for a listing.

On some sites, the Buy It Now price for a Chinese auction may remain available for listings in certain categories even after a bid is placed. See the Longer Lasting Buy It Now community board post for more details and the latest list of eBay US categories that support this behavior. The eBay Spain site supports this behavior for all categories.

Version 559

Index of Changed Calls - 559

Schema Changes - 559

Announcements - 559

New Features - 559

Changed Functionality - 559

Documentation Changes and Errata - 559

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 559

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

• AddItem
• GetBidderList
• GetCategoryFeatures
• GetItem
• GetSearchResults
• GetSellerList
• RelistItem
• ReviseItem
• VerifyAddItem
• VerifyRelistItem

Schema Changes - 559

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 559

PayPal To Be Required Payment Option for UK Sellers

Starting in late April 2008, all sellers on the eBay UK site are required to offer PayPal on their listings. For more information and for links to other recent, PayPal-related announcements, please see the following locations:

• Making eBay Safer and Easier with PayPal
• Reminder: Safer Payments Requirements Go Into Effect on March 17th

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 559

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

Making Listings Available by Default on Another Site

Beginning in early May 2008, you can use the International Site Visibility feature to make listings available in the default search results of another site.

The International Site Visibility feature is a listing upgrade that US, Canada, UK, and Ireland sellers can choose when they list an item on their primary listing site.

For information about the International Site Visibility feature, see the following recent Announcement Board posts:

• Information for US sellers
• Information for UK sellers
• Information for Canada sellers

For more information about the additions to the API, see Making Listings Available by Default on Another Site.

GetItem Returns Business Seller Information in a Business Card Display Format

GetItem now returns the seller's information (in a business card format) if the seller's SellerBusinessCodeType is set to 'Commercial'. This is only applicable for sites where Business Seller options are supported.

Changed Functionality - 559

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.

Shipping Requirement For New Users

Starting April 8, 2008, new users who are listing for the first time (in selected categories on the US site) must specify at least one domestic shipping service and associated cost for this and all subsequent listings.

This applies to a category if GetCategoryFeatures returns true for Category.ShippingTermsRequired.

This change affects AddItem, VerifyAddItem, ReviseItem and RelistItem.

Changes to PicturePack and SuperSize for Gallery PhotoDisplayType

The Item.PictureDetails.PhotoDisplayType.PicturePack enum in AddItem, ReviseItem and RelistItem calls have the following changes:

• Whenever PicturePack is selected, the request now accepts a minimum of one eBay Picture Services (EPS) hosted image (using Item.PictureDetails.PictureURL) as well as EPS images that are not SuperSize-qualified.
• If PicturePack is selected and no images are included, the request is accepted and PicturePack is unselected. However, the PicturePack fee will still apply if a previous request selected PicturePack (i.e. when using ReviseItem). There is at most one PicturePack fee per listing.

These functionality changes apply to all sites that offer PicturePack, including US Motors, except for the Netherlands (site ID 146) site. On the NL site only, requests selecting PicturePack will be replaced with Item.PictureDetails.PhotoDisplayType.SuperSize, as NL already offers free bundled pictures. Listings on the NL site that specified PicturePack prior to 559 are not automatically upgraded to SuperSize (i.e. when using ReviseItem) after the change is in effect.

The Item.PictureDetails.PhotoDisplayType.SuperSize enum in AddItem and related calls have the following changes:

• Whenever SuperSize is selected and no SuperSize-qualified images are specified (using Item.PictureDetails.PictureURL), the request is accepted.
• If SuperSize is selected and no images are included, the request is accepted and SuperSize is unselected. However, the SuperSize fee will still apply if a previous request selected SuperSize (i.e. when using ReviseItem). There is at most one SuperSize fee per listing.

These functionality changes apply to all sites that support the SuperSize feature, except for sites that automatically upgrade SuperSize to PicturePack, including US Motors Parts & Accessories Category and US (site ID 0), CA (site ID 2) and CAFR (site ID 210) sites.

Picture Show Photo Display Options Are No Longer Available

For AddItem and RelistItem, the Picture Show photo display options for creating a slide show in your Gallery are no longer available. For cases where an item has PictureShow selected, the PhotoDisplayType is replaced by the default value of None in the response if the requested PhotoDisplayType is SiteHostedPictureShow or VendorHostedPictureShow. If the requested PhotoDisplayType is SuperSizePictureShow, the response returns SuperSize. For ReviseItem, if PictureShow was added before 559, the PhotoDisplayType will not be modified. Otherwise, the same PhotoDisplayType replacement occurs.

Green Camera Icon No Longer Supported

Beginning on version 559, the green camera icon will no longer be available for use as a listing's gallery thumbnail in the search results on the following category and sites: US (site id 0), US Motors Parts & Accessories Category, CA (site id 2), CAFR (site id 210), FR (site id 71), NL (site id 146), ES (site id 186), and IT (site id 101). That is, a listing that has set the first PictureURL in the PictureURL array to the null-image URL (http://pics.ebay.com/aw/pics/dot_clear.gif) will no longer display the green camera icon in the search results for these sites starting on 559.

Depending on other available images included in the request and the site to display the listing, eBay will attempt to select a Gallery image source whenever the null-image URL has been specified, and in some cases will use an available eBay stock photo as the Gallery thumbnail (see Including Pictures in the Search Results Gallery for more information on the Gallery image selection process). If a valid image cannot be found, the Gallery thumbnail for the listing will display a blank in the search results. This change will allow sellers to create listings that directly benefit from the free basic Gallery feature available on most sites (see Changed Functionality - 551 for more information on free Gallery).

Digital Delivery Disabled

As of March 2008, all digital listings (downloadable goods) selling on eBay US are required to be listed in a Classified Ad format within the Everything Else > Information Product category. The previous digital delivery feature is disabled as of March 28, 2008. AddItem and related calls using the DigitalDeliveryDetails fields will fail. Sellers who wish to continue to use the Trading API to offer digital goods can do so by setting the value of Item.ListingType to LeadGeneration and Item.ListingSubtype2 to ClassifiedAd instead (and list in the Everything Else > Information Product category).

Using the Classified Ads format, sellers receive a 30-day ad at a fixed price. This solution enables sellers to continue to market their digital goods on eBay; however, because Classified Ad listings are a lead generation tool and do not result in transactions that go through eBay, Feedback cannot be exchanged between buyer and seller.

All digital delivery fields will be removed from the schema in a future release, and the documentation will be updated with more details at that time.

Documentation Changes and Errata - 559

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

LookupAttributeArray Only Supported for Media Categories on US Site

The section on listing an item with product data in the Trading API Guide has been updated to state that LookupAttributeArray is only supported for items on the eBay US site (site ID 0). The description of LookupAttributeArray has also been updated in the Input/Output Reference.

Version 557

Index of Changed Calls - 557

Schema Changes - 557

Announcements - 557

New Features - 557

Changed Functionality - 557

Documentation Changes and Errata - 557

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 557

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

• GetSessionID
• GetTokenStatus
• RevokeToken

Changed Calls

• FetchToken
• GetCharities
• GetSellerList

Schema Changes - 557

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 557

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 557

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.

GetSellerList Returns Policy Details for Canceled Listings

You can now use GetSellerList to find out when items were administratively canceled (due to a violation of eBay's listing policies). These enhancements apply to all eBay sites, including eBay Motors and Express (does not include Half.com).

GetSellerList returns Item.SellingStatus.AdminEnded as true when:

• The item's listing was administratively canceled (see Rules for Listing - Overview for more information on eBay's listing policies).
• The item can be relisted using RelistItem (see RelistItem for more details).

If Item.SellingStatus.AdminEnded is true for an item in the response, then Item.ItemPolicyViolation.PolicyID and Item.ItemPolicyViolation.PolicyText are also included in the Item node to provide the ID and a brief textual description, respectively, of the violated policy.

You can now specify AdminEndedItemsOnly as true in GetSellerList request and only Item nodes that include Item.SellingStatus.AdminEnded as true are returned in the response. If AdminEndedItemsOnly is used, all other filters specified in the request are ignored.

GetCharities Now Supports Searching for Featured Charities

You can now search for featured charities using GetCharities by setting the value of GetCharities.Featured to true. If you do not specify GetCharities.Featured, GetCharities will use the existing logic and return all data of available charities.

Improvements to User Token Retrieval

eBay encourages all applications to use the FetchToken method of token retrieval, and discourages usage of the TokenRedirect option of TokenReturnMethod. When changing implementations to use FetchToken, please use the new GetSessionID call to retrieve a SessionID to be used in the Signin URL.

New RevokeToken Call

A new call, RevokeToken, enables a third-party application to revoke a user token. The call also optionally cancels notification subscriptions associated with the token.

TokenRevocation

A new notification is introduced. It alerts users and third-party applications when a token has been revoked.

GetTokenStatus

A new call returns information about a user token. Information returned includes token status, creation and expiration dates, and user ID. When a token has been revoked, the call identifies the initiator of the revocation as the user, the application, or eBay customer service.

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

Changed Functionality - 557

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.

Affiliate Tracking: Migration to eBay Partner Network

For eBay, the affiliate tracking URLs of Commission Junction will stop tracking starting May 1st, 2008. For information about affiliate tracking, see Affiliate Tracking Concepts.

If you are a Commission Junction member, please join the eBay Partner Network. The eBay Partner Network replaces Commission Junction as a service provider for the eBay Affiliate Program. References in the documentation to Commission Junction have been changed to reference eBay Partner Network (https://www.ebaypartnernetwork.com).

Please migrate your affiliate account and all affiliate tracking to eBay Partner Network between April 1st and May 1st. For migration, please see Affiliate Migration to eBay Partner Network.

Changes in Anonymous User ID Format for GetBestOffers

GetBestOffers currently replaces each of the last 3 characters of a user ID with an asterisk (*) to make a user ID anonymous (e.g., User***). GetBestOffer will now use the a****b anonymizing scheme used elsewhere in the API. There are no schema changes as a result of this modification.

Documentation Changes and Errata - 557

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

None for this release.

Version 555

Index of Changed Calls - 555

Schema Changes - 555

Announcements - 555

New Features - 555

Changed Functionality - 555

Documentation Changes and Errata - 555

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 555

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

• AddItem
• AddOrder
• GetAllBidders
• GetBidderList
• GeteBayDetails
• GetItem
• GetItemShipping
• GetItemTransactions
• GetOrders
• GetOrderTransactions
• GetPromotionalSaleDetails
• GetSellerEvents
• GetSellerList
• GetSellerTransactions
• RelistItem
• ReviseCheckoutStatus
• ReviseItem
• SendInvoice
• SetPromotionalSale
• SetPromotionalSaleListings
• VerifyAddItem

Schema Changes - 555

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 555

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 555

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

Italy Site: Improvements to Cash on Delivery Option for Listings

By April 2008, sellers on the Italy site (site ID 101) will be able to provide an improved Cash on Delivery option for buyers. Using the new functionality, sellers can enable buyers to choose cash on delivery as the shipping method.

For information about enabling cash on delivery shipping, see Specifying the Cash on Delivery Option in Shipping Details.

Changed Functionality - 555

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.

Anonymous Bidder for All Price Ranges

As announced on March 3, some bidder information will now be anonymous, to protect bidders from fraud. While the seller can see the ids of all bidders, and a bidder can see their own information, all competing bidders or outside watchers will only see the anonymized userID.

You may recall that this feature has already been implemented for auctions where the high bid reached $200.00 USD or higher. Now the bidders are anonymous for all auctions.

The bidder User IDs are "masked," so that scammers can't tell who is bidding on a listing and therefore cannot target them with official-looking spoof email. The masked User ID's consist of two random characters from the member's User ID - for example, a***b. This method of identifying a bidder (whose feedback score is visible) gives legitimate members a sense of who is bidding, while protecting the bidders' identities.

This change affects GetAllBidders, GetBidderList, GetSellerEvents, and GetSellerList.

The New Way to Specify Free Shipping

The FreeShipping element is part of the new solution for offering free shipping (for the eBay US site only). When ShippingServiceOption.FreeShipping is set to true, the cost of shipping is zero for the first domestic shipping service (for flat or calculated shipping).

If InsuranceOption is Required and FreeShipping is true, eBay changes the insurance cost to 0 for that shipping service. But if InsuranceOption is Optional, the cost of shipping insurance remains, for it is up to the buyer whether to buy shipping insurance, regardless of whether the seller specified free shipping.

This applies to the AddItem family of calls. This element is also returned by GetItem and GetItemShipping if the first domestic shipping service was marked as FreeShipping.

See Specifying Shipping Costs.

Indicators for Business Seller Item Updates

Two flags are available when retrieving information for items sold by business sellers (Germany, UK, Ireland, or Motors sites only).

The UpdateSellerInfo flag Specifies whether the following Business Seller fields have been updated for the item specified in a request: First Name, Last Name, Fax, Email Address, Additional Contact Information, Trade Registration Number, and VAT Identification Number.

The UpdateReturnPolicy flag specifies whether the Return Policy Details have been updated for the item specified in the request.

Documentation Changes and Errata - 555

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

None for this release.

Version 553

Index of Changed Calls - 553

Schema Changes - 553

Announcements - 553

New Features - 553

Changed Functionality - 553

Documentation Changes and Errata - 553

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 553

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

• AddItem
• GetCategoryListings
• GetSearchResults
• GetSellerList
• RelistItem
• ReviseItem
• VerifyAddItem

Schema Changes - 553

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 553

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 553

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

New Platform Notifications for Buyers

Sixteen new platform notification events become available in this release, most of them buyer-oriented. Applications will be able to subscribe to them using SetNotificationPreferences. When a buyer wins an auction or places an item on a watch list, or when a seller receives a bid on an item, applications will be able to receive notifications that can be displayed in social networking and other third-party applications.

Changed Functionality - 553

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.

Best Match To Be Default for Search Results

The January 29 announcements included the announcement that Best Match would become the default for search results in March 2008. The documentation for GetSearchResults and GetCategoryListings has been updated with this change. For more information, see the eBay General Announcement Board for the announcements of January 29, 2008.

Changes to Free Gallery in Usage of Stock Photo

As described in Changed Functionality - 551, the free Gallery feature now applies on selected sites. However, with the 553 Trading API release, the free Gallery feature is modified as follows: On sites that provide free Gallery (see Changed Functionality - 551), when neither GalleryURL nor PictureURL is specified in the request, eBay will not automatically create a Gallery thumbnail for the listing in search results unless the following fields are set to true in the listing request: Item.ProductListingDetails.UseStockPhotoURLAsGallery and Item.ProductListingDetails.IncludeStockPhotoURL.

Documentation Changes and Errata - 553

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

GetSellerList Does Not Return Stock Photo URL

The documentation has been corrected as follows: ProductListingDetails.StockPhotoURL has been removed from the response of the GetSellerList call.

WatchedItemEndingSoon Notification Returns GetItem Payload

The documentation previously stated that the WatchedItemEndingSoon notification returned the GetMyeBayBuyingResponseType fields. It now states, correctly, that GetItemResponseType fields are returned.

Version 551

Index of Changed Calls - 551

Schema Changes - 551

Announcements - 551

New Features - 551

Changed Functionality - 551

Documentation Changes and Errata - 551

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 551

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

• AddItem
• GetAccount
• GetCategories
• GetItem
• GetItemShipping
• GetItemTransactions
• GetMyeBayBuying
• GetMyeBaySelling
• GetOrders
• GetOrderTransactions
• GetSellerEvents
• GetSellerList
• GetSellerTransactions
• RelistItem
• ReviseItem
• VerifyAddItem

Schema Changes - 551

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 551

Changes for Sellers Announced

Please see the eBay General Announcement Board for the announcements of January 29, 2008, about upcoming changes to feedback, as well as other changes.

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 551

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

Eligible Cancelled Items Can Be Relisted Using RelistItem

Beginning in March 2008, GetItem can be used to find out when items were administratively cancelled (due to a violation of eBay's listing policies). These enhancements apply to all eBay sites, including eBay Motors and Express (does not include Half.com).

GetItem returns Item.SellingStatus.AdminEnded as true when:

• the item's listing was administratively cancelled (see Rules for Listings - Overview for more information on eBay's listing policies).
• the item can be relisted using RelistItem (which can be done quickly).

Item.SellingStatus.AdminEnded is included in the GetItem response only if true. If Item.SellingStatus.AdminEnded is true and the requesting user of GetItem is not the seller of the item, an error is returned in the response (invalid item ID). When Item.SellingStatus.AdminEnded is true, the response of GetItem will also include Item.ItemPolicyViolation.PolicyID and Item.ItemPolicyViolation.PolicyText which provide the ID and a brief textual description, respectively, of the violated policy.

If the item can be relisted, you can use RelistItem to quickly create the new listing, although the RelistItem request should correct the contents that originally triggered the eBay listing policy violation. The response of RelistItem has not changed.

New Item Filter for GetAccount

Sellers can use GetAccountRequestType.ItemID to retrieve all account information incurred as a result of the item specified. Whenever you use the ItemID field, all other filters in the request are ignored. The response of GetAccount remains unchanged.

If the item specified by ItemID does not exist, or if the requesting user is not the seller of the item, an error is returned.

PayPal-Related Enhancements: Payment Holds

Under certain conditions, a buyer's PayPal payment may be held by PayPal. Information about the occurrence of a hold on a buyer's PayPal payment soon will be available through the Trading API.

A "payment review" hold can result from a possible issue with a buyer. Payment review is a review of buyer's payment that in some cases can result in a payment hold, as described in the Payment Review FAQ topic on the PayPal site. Beginning in early March 2008, several Trading API calls can be used to determine if a payment hold has resulted from a review of a buyer payment. For more information, see Holds on PayPal Payments.

A "merchant hold" can result from a possible issue with a seller. In a small percentage of cases where it has been determined that the risk of dissatisfied buyers is higher, PayPal may delay release of payment to the seller until a specific event has occurred, such as positive feedback from the buyer. Merchant holds are described in the Frequently Asked Questions: Rewards & Standards, where, for example, you can search for the phrase "Occasional holds on payment" (no quotes). The Frequently Asked Questions: Rewards & Standards includes information about when a merchant hold can occur and when payment can be released. Beginning in late March 2008, several Trading API calls can be used to determine if a merchant hold has occurred. For more information, see Holds on PayPal Payments.

Specify a "Number of Days" Value When You Retrieve Transactions

You can use NumberOfDays in GetItemTransactions and GetSellerTransactions to specify the number of days' worth of new and modified transactions that you want to retrieve. The call response contains the transactions whose status was modified within the specified number of days since the API call was made. NumberOfDays is often preferable to using the ModTimeFrom and ModTimeTo filters because you only need to specify one value.

More Calls Can Return the Hit Count of Items

You can use GetSellerList and GetSellerEvents to obtain the hit count of an item (in ItemArray.Item.HitCount). As in the current case of GetItem, hit count is returned in cases where the hit counter style is one of the applicable styles. Formerly, a GetItem call was required if you wanted the hit count of an item to be returned.

Changed Functionality - 551

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.

Improvements to GetCategories Response

In order to reduce the size of the GetCategories response, the following CategoryArrayType.CategoryType fields are returned only if they are true:

• CategoryArray.Category.AutoPayEnabled
• CategoryArray.Category.B2BVATEnabled
• CategoryArray.Category.BestOfferEnabled
• CategoryArray.Category.Expired
• CategoryArray.Category.IntlAutosFixedCat
• CategoryArray.Category.LeafCategory
• CategoryArray.Category.LSD
• CategoryArray.Category.ORPA
• CategoryArray.Category.ORRA
• CategoryArray.Category.SellerGuaranteeEligible
• CategoryArray.Category.Virtual

This improvement also applies to the following GetCategoriesResponseType fields:

• GetCategories.ReduceReserveAllowed
• GetCategories.ReservePriceAllowed

When the fields above are to be included in the response (e.g. per the DetailLevel specified in the request), they are only returned when true. They are not returned if they are false or if eBay has not set them for a particular Category node.

All other input and output functionality for GetCategories, including the meaning of the fields above, remains unchanged.

Minimum Listing Amount Changes to AddItem and Related Calls

Beginning in February 2008, sellers will be prevented from listing an item on selected eBay sites if the item's initial price is less than the site's minimum listing amount.

The table belows displays the minimum listing amounts for various listing formats on the following sites (all minimum listing amounts are in the currencies supported by their respective sites), along with the date that the minimum listing amount takes effect.

Sites that are not listed in the table below are not currently subject to the minimum listing amount change.

Minimum Listing Amount Changes to Listing Formats on Selected Sites as of February, 2008

Note that the minimum listing amount does not apply to the multi-item auction listing format on these sites. Note that certain categories on a site with a minimum listing amount support two, four and six day auction formats instead of the one, three and five day auction formats in the above table. On these sites, the minimum listing amount for one day auctions maps to two day auctions, amounts for three day auctions map to four day auctions, and amounts for five day auctions map to six day auctions.

The following calls are affected by the minimum listing amounts change:

• AddItem
• RelistItem
• ReviseItem
• VerifyAddItem

Any listing created, relisted or revised on a site with a minimum listing amount prior to the effective date, but scheduled to appear in production after this date, will not be subject to the minimum listing amount.

For updated information regarding the minimum listing amount on the US and eBay Motors sites, visit the following URLs after the effective date:

• http://pages.ebay.com/help/sell/starting_price.html
• http://pages.ebay.com/help/sell/fees.html

For other sites, use the site abbreviations above. For example, visit the following valid URLs after the effective date:

• http://pages.ebay.co.in/help/sell/starting_price.html
• http://pages.ebay.de/help/sell/fees.html

Gallery Is Now Free on Selected Sites

Beginning in February 2008, the basic Gallery feature will be free on a selected number of sites, although this enhancement will be extended to all eBay sites within the next few releases.

The following sites will implement free Gallery as of February 20, 2008:

• US, site ID 0
• Parts & Accessories Category on US Motors, site ID 100
• CA, site ID 2
• CAFR, site ID 210
• FR, site ID 71
• NL, site ID 146

In addition to the sites above, the following two sites will offer free Gallery as of March 3, 2008:

• ES, site ID 186
• IT, site ID 101

For listings on these sites, eBay will automatically create a Gallery thumbnail for the listing in search results by selecting a picture from one of the image URLs specified in the request (either Item.PictureDetails.PictureURL or Item.PictureDetails.GalleryURL) or from an available stock photo. Thus, a Gallery thumbnail will be created whenever Item.PictureDetails.GalleryType is None or is not specified in the request. Fees will apply whenever GalleryType specifies the Plus or Featured image enhancements (there will be no Gallery fee whenever GalleryType is Gallery, None or is not specified in the request).

eBay will select the image for the thumbnail depending on which of the image URLs above was specified in the request (there are selection rules for four cases). Note that the selected image will not necessarily be the image you have specified in Item.PictureDetails.GalleryURL. The intent is to:

• ensure that a listing will display a Gallery thumbnail in most circumstances, even when one is not specified (as basic Gallery is free), and
• match the gallery thumbnail with the picture at the top of the item's listing page.

The selection rules that eBay uses will ensure a more consistent browsing experience for buyers.

The most common example occurs when both PictureURL and GalleryURL have been specified in the request. In this case, eBay will use the image referenced by PictureURL as the Gallery thumbnail. As three other cases exist, please refer to Using Gallery Features on Sites with Free Gallery for complete information on how eBay selects a image for the gallery thumbnail, as well as changes to the fields below.

As a result of the free Gallery feature, the functionality of the following fields has changed for AddItem, ReviseItem, RelistItem and VerifyAddItem:

• Item.PictureDetails.GalleryType
• Item.PictureDetails.GalleryURL
• Item.PictureDetails.PictureURL
• Item.ProductListingDetails.UseStockPhotoURLAsGallery and Item.ProductListingDetails.IncludeStockPhotoURL are ignored in certain cases
• the green camera icon is no longer available for use as a gallery thumbnail for listings on these sites

Sites not listed above will retain all their original functionality. See Using an eBay Stock Photo as a Gallery Picture for complete information.

Gallery Plus Now Includes Gallery Showcase

On sites that provide free Gallery (see the bulleted lists in the free Gallery entry above), the following changes will apply to the ItemType.PictureDetailsType.GalleryTypeCodeType.Plus enum in AddItem, ReviseItem and RelistItem:

• Whenever Plus is selected in a request that specifies at least two eBay Picture Services (EPS) hosted images (using ItemType.PictureDetailsType.PictureURL), the Gallery Plus feature now automatically includes a Gallery Showcase of all the listing's images at no extra cost. If Plus is selected and the request includes only one EPS image or any self-hosted images, regular Gallery Plus applies.
• When using RelistItem (item has no bids and more than 12 hours before the listing's end) or ReviseItem, Plus can be unselected in the request. However, the Plus fee will still apply if a previous request selected Plus. There is at most one Plus fee per listing.

The Gallery Showcase displays when mousing over or clicking on the listing's Gallery Plus icon in the search results. The Showcase window displays a large (400 px x 400 px) preview image which is usually the first specified PictureURL, as well as up to four (64 px x 64 px) selectable thumbnails for the remaining EPS images (the Showcase window contains pagination controls for observing all EPS images in the request). Clicking on the preview image displays the item's listing page.

This Gallery Plus enhancement applies only to sites that offer free Gallery, and will be available as of the same production date.

Upgrades to Value Pack Bundle on Sites with Free Gallery

On sites that provide free Gallery (see the bulleted lists in the free Gallery entry above), the following changes will apply to the ItemType.ListingEnhancementCodeType.ValuePackBundle enum in AddItem, ReviseItem, RelistItem and VerifyAddItem:

• Whenever ValuePackBundle is selected in a request, the basic Gallery feature included in the Value Pack bundle is now automatically upgraded to the Gallery Plus feature at no extra cost.
• If ValuePackBundle is selected and no Gallery picture is found, the request is still accepted and the ValuePackBundle fee will still apply.

Whenever a listing with ValuePackBundle is created on a site that offers free Gallery, the Gallery Plus upgrade will display on all sites and categories that support ValuePackBundle.

Note that if Gallery Showcase is automatically included with Gallery Plus, it will be extended to listings with ValuePackBundle that upgrade Gallery to Gallery Plus (see previous topic as well as ItemType.PictureDetailsType.GalleryTypeCodeType.Plus for more information).

Listings that specified ValuePackBundle prior to the effective date above are not automatically upgraded from the basic Gallery feature to Gallery Plus (i.e. when using ReviseItem).

This ValuePackBundle enhancement applies only to sites that offer free Gallery, and will be available as of the same production date.

Upgrades to SuperSize on Selected Sites

Beginning on February 20, 2008, ItemType.PictureDetailsType.PhotoDisplayCodeType.SuperSize enum will be automatically upgraded to PicturePack for the same SuperSize fee on the following sites:

• Parts & Accessories Category on US Motors (site ID 100)
• US (site ID 0)
• CA (site ID 2)
• CAFR (site ID 210)

This enhancement applies only to site-hosted images (including Picture Manager). It will be available when using AddItem, ReviseItem, RelistItem and VerifyAddItem. Listings that specified SuperSize prior to February 20 are not automatically upgraded to PicturePack (i.e. when using ReviseItem) after the change is in effect. See ItemType.PictureDetailsType.PhotoDisplayCodeType.PicturePack for more information.

Documentation Changes and Errata - 551

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

CompleteSale: Shipment

In 2007, eBay tested a new navigation bar style with several users, resulting in the green/yellow style of nav bars that you see in the eBay Shopping Call Reference--a style which users cited as easier to use than the nav bar style seen in prior versions of the eBay Trading Input/Output Reference.

Starting with version 551, we are using this improved nav bar style for the eBay Trading Input/Output Reference.

CompleteSale: Shipment

Documentation for Shipment was incomplete. It now shows that ShipmentTrackingNumber and ShippingCarrierUsed are the valid subelements of Shipment.

Version 549

Index of Changed Calls - 549

Schema Changes - 549

Announcements - 549

New Features - 549

Changed Functionality - 549

Documentation Changes and Errata - 549

For a current list of known issues, see System Announcements and the Knowledge Base.

Index of Changed Calls - 549

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

Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.

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

Announcements - 549

Changes for Sellers Announced

Please see the eBay General Announcement Board for the announcements of January 29, 2008, about upcoming changes to feedback, as well as other changes.

Change Requests

See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.

New Features - 549

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

Configurable Output: Selecting the Fields You Want Returned

You can use the OutputSelector field to select the fields returned by many API calls.

When you make a call such as GetItem that retrieves data from eBay, the OutputSelector field is useful for selecting which fields to return. The OutputSelector field is especially useful for calls that return a large amount of data. If you use the OutputSelector field, the output will include only the fields you specified. For more information, see Configuring Output for Retrieving Data.

Buyers and Sellers Can Earn Repeat Feedback from Other Members

Starting in early February 2008, the eBay Feedback system will allow buyers and sellers to affect each other's Feedback Score by one point each week. This will encourage sellers and buyers to engage in repeat transactions with one another.

Currently, a member can impact another member's Feedback score at most +1 or -1 in their lifetime. After the upcoming changes a member will be able to impact another member's Feedback score at most +1 or -1 in a calendar week. Repeat positive or negative Feedback score in a week will not be counted, even if they have more than one transaction between them in that week.

GetUser, GetFeedback, and GetLiveAuctionBidders calls will be changed as following:

• Currently, the User.UniqueNegativeFeedbackCount element contains the total number of unique members who gave negative Feedback to the user. With the upcoming changes, this element will contain the total number of negative Feedbacks received by the user, including weekly repeats.
• Currently, the User.UniquePositiveFeedbackCount element contains the total number of unique members who gave positive Feedback to the user. With the upcoming changes, this element will contain the total number of positive Feedbacks received by the user, including weekly repeats.
• In addition, a new element User.UniqueNeutralFeedbackCount will be returned. This element will contain the total number of neutral Feedbacks received by the user, including weekly repeats.

For more information, see Upcoming Changes to Feedback.

Changed Functionality - 549

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.

Changes for Business Sellers

We have made slight changes in the call logic for the AddItem family of calls, to make it easier for developers to comply with European Union restrictions for business sellers.

The logic for the AddItem family of calls, including AddItem, VerifyAddItem, RelistItem, VerifyRelistItem, AddSecondChanceItem, and VerifySecondChanceItem has changed slightly for users in the United Kingdom, Ireland, and Belgium (Dutch and French). In these countries, users who have sold more than a certain number of items will have to update their account type from 'personal' to 'business'. They will receive an error message if they try to use one of the item family API calls if their account is not defined or if it has been flagged as 'business required'.

In the United Kingdom, Ireland, G