SimpleItemType

Contains information for an item.

Types that use SimpleItemType:

Calls that use one or more fields of SimpleItemType:

Fields

AutoPay ( boolean )
BestOfferEnabled ( boolean )
BidCount ( int )
BusinessSellerDetails ( BusinessSellerDetailsType )
BuyItNowAvailable ( boolean )
BuyItNowPrice ( AmountType (double) )
Charity ( CharityType )
ConditionDescription ( string )
ConditionDisplayName ( string )
ConditionID ( int )
ConvertedBuyItNowPrice ( AmountType (double) )
ConvertedCurrentPrice ( AmountType (double) )
Country ( CountryCodeType )
CurrentPrice ( AmountType (double) )
Description ( string )
DiscountPriceInfo ( DiscountPriceInfoType )
DistanceFromBuyer
EndTime ( dateTime )
ExcludeShipToLocation ( string )
GalleryURL ( anyURI )
GermanMotorsSearchable
GetItFast
Gift
GlobalShipping ( boolean )
HalfItemCondition ( HalfItemConditionCodeType )
HandlingTime ( int )
HighBidder ( SimpleUserType )
HitCount ( long )
IntegratedMerchantCreditCardEnabled ( boolean )
ItemCompatibilityCount ( int )
ItemCompatibilityList ( ItemCompatibilityListType )
ItemID ( string )
ItemSpecifics ( NameValueListArrayType )
ListingStatus ( ListingStatusCodeType )
ListingType ( ListingTypeCodeType )
Location ( string )
LotSize ( int )
MinimumToBid ( AmountType (double) )
PaymentAllowedSite ( SiteCodeType )
PaymentMethods ( BuyerPaymentMethodCodeType )
PictureExists
PictureURL ( anyURI )
PostalCode ( string )
PrimaryCategoryID ( string )
PrimaryCategoryIDPath ( string )
PrimaryCategoryName ( string )
ProductID ( ProductIDType (string) )
Quantity ( int )
QuantityAvailableHint ( QuantityAvailableHintCodeType )
QuantityInfo ( QuantityInfo )
QuantitySold ( int )
QuantityThreshold ( int )
RecentListing
ReserveMet ( boolean )
ReturnPolicy ( ReturnPolicyType )
SecondaryCategoryID ( string )
SecondaryCategoryIDPath ( string )
SecondaryCategoryName ( string )
Seller ( SimpleUserType )
SellerComments ( string )
ShippingCostSummary ( ShippingCostSummaryType )
ShipToLocations ( string )
Site ( SiteCodeType )
StartTime ( dateTime )
Storefront ( StorefrontType )
Subtitle ( string )
TimeLeft ( duration )
Title ( string )
TopRatedListing ( boolean )
UnitInfo ( UnitInfoType )
Variations ( VariationsType )
VhrAvailable ( boolean )
VhrUrl ( anyURI )
ViewItemURLForNaturalSearch ( anyURI )
WatchCount ( int )

AutoPay ( boolean ) [1]
If true, the seller requires immediate payment for the item. If false (or not specified), immediate payment is not requested. Buyers must have a PayPal account to purchase items that require immediate payment.

A seller can choose to require immediate payment for Fixed Price and Buy It Now listings, including eBay Stores Inventory listings. If a Buy It Now item ends as an auction (that is, if the Buy It Now option is removed due to bids being placed on the listing), the immediate payment requirement does not apply.

Note: The value of the AutoPay flag indicates the seller's stated preference only. It does not indicate whether the listing is still a candidate for purchase via immediate payment. For example, if a listing receives bids and no longer qualifies for immediate payment, the value of the AutoPay flag does not change.
Only applicable to items listed on PayPal-enabled sites and in categories that support immediate payment. Not applicable to Half.com.
See the Field Index to learn which calls use AutoPay.

BestOfferEnabled ( boolean ) [1]
Whether the seller will accept a best offer for this item. This feature enables a buyer to make a lower-priced binding offer on a fixed price item. Buyers can't see how many offers have been made (only the seller can see this information). To make a best offer on a listing, use the eBay Web site.
See the Field Index to learn which calls use BestOfferEnabled.

BidCount ( int ) [1]
The number of bids that have been placed on the item.

