eBay Trading APIVersion 1349
 

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 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 and categories except for motor vehicle listings on eBay Motors US, and on the eBay UK and eBay Italy sites. 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.
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.
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_3 This value is used to set the duration of the listing to three days.
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_5 This value is used to set the duration of the listing to five days.
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.
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 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: As of April 1, 2019, GTC (Good 'Til Cancelled) 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. 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.
Note: On July 1, 2019, the Good 'Til Cancelled renewal schedule was modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the Good 'Til Cancelled listings update in the Spring 2019 Seller Updates for more information about this change.
  * See the Enumeration Index to see exact use of each enumeration value in the API.