Product Condition

Understanding product condition values and their impact on pricing and warranty

The condition field describes the state of a product being offered for sale. Each pricing option returned from /catalog/detail has a unique condition—you won't see duplicate conditions within a single response.

---

Where Condition Appears

Endpoint	Field Location
/catalog/detail	options[].condition
Order confirmation	Line item details

The condition is locked in when you select a priceOptionId.

One option per condition

Each condition appears at most once in a catalog detail response. If a product is available as both "New OEM" and "Refurbished", you'll get two options with different conditions—never two options with the same condition.

---

Condition Values

These conditions appear in catalog detail responses:

Condition	Description
New OEM	Brand new from original equipment manufacturer
OEM Original	Original OEM part (may be older stock)
OEM Replacement	OEM-sourced replacement part
Refurbished	Restored to working condition with testing
Certified Refurbished	Refurbished with manufacturer certification
Aftermarket	Third-party manufactured compatible part
Tested	Used part verified to be functional
Not Tested	Used part without functional verification
Demo	Demonstration unit, typically lightly used
Open Box	New but opened, may have cosmetic imperfections

---

Example Response

{
  "options": [
    {
      "priceOptionId": "OPT-001",
      "condition": "New OEM",
      "price": 2500.00,
      "warranty": "24 Months"
    },
    {
      "priceOptionId": "OPT-002",
      "condition": "Refurbished",
      "price": 1250.00,
      "warranty": "12 Months"
    },
    {
      "priceOptionId": "OPT-003",
      "condition": "Aftermarket",
      "price": 850.00,
      "warranty": "6 Months"
    }
  ]
}

Each option represents a different condition available for this product. The user selects based on their preference for condition, price, and warranty.

---

Condition and Warranty

Each condition has its own price and warranty terms:

Condition determines the option

Since each condition appears only once, selecting a condition effectively selects the pricing option. Price and warranty are tied to that specific condition.

---

Best Practices

1. Display condition prominently - Users need this information to make purchasing decisions

2. Show warranty alongside condition - Warranty varies even when condition is the same

3. Handle all values - Your UI should gracefully display any condition string, including unexpected values

4. Consider filtering - Some organizations only allow certain conditions (e.g., "New OEM only" policies)

---

Related Concepts

• Price Option ID - The quote that locks in condition and price

• Required Fields - Additional information vendors may require

• Search to Order Cookbook - Complete ordering workflow