On most sites, the Buy It Now Option becomes unavailable once an auction has a valid bid. Note that the bid must be above any reserve price.

FindPopularItems: For fixed-price listings, the BidCount value is the total number of items purchased so far (in the listing's lifetime).
See the Field Index to learn which calls use BidCount.

BusinessSellerDetails ( BusinessSellerDetailsType ) [0..1]
Returns the seller's business information. Set the SellerBusinessCodeType to 'Commercial' in the request to return the related information. This is only applicable for sites where Business Seller options are supported.
See the Field Index to learn which calls use BusinessSellerDetails.

BuyItNowAvailable ( boolean ) [0..1]
Indicates whether the item has an active Buy It Now option. On most sites, the Buy It Now option is disabled once a valid bid for the item has been accepted. To see if the item was listed with a Buy It Now option, see if the response includes Item.BuyItNowPrice.

This field is returned only if the value is true.
See the Field Index to learn which calls use BuyItNowAvailable.

BuyItNowPrice ( AmountType (double) ) [0..1]
The Buy It Now price of the item, returned in the currency of the site on which the item was listed.

For Chinese auctions (competitive bidding online auctions), Buy It Now lets a user purchase the item at a fixed price and end the auction immediately. On most sites, after a Chinese auction has bids, the listing is no longer eligible for Buy It Now. However, calls can return BuyItNowPrice if the seller originally listed the item with a Buy It Now option. Use the Item.BidCount field to determine whether an auction with Buy It Now has bids or not, and use Item.BuyItNowAvailable to see if the Buy It Now option is still available.

Price fields are returned as doubles, not necessarily in the traditional monetary format of the site's country. For example, a US Dollar value might be returned as 3.880001 instead of 3.88.

For fixed-price (FixedPriceItem) listings, see CurrentPrice or ConvertedCurrentPrice instead.

Returned only if an item was listed with a Buy It Now option.
See the Field Index to learn which calls use BuyItNowPrice.

Charity ( CharityType ) [0..1]
Identifier for a Giving Works listing and the benefiting nonprofit charity organization.
See the Field Index to learn which calls use Charity.

ConditionDescription ( string ) [0..1]
This string field is used by the seller to more clearly describe the condition of items that are not brand new. This field becomes available to sellers starting in November 2012.

The ConditionDescription field will be available for all categories, including categories where the condition type is not applicable (e.g., Antiques). This field will be applicable for all item conditions except "New", "Brand New", "New with tags", and "New in box". If ConditionDescription is used with these conditions (Condition IDs 1000-1499), eBay will simply ignore this field if included, and eBay will return a warning message to the user.

This field should only be used to further clarify the condition of the used item. For example, "The right leg of the chair has a small scratch, and on the seat back there is a light blue stain about the shape and size of a coin." It should not be used for branding, promotions, shipping, returns, payment or other information unrelated to the condition of the item. Make sure that the condition type (Item.ConditionID), condition description, item description (Item.Description), and the listing's pictures do not contradict one another.

The ConditionDescription field is only returned if a condition description is specified in the listing.
See the Field Index to learn which calls use ConditionDescription.

ConditionDisplayName ( string ) [0..1]
Note: Starting in early March 2010, this will be supported for a few test categories in the Sandbox. In May 2010, ConditionDisplayName will be supported for many categories in Production and Sandbox. Monitor the eBay Developers Program newsletter for details and timing.

The human-readable label for the item condition. Display names are localized for the site on which they're listed (not necessarily the site on which they're viewed).

Most categories use the same display name for the same condition ID. Some categories may override the display name based on buyer expectations for items in the category. For example, condition ID 1000 could be called "New" in one category and "New with tags" in another.

Behind the scenes, eBay's search engine uses the ID (not the display name) to determine whether items are new, used, or refurbished.

Only returned when ConditionID is returned. Also see ItemSpecifics in case the seller used that field for the condition instead.
See the Field Index to learn which calls use ConditionDisplayName.

ConditionID ( int ) [0..1]
Note: Starting in early March 2010, this will be supported for a few test categories in the Sandbox. In May 2010, ConditionID will be supported for many categories in Production and Sandbox. Monitor the eBay Developers Program newsletter for details and timing.

The numeric ID (e.g., 1000) for the item condition. Only returned when the seller specified ConditionID in their listing. Also see ItemSpecifics in case the seller used that field for the condition instead.
See the Field Index to learn which calls use ConditionID.

