eBay Trading APIVersion 1101

ListingDurationCodeType ( token )

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 may 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.

Note: As of April 1, 2019, GTC (Good 'Til Cancelled) is the only supported listing duration for fixed-price listings on all eBay marketplaces except for the eBay Canada sites (English and French versions), which are delaying this change until later in 2019. Motor vehicle listings on eBay Motors US and on the eBay UK and eBay Italy sites are also exempt from this change. Sellers do not have to take any action on existing listings with listing durations other than GTC, but if/when these items need to be relisted, only GTC will be supported. If any other listing duration value besides GTC is specified in this field, it will be ignored, and GTC will be used instead.

No calls use ListingDurationCodeType.

Enumeration Values

Value Description
CustomCode This value is reserved for internal or future use.
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_10 This value is used to set the duration of the listing to 10 days.

A 10-day listing duration is applicable to most listing types.
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.
Days_14 This value is used to set the duration of the listing to 14 days.

A 14-day listing duration is typically only applicable to Classified Ad listings in specific categories.
Days_21 This value is used to set the duration of the listing to 21 days.

A 21-day listing duration is typically only applicable to eBay Motors Local Market vehicle listings, a listing type that is only available to eBay Motors Dealers.

Note: This value is scheduled to be wired off for eBay Motors Local Listings, and Motors sellers can start using a 30-day listing duration instead (Days_30).
Days_3 This value is used to set the duration of the listing to three days.

A three-day listing duration is applicable to most listing types.
Days_30 This value is used to set the duration of the listing to 30 days.

A 30-day listing duration is typically available for fixed-price listing, Classified Ad listings, and Real Estate auction listings.

Note: As of October 2018, this value was enabled for eBay Motors Local Listings, and the Days_21 enumeration value will get wired off for eBay Motors Local Listings.
Days_5 This value is used to set the duration of the listing to five days.

A five-day listing duration is applicable to most listing types.
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_7 This value is used to set the duration of the listing to seven days.

A seven-day listing duration is applicable to most listing types.
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.
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 every 30 days 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: As of February 19, 2019, GTC (Good 'Til Cancelled) is the only supported listing duration for fixed-price listings on the eBay Australia marketplace. Sellers on the eBay Australia marketplace will not have to take any action on existing listings with listing durations other than GTC, but if/when these items need to be relisted, only GTC will be supported. This listing duration change for fixed-price listings will eventually roll out globally. Around March 18, 2019, this change will roll out to most categories on the North America sites (US/CA) and Asia sites. Around April 1, 2019, this change will roll out to all categories on all Europe sites, except for the Cars, Motorcycles and Vehicles category (Category ID 9800) on the UK and Italy marketplaces.
  * See the Enumeration Index to see exact use of each enumeration value in the API.