Finding API

Item Condition IDs and Names

Condition Definitions
Condition Display Names by Category

Condition Definitions

We consistently use the same IDs for similar condition qualities (across all sites and categories). For example, 1000 is always used for brand new items in their original retail packaging (or equivalent).

The display names and the subset of supported conditions can vary in different categories (see Condition Display Names by Category).

The table below summarizes the typical definition of each condition.

Also, buyers should always check the seller's item description in case the seller provided more details about the condition of the item.

ID Typical Name Typical Definition
1000 New A brand-new, unused, unopened, unworn, undamaged item. Most categories support this condition (as long as condition is an applicable concept).
1500 New other (see details) A brand-new new, unused item with no signs of wear. Packaging may be missing or opened. The item may be a factory second or have defects.
1750 New with defects A brand-new, unused, and unworn item. The item may have cosmetic defects, and/or may contain mismarked tags (e.g., incorrect size tags from the manufacturer). Packaging may be missing or opened. The item may be a new factory second or irregular.
2000 Manufacturer refurbished An item in excellent condition that has been professionally restored to working order by a manufacturer or manufacturer-approved vendor. The item may or may not be in the original packaging.
2500 Seller refurbished An item that has been restored to working order by the eBay seller or a third party who is not approved by the manufacturer. This means the seller indicates that the item is in full working order and is in excellent condition. The item may or may not be in original packaging.
3000 Used An item that has been used previously. The item may have some signs of cosmetic wear, but is fully operational and functions as intended. This item may be a floor model or store return that has been used. Most categories support this condition (as long as condition is an applicable concept).
4000 Very Good An item that is used but still in very good condition. No obvious damage to the cover or jewel case. No missing or damaged pages or liner notes. The instructions (if applicable) are included in the box. May have very minimal identifying marks on the inside cover. Very minimal wear and tear.
5000 Good An item in used but good condition. May have minor external damage including scuffs, scratches, or cracks but no holes or tears. For books, liner notes, or instructions, the majority of pages have minimal damage or markings and no missing pages.
6000 Acceptable An item with obvious or significant wear, but still operational. For books, liner notes, or instructions, the item may have some damage to the cover but the integrity is still intact. Instructions and/or box may be missing. For books, possible writing in margins, etc., but no missing pages or anything that would compromise the legibility or understanding of the text.
7000 For parts or not working An item that does not function as intended and is not fully operational. This includes items that are defective in ways that render them difficult to use, items that require service or repair, or items missing essential components. Supported in categories where parts or unworking items are of interest to people who repair or collect related items.

For eBay's latest definitions, see the eBay end-user online help for your site. Here are a few example links to the help on some sites (most sites provide similar pages):

General Item Condition Definitions (for end users)
eBay US: http://pages.ebay.com/help/sell/item-condition.html
eBay Austria: http://pages.ebay.at/help/sell/item-condition.html
eBay Germany: http://pages.ebay.de/help/sell/item-condition.html
eBay Spain: http://pages.ebay.es/help/sell/item-condition.html
eBay UK: http://pages.ebay.co.uk/help/sell/item-condition.html

Item Condition Definition Look-Up Tables by Category (for end users)
eBay US: http://pages.ebay.com/sellerinformation/news/itemconditionlookup.html
eBay Austria: http://pages.ebay.at/sell/sellerupdate/june2010/dt_newcondval_DE_00.html
eBay Germany: http://pages.ebay.de/sell/sellerupdate/june2010/dt_newcondval_DE_00.html
eBay Spain: http://pages.ebay.es/sell/sellerupdate/june2010/dt_newcondval_ES_00.html
eBay UK: http://pages.ebay.co.uk/sell/sellerupdate/june2010/dt_newcondval_UK_00.html

Condition Display Names by Category (string )

Item conditions can vary across eBay categories and sites. This section summarizes the condition IDs that each top-level (meta) category typically supports.

Please note:

US (0)

ID Typical Name Display Name by Category
Cameras & Photo,
Cell Phones & PDAs,
Computer & Networking,
Electronics,
Business & Industrial,
Home & Garden,
Musical Instruments
Clothing & Accessories,
Jewelry & Watches
Shoes Underwear Collectibles,
Crafts,
Dolls & Bears,
Pet Supplies,
Toys & Hobbies
Books,
DVDs & Movies,
Music,
Video Games
Parts & Accessories Baby,
Health & Beauty,
Sporting Goods
Food,
Wine
1000 New New New with tags New with box New with tags New Brand new New New New
1500 New other (see details) New other (see details) New without tags New without box New without tags     New other (see details) New other (see details)  
1750 New with defects   New with defects New with defects New with defects          
2000 Manufacturer refurbished Manufacturer refurbished                
2500 Seller refurbished Seller refurbished           Re-manufactured    
3000 Used Used Pre-owned Pre-owned Pre-owned Used Like new Used    
4000 Very Good           Very Good      
5000 Good           Good Good    
6000 Acceptable           Acceptable Acceptable    
7000 For parts or not working For parts or not working           For parts or not working For parts or not working  

Other Sites

Other sites support the same IDs for similar categories. Details for other sites will be provided in an upcoming release of this documentation. You can also use GetCategoryFeatures in the Trading API to programmatically download details about the supported condition IDs per category and site.




User-Contributed Notes

 

Copyright © 2009–2014 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.