eBay Trading APIVersion 997

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.)
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 above this value, the offer is automatically accepted by the seller. This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature.

Best Offer must be enabled for the item, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response. On the US eBay Motors site (site ID 0), you cannot use the API to add a minimum Best Offer price. For a ReviseItem call on US eBay Motors, prior use of a minimum Best Offer price on eBay.com is ignored.

If the price for a fixed-price item (set in the StartPrice field) is changed with a Revise call, the BestOfferAutoAcceptPrice and MinimumBestOfferPrice values will be dropped (if they were set for the listing before the Revise call). If the seller wanted to reintroduce either of these Best Offer threshold values in the listing again, an additional Revise call would have to be made, passing in the desired threshold values.
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.
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 (at account level or at listing level). This preference is managed through Payment Preferences in My eBay. If this preference is enabled, a Pay Now button will appear in checkout flow pages and in the email notifications that are sent to buyers. This preferance is enabled by default if PayPal is one of the payment methods.
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.
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.
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.
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). 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.
See the Field Index to learn which calls use HasPublicMessages.

HasReservePrice ( boolean ) [0..1]
If true, the seller specified a value in ReservePrice.
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]
Specifies a distance (in miles) used as the radius of the area about the supplied postal code that constitutes the local market.

Use GetCategoryFeatures to determine 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 by the seller. This applies only to items listed in categories that support the Best Offer Auto-Decline feature.

Best Offer must be enabled for the item, and only the seller who listed the item can see this value. For a ReviseItem or ReviseFixedPriceItem call on US eBay Motors site, prior use of a minimum Best Offer price on eBay.com is ignored.

To remove this value when revising or relisting an item, use DeletedField.

If the price for a fixed-price item (set in the StartPrice field) is changed with a Revise call, the MinimumBestOfferPrice and BestOfferAutoAcceptPrice values will be dropped (if they were set for the listing before the Revise call). If the seller wanted to reintroduce either of these Best Offer threshold values in the listing again, an additional Revise call would have to be made, passing in the desired threshold values.
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.
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.
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).
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 ?.
See the Field Index to learn which calls use ViewItemURLForNaturalSearch.