eBay Merchant Data APIVersion 1255
 

ListingDetailsType

Various details about a listing. Some of the details are calculated or derived after an item is listed. The details in this type include the start and end time and the converted (localized) prices. The details in this type also include input values applicable to the Best Offer feature. Additional details in this type include flags indicating if a seller specified fields whose values are not visible to the requesting user.

Type that uses ListingDetailsType:

Calls that use ListingDetailsType:

Fields



Adult ( boolean ) [0..1]
Not used by any call.

If true, the item is listed in a Mature category. Users must accept the Mature Category agreement on the eBay site to retrieve items listed in Mature categories. (Users do not need to sign this agreement to be able to list items in Mature Categories.)
See the Field Index to learn which calls use Adult.

BestOfferAutoAcceptPrice ( AmountType (double) ) [0..1]
The price at which Best Offers are automatically accepted. Similar in use to MinimumBestOfferPrice. If a buyer submits a Best Offer that is at or above this value, the offer is automatically accepted by the seller. This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature.

For this setting to have an effect, the Best Offer feature must be enabled for the listing, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response.

For Revise and Relist calls: If a seller wanted to disable the Best Offer Auto-Accept and/or Best Offer Auto-Reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following:
 Item.ListingDetails.BestOfferAutoAcceptPrice 
See the Field Index to learn which calls use BestOfferAutoAcceptPrice.

BindingAuction ( boolean ) [0..1]
Not used by any call.

Applicable for Real Estate auctions only. If true, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest.
See the Field Index to learn which calls use BindingAuction.

BuyItNowAvailable ( boolean ) [0..1]
Not used by any call.

Indicates whether the Buy It Now feature is available for an auction listing. As a general rule, once an auction listing has bids (and the high bid exceeds the reserve price, if any), the Buy It Now feature becomes disabled for the listing.
See the Field Index to learn which calls use BuyItNowAvailable.

CheckoutEnabled ( boolean ) [0..1]
Not used by any call.

Indicates whether or not the seller's Checkout Enabled preference is turned on.
Note: A 'Checkout Enabled' setting is no longer available to sellers, and this field is always returned as true.
See the Field Index to learn which calls use CheckoutEnabled.

ConvertedBuyItNowPrice ( AmountType (double) ) [0..1]
Not used by any call.

Converted value of the BuyItNowPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.
See the Field Index to learn which calls use ConvertedBuyItNowPrice.

ConvertedReservePrice ( AmountType (double) ) [0..1]
Not used by any call.

Converted value of the ReservePrice in the currency of the site that returned this response. Only returned for listings with a reserve price when the requesting user is the listing's seller. For active items, refresh this value every 24 hours to pick up the current conversion rates. Not applicable to Fixed Price listings.
See the Field Index to learn which calls use ConvertedReservePrice.

ConvertedStartPrice ( AmountType (double) ) [0..1]
Not used by any call.

Converted value of the StartPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.

In multi-variation listings, this value matches the lowest-priced variation that is still available for sale.
See the Field Index to learn which calls use ConvertedStartPrice.

EndingReason ( EndReasonCodeType ) [0..1]
Not used by any call.

This field is only returned if the item was ended early (before listing duration expired) by the seller (through an API call or on the Web site) or ended administratively by eBay. The value in this field indicates the seller's reason for ending the listing early.
See the Field Index to learn which calls use EndingReason.

EndTime ( dateTime ) [0..1]
Not used by any call.

Time stamp (in GMT) when the listing is scheduled to end (calculated based on the values of StartTime and ListingDuration ) or the actual end time if the item has ended.
See the Field Index to learn which calls use EndTime.

HasPublicMessages ( boolean ) [0..1]
Not used by any call.

Indicates whether the item has any publicly displayed messages. Use GetMemberMessages to retrieve public messages for the item if this flag indicates that there are any.
See the Field Index to learn which calls use HasPublicMessages.

HasReservePrice ( boolean ) [0..1]
Not used by any call.

If true, the seller specified a value in ReservePrice.
See the Field Index to learn which calls use HasReservePrice.

HasUnansweredQuestions ( boolean ) [0..1]
Not used by any call.

