---
id: "item_condition"
kind: "datatype"
status: "draft"
is_pii: false
name: "Condition of an item for sale (New, Used, Refurbished)"
categories: ["ecommerce"]
langs: ["en", "de", "fr", "es", "it", "nl", "pt", "pl"]
quality: 70
url: "https://registry.apicrafter.io/datatype/item_condition"
---

# Condition of an item for sale (New, Used, Refurbished) (`item_condition`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Condition of a product, vehicle, part or collectible that is offered for sale: New, Used, Refurbished, Like New, Pre-Owned, Open Box, NOS (new old stock), the grades of used goods of marketplaces (Used - Good, For parts or not working) and the same in other languages (Gebraucht, Occasion, Usado). The values of the schema.org enumeration OfferItemCondition (NewCondition, UsedCondition, RefurbishedCondition, DamagedCondition) mark it up in product pages. Ratings of the state of an asset (Good, Fair, Poor) are another type.

- Parent datatype: [`category`](https://registry.apicrafter.io/datatype/category.md)
- Personal data (PII): no
- Categories: E-commerce (ecommerce)
- Countries: global
- Languages: English (en), German (de), French (fr), Spanish (es), Italian (it), Dutch (nl), Portuguese (pt), Polish (pl)
- Classification: categorical

## Examples

- `New`
- `Used`
- `Refurbished`
- `Pre-Owned`
- `NOS` — new old stock
- `UsedCondition` — schema.org
- `Fair` (invalid example) — a condition rating

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `itemconditionbyname` (field, `common/ecommerce.yaml`)
- `itemconditionvalue` (data, `common/ecommerce.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Состояние товара (новый, б/у, восстановленный)

## Sources

- schema.org: <https://schema.org/OfferItemCondition>
- schema.org: <https://schema.org/itemCondition>

## Quality

Score 70/100. Missing: regexp, mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/item_condition.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/ecommerce/item_condition.yaml>
