eBay Trading API
Version 1359


simpleType "ListingDurationCodeType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Derived By:
restriction of token
Defined:
in ebaySvc.wsdl/Schema
Referenced:
never
Simple Content Model
enumeration of token
Simple Content Restrictions:
Enumeration:
"Days_1"
 - 
This value is used to set the duration of the listing to one day. A one-day listing duration is typically only available to sellers with a Feedback score of 10 or higher, so sellers with a Feedback score of less than 10 may be restricted from using a one-day listing duration. The seller can call GetCategoryFeatures with ListingDurations included as a FeatureID value in the call request to see if the one-day listing duration is available.

A one-day listing duration is generally applicable to an auction listing or to a Real Estate Classified Ad.
"Days_3"
 - 
This value is used to set the duration of the listing to three days.
"Days_5"
 - 
This value is used to set the duration of the listing to five days.
"Days_7"
 - 
This value is used to set the duration of the listing to seven days.
"Days_10"
 - 
This value is used to set the duration of the listing to 10 days.
"Days_14"
 - 
This value is used to set the duration of the listing to 14 days.
"Days_21"
 - 
This value is used to set the duration of the listing to 21 days.

Note: A 21-day listing duration was typically only applicable to eBay Motors Local Market vehicle listings, but this listing duration is no longer valid/supported.
"Days_30"
 - 
This value is used to set the duration of the listing to 30 days.

Note: In October 2018, this listing duration was enabled for eBay Motors Local Listings, and replaced the formerly supported Days_21 enumeration value.
"Days_60"
 - 
This value is used to set the duration of the listing to 60 days.

A 60-day listing duration is typically only applicable to Classified Ad listings in specific categories.
"Days_90"
 - 
This value is used to set the duration of the listing to 90 days.

A 90-day listing duration is generally only applicable to a Real Estate Classified Ad.
"Days_120"
 - 
This value is used to set the duration of the listing to 120 days.

An 120-day listing duration is typically only applicable to Classified Ad listings in specific categories.
"GTC"
 - 
This value is used to set the duration of the listing to 'Good 'Til Cancelled. This option is available for fixed-price and Classified Ad listings. "Good 'Til Cancelled" fixed-price listings will be relisted automatically each month until all inventory is sold out (e.g., Item.Quantity=0 in a single-variation fixed-price listing, or all occurences of Item.Variations.Variation.Quantity=0 in a multi-variation fixed-price listing), or the seller ends the fixed-price listing.

Note: The GTC (Good 'Til Cancelled) value is the only supported listing duration for fixed-price listings on all eBay marketplaces and categories except for motor vehicle listings on eBay Motors US, and on the eBay UK and eBay Italy sites.
Note: As long as a fixed-price listing has inventory available, or if the out-of-stock control feature is being used, GTC listings are automatically renewed each month according to the calendar day.
"CustomCode"
 - 
This value is reserved for internal or future use.
Description
This enumerated type contains the list of values that can be used by the seller to set the duration (number of days or Good 'Til Cancelled) of a listing.

Listing durations available to the seller vary based on the site, category, listing type, and the seller's selling profile, so it is a best practice for the seller to call GetCategoryFeatures with ListingDurations included as a FeatureID value in the call request. The GetCategoryFeatures response will include the complete list of listing duration values that can be used for the various listing types.
Type Definition Detail
Type Derivation Tree
token (restriction)
  ListingDurationCodeType


WSDL documentation generated with FlexDoc/XML 1.14 using FlexDoc/XML WSDLDoc 2.0 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.