Indicates whether the item has any unanswered questions. Use GetMemberMessages to retrieve unanswered questions for the item if this flag indicates that there are any.
See the Field Index to learn which calls use HasUnansweredQuestions.

LocalListingDistance ( string ) [0..1]
This field is needed if the seller is selling a motor vehicle through a Motors Local Listing. The string value supplied in this field actually sets the radius of the area (in miles) in which the vehicle will be available and exposed to interested local buyers. The seller's supplied PostalCode or Location field value will be used as the center point for this radius.

There is a closed set of radius values that can be set in this field, and it depends on the seller's subscription level. The user can call GetCategoryFeatures, including LocalListingDistances as a FeatureID value to retrieve the local listing distances supported by a given site, category, and Local Market subscription level.
See the Field Index to learn which calls use LocalListingDistance.

MinimumBestOfferMessage ( string ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use MinimumBestOfferMessage.

MinimumBestOfferPrice ( AmountType (double) ) [0..1]
Specifies the minimum acceptable Best Offer price. If a buyer submits a Best Offer that is below this value, the offer is automatically declined. This applies only to items listed in categories that support the Best Offer auto-decline feature.

In order for this setting to have an effect, Best Offer must be enabled for the listing, and this value will only be exposed to the seller who listed the item.

For Revise and Relist calls: If a seller wanted to disable the Best Offer auto-accept and/or Best Offer auto-reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following:
 Item.ListingDetails.MinimumBestOfferPrice 

Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing. As of January 2019, the value set in this field for an auction listing can be more than the auction start price.
See the Field Index to learn which calls use MinimumBestOfferPrice.

PayPerLeadEnabled ( boolean ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use PayPerLeadEnabled.

RelistedItemID ( ItemIDType (string) ) [0..1]
Not used by any call.

Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new item is added to the old listing, so buyers can navigate to the new listing. This value only appears when the old listing is retrieved. The RelistedItemID of the original item will reflect the last relist.
See the Field Index to learn which calls use RelistedItemID.

SecondChanceOriginalItemID ( ItemIDType (string) ) [0..1]
Not used by any call.

The item ID for the original listing from which a second chance offer is made. This value is only returned when the data for the second chance offer listing is retrieved. Output only.
See the Field Index to learn which calls use SecondChanceOriginalItemID.

SellerBusinessType ( SellerBusinessCodeType ) [0..1]
Not used by any call.

Type of seller account. This value is not returned for most sites. This value is not returned for the German site (site ID 77) or US eBay Motors site (site ID 0).
See the Field Index to learn which calls use SellerBusinessType.

StartTime ( dateTime ) [0..1]
Not used by any call.

The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed.
See the Field Index to learn which calls use StartTime.

TCROriginalItemID ( ItemIDType (string) ) [0..1]
Not used by any call.

Indicates the item ID of the original item listing from which a Transaction Confirmation Request (TCR) was created. This value is only returned when the data for a TCR is retrieved.
See the Field Index to learn which calls use TCROriginalItemID.

ViewItemURL ( anyURI ) [0..1]
Not used by any call.

The URL of the Web page where a user can view the listing. On the US site, this is called the View Item page. If you enabled affiliate tracking in a search-related call (for example, if you used the AffiliateTrackingDetails container in an applicable call), ViewItemURL contains a string that includes affiliate tracking information (see the eBay Partner Network).
See the Field Index to learn which calls use ViewItemURL.

ViewItemURLForNaturalSearch ( anyURI ) [0..1]
Not used by any call.

This URL takes you to the same View Item page as ViewItemURL, but 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. The URL includes the item title along with other optimizations. To note, "?" (question mark) optimizes to "_W0QQ", "&" (ampersand) optimizes to "QQ", and "=" (equals sign) optimizes to "Z".

If you are an eBay affiliate, use this URL to promote your affiliate information.

Note: This URL may include additional query parameters that don't appear in ViewItemURL and vice versa. You should not modify the query syntax. For example, eBay won't recognize the URL if you change QQ to ?.
See the Field Index to learn which calls use ViewItemURLForNaturalSearch.