Complex type that is used to express the details of an eBay listing.
Types that use SimpleItemType:
Calls that use SimpleItemType:
true
, immediate payment is required before the checkout process can begin. If false
, immediate payment is not requested. true
value) in the following types of listings/transactions: PayPal
. For sellers, opted into the new eBay Managed Payments program, the supported payment methods are managed by eBay, so no payment methods may get returned.
true
, the order line item is enabled with the 'Click and Collect' feature. With Click and Collect, buyers are able to purchase an order line item on the eBay UK, Australia, and Germany sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. true
value in the PickupDropOffEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request).
true
. With the Buy It Now feature, interested buyers have the option of bypassing the auction procedure, and purchasing the item immediately at the price shown in the BuyItNowPrice field (or in the ConvertedBuyItNowPrice field for international buyers. true
. 1000
typically indicates an item in new condtion, but the text displayed in the ConditionDisplayName can be just New, or some categories will show Brand New, New with tags, or New with box. 1000
indicates an item in New condition, 3000
indicates an item in Used condition, and 5000
indicates an item in Good condition. true
. Variations
, the ConvertedCurrentPrice field is still returned, but its value will reflect the lowest-priced item variation. So, if the multiple-variation listing has item variations priced from 7.99 to 12.99, the ConvertedCurrentPrice field's value will show '7.99'. If the price of all item variations are the same, the ConvertedCurrentPrice field value will be accurate, but it is recommended that the user scan down to individual Variation.StartPrice fields to get the accurate price for all item variations.
Details
. Alternatively, the user can view the ConvertedCurrentPrice field, as this field shows the price in the currency of the user's country, and it is always returned. Variations
, the CurrentPrice is not returned, but the ConvertedCurrentPrice field is returned, but its value will reflect the lowest-priced item variation. So, if the multiple-variation listing has item variations priced from 7.99 to 12.99, the ConvertedCurrentPrice field's value will show '7.99'. If the price of all item variations are the same, the ConvertedCurrentPrice field value will be accurate, but it is recommended that the user scan down to individual Variation.StartPrice fields to get the accurate price for all item variations.
TextDescription
or Description
. If the Description
value is used, the full description is returned, with all HTML, XML, or CSS markup used in the listing (if any) by the seller. To only view the actual text of the listing description (no markup tags), the TextDescription
value shall be used instead.
true
if the listing category supports 'Click and Collect' listings. A true
value does not necessarily mean that the seller has enabled the item with the Click and Collect feature. A listing is enabled with the Click and Collect feature if the AvailableForPickupDropOff field is returned as true
. true
) if an eBay Germany motor vehicle listing has an upgrade that allows the motor vehicle listing to appear on the mobile.de partner site. This field is only applicable to eBay Germany motor vehicle listings.
true
if eBay's Global Shipping Program is an option for international shipping. With eBay's Global Shipping Program, the seller ships the item to that country's eBay shipping partner, and then eBay's shipping partner handles all aspects of the international leg of the shipment, including any export or import charges. false
, the seller is responsible for specifying one or more international shipping service options to serve those countries that the seller is willing to ship items.
0
indicates same business day handling for an item. In this case, the seller's shipping commitment depends on the order cut off time set in the seller's My eBay Shipping preferences. The buyer must purchase and pay for the order line item before this order cut off time in order for the seller to be obligated to ship out the order on that same business day. A different cutoff time can be specified for each business day of the week. By default, the order cut off time is set to 2:00 PM local time on most sites, but the seller can change the times for any of the business days. For orders completed after the order cut off time, the item must be shipped by the end of the following business day (weekends and local holidays excluded).
Details
. The high bidder details include the bidder's eBay user ID and Feedback Score. For the GetItemStatus call, only the eBay user ID is returned. true
) in the case where an order line item in a listing is only available to buyers through a local fulfillment method such as In-Store Pickup or Click and Collect. And if a listing is truly a local fulfillment only listing, the value in the Item.Quantity field (for single-variation listings) or the Variation.Quantity field (for multi-variation listings) defaults to 0
even though the quantity available is technically not zero, since the order line item in the listing is still available through one or more local fulfillment methods.
true
, then integrated merchant credit card (IMCC) is enabled for credit cards because the seller has a payment gateway account. Therefore, if IntegratedMerchantCreditCardEnabled is true
, an AmEx, Discover, or VisaMC is returned for an item, then on checkout, an online credit-card payment is processed through a payment gateway account. A payment gateway account is used by sellers to accept online credit cards (Visa, MasterCard, American Express, and Discover). Compatibility
. Parts Compatibility is only supported in Parts & Accessories categories.
Compatibility
. Parts Compatibility is only supported in Parts & Accessories categories.
Publication Year=2017
and Format=Hardcover
. A motor vehicle's Item Specifics name-value pairs might include Make= Toyota
, Model=Prius
, and Year=2017
. An event listing's Item Specifics name-value pairs might include Event Type=Concert
and Venue Name=The Fillmore
. ItemSpecifics
. Most eBay listings will include at least a few Item Specifics.
true
) that are returned in the response.
951**
.
6000:6001:6016:6444
1
, but a fixed-price listing can have multiple quantity of an item. Variations
. In this particular case, the (listing-level) Quantity field is not returned, and instead, the user will look at the Variation.Quantity and Variation.SellingStatus.QuantitySold fields to get the quantity available for each item variation in the listing. If the user retrieves a multiple-variation listing, but does not set the IncludeSelector filter to Variations
, the listing-level Quantity and QuantitySold fields are returned, and these fields' values will be the cumulative values of all item variations in the listing. Details
, this field is always returned even if its value is '0'. Details
, but the retrieved listing is a multiple-variation listing, the Quantity and QuantitySold field values will reflect the quantity and quantity sold of all item variations in the listing. If a user wanted quantity available and quantity sold information on individual item variations, that user would set the IncludeSelector filter to Variations
instead, and the user will look at the Variation.Quantity and Variation.SellingStatus.QuantitySold fields to get the quantity available for each item variation in the listing.
Details
, this field is always returned even if its value is '0'. Details
, but the retrieved listing is a multiple-variation listing, the Quantity, the QuantitySoldByPickupInStore, and QuantitySold field values will reflect the quantity and quantity sold of all item variations in the listing. If a user wanted quantity available and quantity sold information on individual item variations, that user would set the IncludeSelector filter to Variations
instead, and the user will look at the Variation.SellingStatus.QuantitySoldByPickupInStore fields to get the quantity sold for each item variation in the listing through the In-Store Pickup option. ReturnsNotAccepted
. If a seller does accept returns, more details are returned, including the return period, the refund method, and the order partner (buyer or seller) who is responsible for return shipping costs. This container is only returned if the IncludeSelector field is included in the call request and set to Details
. Details
.
Africa
, Asia
, Caribbean
, or MiddleEast
, all the way down to the state/province level and even cities within those state/provinces. A user will be able to see the international and domestic shipping regions that can be set by looking at the Shipping rate tables UI in My eBay. The Trading API's GeteBayDetails can also be used to view available shipping locations. US
. If a US seller is willing to ship to any location in the world, the only ShipToLocations value that should be returned is Worldwide
US
. If it's listed on the eBay Germany site, the value would be Germany
.
Details
. For multi-variation listings, the SKU value for each variation (if defined) will actually be returned in the Variation.SKU field, and to return variations data, the user must include the IncludeSelector field and set it to Variations
.
Details
.
Details
.
Completed
state. A completed/ended listing will essentially have 0 seconds left, so the Completed value will be PT0S
, which indicates '0 seconds' left.
true
if the listing was created by a Top-Rated Seller and the listing has all of the requirements that qualifies it as a Top-Rated Plus listing. The Top-Rated Seller program is only available on the US, UK, and Germany sites. See the Top-Rated Seller requirements help topic for more information on qualifying as a Top-Rated Seller and the Top-Rated Plus listing requirements help topic for more information on what a listing must offer to qualify as a Top-Rated Plus listing and get the Top-Rated Plus badge. Information on the overall program can be found on the Top-Rated Seller home page in the Seller Center. false
.
Variations
. Multiple-variation listings are fixed-price listings that feature similar, but not identicial items. For example, a T-shirt listing could contain multiple items of the same brand and style that vary by color and size (like Blue, Large
and Black, Medium
). Each variation in the listing specifies a unique combination of one of the available colors and sizes. Each variation can have a different quantity and price.
true
if a Vehicle History Report is available for a motor vehicle listing. This field is only applicable to motor vehicle listings with a Vehicle History Report avaialable. The URL to the Vehicle History Report can be found in the VhrUrl field.
Copyright © 2006–2021 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.