ConvertedBuyItNowPrice ( AmountType (double) ) [0..1]
The listing's Buy It Now Price (if any), converted into the currency of the site to which you sent this request.

Price fields are returned as doubles, not necessarily in the traditional monetary format of the site's country. For example, a US Dollar value might be returned as 3.880001 instead of 3.88.

Some eBay sites also support multi-item Buy It Now auctions, where you can buy multiple items from the same listing at a fixed price. See Item.BuyItNowAvailable.

For fixed-price (FixedPriceItem) listings, see CurrentPrice or ConvertedCurrentPrice instead.

Returned only if an item was listed with a Buy It Now option.

For active items, refresh this value every 24 hours to pick up the current conversion rates (if this value has been converted).
See the Field Index to learn which calls use ConvertedBuyItNowPrice.

ConvertedCurrentPrice ( AmountType (double) ) [1]
The listing's Buy It Now Price (if any), converted into the currency of the site to which you sent this request.

Price fields are returned as doubles, not necessarily in the traditional monetary format of the site's country. For example, a US Dollar value might be returned as 3.880001 instead of 3.88.

Some eBay sites also support multi-item Buy It Now auctions, where you can buy multiple items from the same listing at a fixed price. See Item.BuyItNowAvailable.

For fixed-price (FixedPriceItem) listings, see CurrentPrice or ConvertedCurrentPrice instead.

Returned only if an item was listed with a Buy It Now option.

For active items, refresh this value every 24 hours to pick up the current conversion rates (if this value has been converted).
See the Field Index to learn which calls use ConvertedCurrentPrice.

Country ( see CountryCodeType for possible values ) [1]
Two-letter ISO 3166 country code to indicate the country where the item is located.
See the Field Index to learn which calls use Country.

CurrentPrice ( AmountType (double) ) [1]
The current price of the item in the original listing currency.

For auction listings, this price is the starting minimum price (if the listing has no bids) or the current highest bid (if bids have been placed) for the item. This does not reflect the BuyItNow price.

For fixed-price and ad format listings, this is the current listing price.
See the Field Index to learn which calls use CurrentPrice.

Description ( string ) [1]
The seller's description of the item, if any. This can include HTML markup and JavaScript. See string in Simple Schema Types.

Some sellers don't specify their own listing description. Instead, they use a stock description from a catalog available through eBay. (GetSingleItem doesn't return this stock information.)
See the Field Index to learn which calls use Description.

DiscountPriceInfo ( DiscountPriceInfoType ) [0..1]
This container provides information for an item that has a Strikethrough Price (STP) or a Minimum Advertised Price (MAP) discount pricing treatment. STP and MAP applies to only fixed price, BIN items. STP is available on the US, UK, and German (DE) sites, while MAP is available only on the US site.

Discount pricing is available to qualified sellers (and their associated developers) who participate in the Discount Pricing Program. Once qualified, sellers receive a "sepcial account flag" (SAF) that allows them to apply Discount Pricing to both MSKU and Non-MSKU items.
See the Field Index to learn which calls use DiscountPriceInfo.

DistanceFromBuyer
Not used by any call.

EndTime ( dateTime ) [1]
Time stamp (in GMT) of when the listing is scheduled to end, or time stamp of the actual end time (if the item ended).
See the Field Index to learn which calls use EndTime.

ExcludeShipToLocation ( string ) [0..*]
Use this field to specify an international country or region, or a special domestic location (for sites supporting this feature, currently US, UK, DE) to where you will not ship the associated item. On input, repeat this element for each location that you want to exclude as a shipping destination for your item.

Set ShipToRegistrationCountry to true to have your ExcludeShipToLocation settings applied to your listing. The locations you have excluded display in the Shipping and Handling section of your item listing.

If a buyer's primary ship-to location is a location that you have listed as an excluded ship-to location (or if the buyer does not have a primary ship-to location), they will receive an error message if they attempt to buy or place a bid on your item.

The exclude ship-to location values are eBay regions and countries. To see the valid exclude ship-to locations for a specified site, call GeteBayDetails with DetailName set to ExcludeShippingLocationDetails. Repeat GeteBayDetails for each site on which you list.

