eBay Trading APIVersion 1349
 

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]
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.)
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
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]
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.
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use BindingAuction.

BuyItNowAvailable ( boolean ) [0..1]
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]
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. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use CheckoutEnabled.

ConvertedBuyItNowPrice ( AmountType (double) ) [0..1]

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.
Note: The ListingDetails.ConvertedBuyItNowPrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024.
See the Field Index to learn which calls use ConvertedBuyItNowPrice.

ConvertedReservePrice ( AmountType (double) ) [0..1]

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.
Note: The ListingDetails.ConvertedReservePrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024.
See the Field Index to learn which calls use ConvertedReservePrice.

ConvertedStartPrice ( AmountType (double) ) [0..1]

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.
Note: The ListingDetails.ConvertedStartPrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024.
See the Field Index to learn which calls use ConvertedStartPrice.

EndingReason ( EndReasonCodeType ) [0..1]
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]
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]
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.
Note: The HasPublicMessages field will stop being returned in GetItemTransactions and GetSellerTransactions, on January 31, 2024.
See the Field Index to learn which calls use HasPublicMessages.

HasReservePrice ( boolean ) [0..1]
If true, the seller specified a value in ReservePrice.
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use HasReservePrice.

HasUnansweredQuestions ( boolean ) [0..1]
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. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
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]
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.
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use RelistedItemID.

SecondChanceOriginalItemID ( ItemIDType (string) ) [0..1]
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]
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]
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.
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use TCROriginalItemID.

ViewItemURL ( anyURI ) [0..1]
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).
Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use ViewItemURL.

ViewItemURLForNaturalSearch ( anyURI ) [0..1]
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 ?. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024.
See the Field Index to learn which calls use ViewItemURLForNaturalSearch.