This field works in conjunction with Item.ShipToLocations to create a set of international countries and regions to where you will, and will not, ship. You can list a region in the ShipToLocations field, then exclude specific countries within that region with this field (for example, you can specify Africa in ShipToLocations, yet exclude Chad with a ExcludeShipToLocation setting). In addition, if your ShipToLocations is Worldwide, you can use this field to specify both regions and countries that you want to exclude from your shipping destinations.

You can specify a default set of locations to where you will not ship in My eBay. If you create an Exclude Ship-To List, it is, by default, in effect when you list items. However, if you specify any value in this field on input, it nullifies the default settings in your Exclude Ship-To List. (If you use ExcludeShipToLocation when you list an item, you will need to list all the locations to where you will not ship the associated item, regardless of the default settings in your Exclude Ship-To List.)

Specify NONE in this field to override the default Exclude Ship-To List you might have set up in My eBay and indicate that you do not want to exclude any shipping locations from the respective item listing.

Note: To enable your default Exclude Ship-To List, you must enable Exclude Shipping Locations and Buyer Requirements in your My eBay Site Preferences. For details, see the KnowledgeBase Article HowTo: ExcludeShipToLocation.
See the Field Index to learn which calls use ExcludeShipToLocation.

GalleryURL ( anyURI ) [0..1]
URL for a picture used as the Gallery thumbnail, if any. The image uses one of the following graphics formats: JPEG, BMP, TIF, or GIF. Only returned if the seller chose to show a gallery image.
See the Field Index to learn which calls use GalleryURL.

GermanMotorsSearchable
Not used by any call.

GetItFast
Not used by any call.

Gift
Not used by any call.

GlobalShipping ( boolean ) [0..1]
Indicates whether eBay's Global Shipping Program is offered for the listing. If the value of GlobalShipping is true, the Global Shipping Program is the default international shipping option for the listing, and eBay designates an appropriate international shipping service. If the value of GlobalShipping is false, the seller is responsible for specifying an international shipping service for the listing if desired.
See the Field Index to learn which calls use GlobalShipping.

HalfItemCondition ( see HalfItemConditionCodeType for possible values ) [0..1]
Returns the Half.com condition code for the item. For example, "brand new," "used," etc.
See the Field Index to learn which calls use HalfItemCondition.

HandlingTime ( int ) [0..1]
Specifies the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. When listing the item the seller sets this to a positive integer value (1, 2, 3, 4, 5, 10, 15, or 20) corresponding to the number of days. This time does not include the shipping time (the carrier's transit time). GetSingleItem or GetMultipleItems returns HandlingTime only when shipping service options are specified for the item and the seller specified a handling time.

Valid for flat and calculated shipping. Does not apply when there is no shipping, or when using local pickup only or freight shipping.
See the Field Index to learn which calls use HandlingTime.

HighBidder ( SimpleUserType ) [0..1]
The high bidder for comptetitive-bidding auctions that have ended and have a winning bidder. This indicates the user who purchased the item.

Not returned for auctions that have received no bids, or for fixed price and Store Inventory listings that are still active.
See the Field Index to learn which calls use HighBidder.

HitCount ( long ) [0..1]
The number of times the listing's View Item page has been viewed (as determined by eBay). Only returned if the seller has chosen to include a hit counter in the listing, and if the seller has also chosen to make the listing's hit count publicly visible. This field is retrieved asynchronously. If you believe the item has a publicly visible hit count, but this field is not returned, retry the call.

Not applicable to Half.com
See the Field Index to learn which calls use HitCount.

IntegratedMerchantCreditCardEnabled ( boolean ) [0..1]
Indicates whether the item can be paid for through a payment gateway account. If IntegratedMerchantCreditCardEnabled is true, then integrated merchant credit card is enabled for credit cards because the seller has a payment gateway account. Therefore, if IntegratedMerchantCreditCardEnabled is true, and AmEx, Discover, or VisaMC is returned for an item, then on checkout, an online credit-card payment is processed through a payment gateway account.
See the Field Index to learn which calls use IntegratedMerchantCreditCardEnabled.

ItemCompatibilityCount ( int ) [0..1]
Indicates the number of compatible applications specified for the given item. Applies to items listed with fitment by application only (either manually or with a catalog product that supports compatibility).

Not returned if the item has no specified compatible applications.

To retrieve the list of compatibility count and compatibility information, pass IncludeSelector in the request with a value of Compatibility.

Parts Compatibility is supported in limited Parts & Accessories categories, on the eBay Motors (US) site (site ID 100) only.
See the Field Index to learn which calls use ItemCompatibilityCount.

ItemCompatibilityList ( ItemCompatibilityListType ) [0..1]
A list of parts compatibility information specified as name and value pairs, describing an assembly with which a part is compatible (i.e., compatibility by application). For example, to specify a part's compatibility with a vehicle, the name (search name) would map to standard vehicle characteristics (e.g., Year, Make, Model, Trim, and Engine). The values describe the specific vehicle, such as a 2006 Honda Accord. Use the Product Metadata API to retrieve valid search names and corresponding values.

Not returned if the item has no specified compatible applications.

To retrieve the list of compatibility count and compatibility information, pass IncludeSelector in the request with a value of Compatibility.

Parts Compatibility is supported in limited Parts & Accessories categories, on the eBay Motors (US) site (site ID 100) only.
See the Field Index to learn which calls use ItemCompatibilityList.

ItemID ( string ) [1]
The ID that uniquely identifies the item listing. eBay generates this ID when an item is listed. This ID is unique across all eBay sites.
See the Field Index to learn which calls use ItemID.

ItemSpecifics ( NameValueListArrayType ) [0..1]
Category-specific fields that the seller added to describe the listing. The names of these fields are different for items in different categories, so they're returned in a generic Name/Value structure. The field names are usually very well known within the category.

For example, a book's item specifics might include a field like Publication Year=2007 (where Publication Year is returned in Name, and 2007 is returned in Value), and a field like Format=Hardcover. But a car's item specifics would be different from a book's, with fields like Make= Toyota and Model=Prius. And a ticket's item specifics would be different from those of books and cars, with fields like EventType=Concerts and Venue=The Fillmore.

One of the most common uses for item specifics is the item condition.

Only returned if the seller included Item Specifics in the listing.

Note: Starting in May 2010, many categories in Production and Sandbox will start returning the item condition in ConditionID and ConditionDisplayName instead, if the seller used ConditionID instead of ItemSpecifics. Monitor the eBay Developers Program newsletter for details and timing.
See the Field Index to learn which calls use ItemSpecifics.

ListingStatus ( see ListingStatusCodeType for possible values ) [1]
Specifies a listing's status in eBay's processing workflow. If an item's EndTime is in the past, but no details about the buyer or high bidder are shown (and the user is not anonymous), use this listing status information to determine whether eBay has finished processing the listing.
See the Field Index to learn which calls use ListingStatus.

ListingType ( see ListingTypeCodeType for possible values ) [1]
The format of the listing, such as online auction, fixed price, or advertisement format.
See the Field Index to learn which calls use ListingType.

Location ( string ) [1]
Physical location of the item, as specified by the seller. (This gives a general indication of where the item will be shipped or delivered from.)
See the Field Index to learn which calls use Location.

LotSize ( int ) [0..1]
A lot is a set of two or more similar items that must be purchased together in a single transaction. A listing can have multiple lots (instead of multiple items). When LotSize is specified, the listing price reflects the price of each lot (not each item within the lot). In this case, Quantity indicates the number of lots being listed, and LotSize indicates the number of items in each lot. (If a listing has no lots, Quantity indicates the number of separate items being listed.) Important: Lot items can be listed only in lot-enabled categories. GetCategories returns lot size disabled with a value of true for categories that do not support lots.

Not applicable to Half.com.
See the Field Index to learn which calls use LotSize.

MinimumToBid ( AmountType (double) ) [0..1]
Smallest amount the next bid on the item can be. Returns same value as Item.StartPrice (if no bids have yet been placed) or CurrentPrice plus BidIncrement (if at least one bid has been placed). Only applicable to competitive-bid auction listings. Returns null for basic Fixed Price (FixedPriceItem) and Ad type listings.
See the Field Index to learn which calls use MinimumToBid.

PaymentAllowedSite ( see SiteCodeType for possible values ) [1..*]
Enables you to view the sites on which an item can be purchased, based on the payment methods offered for the item.
See the Field Index to learn which calls use PaymentAllowedSite.

PaymentMethods ( see BuyerPaymentMethodCodeType for possible values ) [0..*]
Identifies the payment method (such as PayPal) the seller will accept when the buyer pays for the item.

Note: If the seller only accepts PayPal, the buyer can still pay with a credit card. PayPal supports major credit cards.
Payment methods are not applicable to eBay Real Estate advertisement listings, or other Classified Ad format listings.
See the Field Index to learn which calls use PaymentMethods.

PictureExists
Not used by any call.

PictureURL ( anyURI ) [0..24]
Contains the URL for an image associated with the item, if any. Returned only if the seller included at least one picture in their listing. Note that this element does not return the URLs of pictures that the seller included in the Description via HTML IMG tags.

Items listed the main eBay site can have a maximum of 12 picture URLs hosted by eBay Picture Services, or a maximum of 6 picture URLs hosted by a third party (such as the a photo site). Note that a listing can have up to 24 picture URLs on the US eBay Motors site (for all vehicle listings), and on the eBay Canada Motors site.

eBay uses the seller's first picture at the top of the listing's View Item page.
See the Field Index to learn which calls use PictureURL.

PostalCode ( string ) [1]
Postal code indicating the physical location of the item, as specified by the seller. (This gives a general indication of where the item will be shipped or delivered from.)
See the Field Index to learn which calls use PostalCode.

PrimaryCategoryID ( string ) [1]
Numeric ID of the first (or only) category in which the item is listed. (Listings can appear in more than one category.)
See the Field Index to learn which calls use PrimaryCategoryID.

PrimaryCategoryIDPath ( string ) [1]
The fully qualified ID breadcrumb (path) of the first category. For example, if the primary category ID is 45678, and its parent category's ID is 123, the breadcrumb (path) would be 123:45678.
See the Field Index to learn which calls use PrimaryCategoryIDPath.

PrimaryCategoryName ( string ) [1]
Display name of the first (or only) category in which the item is listed. This is a fully qualified category breadcrumb (e.g., Computers & Networking:Laptops, Notebooks).
See the Field Index to learn which calls use PrimaryCategoryName.

ProductID ( ProductIDType (string) ) [0..1]
A prototype description of a well-known type of item, such as a popular book.

When returned for GetSingleItem, is always of type Reference, and serves as a global reference ID for an eBay catalog product.

When used as input, retrieves product details for one specific product. Specify the ID as a string, and use the type attribute to indicate the nature of the ID you are specifying.

The request requires either QueryKeywords or ProductID, but these fields cannot be used together.
See the Field Index to learn which calls use ProductID.

Quantity ( int ) [1]
The number of items the seller is offering in the listing. (Subtract Item.QuantitySold from this value to calculate the number of items currently available for sale.)

An online, comptetitive-bidding auction with a Quantity of 1 is referred to as a < i>Chinese auction. Basic fixed-price and Store Inventory listings can have a Quantity of 1 or more.

The listing's current or Buy It Now price is the price of the item in the listing.

Note: A seller can also offer multiple items for sale with a single price for all the items. For example, instead of listing 10 lightbulbs for US 2.00 each, they might list 10 lightbulbs for USD 20.00 (where you have to buy all 10). This is called a "lot."

If the listing includes a lot, Quantity does not specify the lot size; it reflects how many lots are being sold. For example, if the original listing included 5 lots of 10 lightbulbs each, Quantity would be 5.

See the Field Index to learn which calls use Quantity.

QuantityAvailableHint ( see QuantityAvailableHintCodeType for possible values ) [0..1]
Indicates the type of message that will be returned describing the quantity available for the item.
See the Field Index to learn which calls use QuantityAvailableHint.

QuantityInfo ( QuantityInfo ) [0..1]
This container consists of the MinimumRemnantSet field, which sets the minimum amount of event tickets that can remain in the fixed-price listing's inventory after a buyer purchases one or more tickets (but not all) from the listing.

This field is currently only applicable for event ticket listings in US and CA, but may apply to other categories in the future. It is only returned if set by the seller in the listing.
See the Field Index to learn which calls use QuantityInfo.

QuantitySold ( int ) [1]
Number of items purchased so far from this listing. (Subtract this value from Item.Quantity to calculate the number of items currently available for sale.)
See the Field Index to learn which calls use QuantitySold.

QuantityThreshold ( int ) [0..1]
The quantity threshold above which the seller prefers not to show the actual quantity available. Returned when the quantity available is greater than the value of quantity threshold. Currently, 10 is the only available value for this threshold.
See the Field Index to learn which calls use QuantityThreshold.

RecentListing
Not used by any call.

ReserveMet ( boolean ) [1]
Indicates whether any bids on this item are greater than the seller's reserve price for the listing (if any).

A reserve is the lowest price at which the seller is willing to sell the item. The reserve price is higher than the listing's opening bid (minimum bid) and lower than the Buy It Now price, if any. (The reserve price is only known to the seller.) Some sellers don't set a reserve at all. If a listing does have a reserve price, the highest bidder will only win the item if their bid is also above that price.

Only returned for online auctions that have a reserve price. (Fixed price, Store Inventory, and classified ad listings don't have reserve prices.)
See the Field Index to learn which calls use ReserveMet.

ReturnPolicy ( ReturnPolicyType ) [0..1]
If a seller specified return policy details, then this container has fields with those details. The fields that can be returned in this container vary by site.
See the Field Index to learn which calls use ReturnPolicy.

SecondaryCategoryID ( string ) [0..1]
ID of the second category in which the item is listed. Returned only if the seller listed a second category.
See the Field Index to learn which calls use SecondaryCategoryID.

SecondaryCategoryIDPath ( string ) [0..1]
The fully qualified ID breadcrumb (path) of the second category. For example, if the secondary category ID is 45678, and its parent category's ID is 123, the breadcrumb (path) would be 123:45678. Returned only if the seller listed a second category.
See the Field Index to learn which calls use SecondaryCategoryIDPath.

SecondaryCategoryName ( string ) [0..1]
Name of the second category in which the item is listed. Returned only if the seller listed a second category.
See the Field Index to learn which calls use SecondaryCategoryName.

Seller ( SimpleUserType ) [1]
Container for information about this listing's seller.
See the Field Index to learn which calls use Seller.

SellerComments ( string ) [0..1]
Notes that the Seller made when they listed the item. Not returned if the Seller did not make any comments.
See the Field Index to learn which calls use SellerComments.

ShippingCostSummary ( ShippingCostSummaryType ) [1]
Contains basic shipping-related costs for the item. If Item.Quantity is greater than 1, this is the shipping cost for one item. If the seller offers a choice of more than one shipping service (such as UPS Ground and USPS Media mail), this is the cost of the "first" shipping option (usually the lowest cost option).

If a listing has shipping costs, use GetShippingCosts if you want to get more details about the services and costs that the seller is offering.
See the Field Index to learn which calls use ShippingCostSummary.

ShipToLocations ( string ) [1..*]
An international location or region to which the seller is willing to ship this item. Returned only for items that have ShipToLocations specified.

Applicable values:

•   Americas

(North, South, or Latin America)

•   Asia

•   Caribbean

•   Europe

•   EuropeanUnion

•   LatinAmerica

•   MiddleEast

•   NorthAmerica

•   Oceania

(Pacific region other than Asia)

•   SouthAmerica

•   WillNotShip

(No shipping, buyer must pick up the item)

•   Worldwide

(Seller will ship worldwide)

•   2-letter country identifier

(See CountryCodeType for values)

See the Field Index to learn which calls use ShipToLocations.

Site ( see SiteCodeType for possible values ) [1]
The name of the eBay site on which the item was originally listed. For example, if the item is listed on the eBay US site, the value would be US. If it's listed on the eBay Germany site, the value would be Germany.

The listing's original site can affect the values of converted (localized) prices (when your request specifies a site that is different from the listing's site).
See the Field Index to learn which calls use Site.

StartTime ( dateTime ) [1]
Time stamp (in GMT) that eBay recorded as the moment that the listing was made available. The start time returned by a search call may vary from the value returned by GetSingleItem.
See the Field Index to learn which calls use StartTime.

Storefront ( StorefrontType ) [1]
Returns the seller's store information if the seller has an eBay store. Returns a blank store if the seller does not have an eBay storefront.
See the Field Index to learn which calls use Storefront.

Subtitle ( string ) [0..1]
Subtitle of the item. Only returned if the seller included a subtitle for the listing.

For US eBay Motors passenger vehicle, motorcycle, and "other vehicle" categories or listings in CA eBay Motors passenger vehicle and motorcycle categories, the seller's subtitle is only available in the Item.ItemSpecifics node. Call GetSingleItem with IncludeSelector=ItemSpecifics to retrieve a listing's Item Specifics.
See the Field Index to learn which calls use Subtitle.

TimeLeft ( duration ) [1]
Time left before the listing ends. The duration is represented in the ISO 8601 duration format (PnYnMnDTnHnMnS). For ended listings, the time left is PT0S (zero seconds).
See the Field Index to learn which calls use TimeLeft.

Title ( string ) [1]
Name of the item as it appears in the listing or in search and browse results.

For US eBay Motors vehicles only: In item-retrieval calls (like GetSingleItem and GetMultipleItems), this value shows the vehicle Make and Model (e.g., "Buick : Skylark").

Note: GetSingleItem does not return the same Item.Title value for US eBay Motors listings. Here's why:

In general, GetSingleItem maps to eBay's View Item page. The eBay Motors Web site's View Item page shows two vehicle titles in the title bar: One title is a label based on the Year, Make, Model, and Submodel (e.g., "1996 Buick Skylark Limited"). The model is included unless it's "Other" or unspecified. The submodel is included if the seller specified a submodel. The other title is a path based on the Make and Model (e.g., "Buick : Skylark"). The Item.Title value in GetSingleItem maps to this path.

See the Field Index to learn which calls use Title.

TopRatedListing ( boolean ) [0..1]
This field is only applicable to the US site, and will only be returned if the US seller qualifies as a Top-Rated Seller. The current requirements for US sellers to qualify as Top-Rated Sellers are:
  • 100 or more selling transactions per year
  • Shipment tracking information provided to buyer within handling time for at least 90 percent of their listings


If this flag is returned for a listing, it indicates that the listing meets the new requirements for a Top-Rated Listing. A Top-Rated Listing must meet the following requirements:
  • 14-day (or longer) return policy with Money Back option
  • 1-day Handling Time or better


A new Top-Rated Plus seal will start appearing on the View Item page for all Top-Rated Listings beginning in November 2012. This seal will replace the Top-Rated Seller badge. US Top-Rated Sellers get a 20 percent discount on their FVF for all listings that qualify as Top-Rated Listings.
See the Field Index to learn which calls use TopRatedListing.

UnitInfo ( UnitInfoType ) [0..1]
Contains information about the weight, volume or other quantity measurement of a listed item so buyers can compare per-unit prices. The European Union requires listings for certain types of products to include the price per unit. eBay uses this information and the item's listed price to calculate and display the unit price on eBay EU sites.

Note: This information is currently required only for business sellers, and only for listings with a Buy It Now option.
See the Field Index to learn which calls use UnitInfo.

Variations ( VariationsType ) [0..1]
Variations are multiple similar (but not identical) items in a single fixed-price (or Store Inventory Format) listing. For example, a single listing could contain multiple items of the same brand and model that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation can have its own quantity and price. Only returned if the listing contains multiple variations.
See the Field Index to learn which calls use Variations.

VhrAvailable ( boolean ) [0..1]
If true, the eBay Motors item has a Vehicle History Report associated with it.
See the Field Index to learn which calls use VhrAvailable.

VhrUrl ( anyURI ) [0..1]
The URL to the eBay Motors item's full Vehicle History Report. Only returned when the item has a Vehicle History Report.
See the Field Index to learn which calls use VhrUrl.

ViewItemURLForNaturalSearch ( anyURI ) [1]
The URL to view this listing on eBay. This URL is optimized to support natural search. That is, this URL is designed to make items on eBay easier to find via popular Internet search engines. For example, this URL specifies the item title, and it is optimized for natural search: "_W0QQ" is like "?" (question mark), "QQ" is like "&" (ampersand), and "Z" is like "=" (equals sign). You shouldn't modify the query syntax in your application. For example, eBay won't recognize the URL if you change QQ to ?.
See the Field Index to learn which calls use ViewItemURLForNaturalSearch.

WatchCount ( int ) [1]
Number of users who have placed the item on their Watch list.
See the Field Index to learn which calls use WatchCount.

Copyright © 2006–2013 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.