lifecycle

Represents the offer and how it changes over time. Enables the user to make informed decisions about the long-term usability of the offer.

Required
No
Expected Type
Object

stage

Description

Indicates the offer's current lifecycle phase. Enables better offer filtering and purchase decisions based on the status of the offer.

Guideline

Use the enumerated values.

Enumerated Values

  • new — Unused item in original, factory-issued condition
  • refurbished — Professionally restored to full functionality
  • used — Previously owned and shows signs of prior use
  • approved — Returned item opened but unused and verified
Required
No
Expected Type
String

estimated_lifespan

Description

Provides an estimate of how long the offer is expected to remain functional under normal use. Helps with offer comparisons and customer expectations.

Guideline

Numeric value or threshold followed by a time unit.

Required
No
Expected Type
String

Correct Example

JSON
"estimated_lifespan": "5 years"

Incorrect Example

JSON
"estimated_lifespan": "5"

estimated_maintenance

Description

Outlines the recommended maintenance steps or frequency required to keep the offer in functional condition. Enables users to plan care routines accordingly.

Guideline

Use clear present-tense instructions. Avoid verbosity.

Required
No
Expected Type
Array<String>

Correct Example

JSON
"estimated_maintenance": ["clean filters monthly"]

Incorrect Example

JSON
"estimated_maintenance": ["we advise you clean the filters once a month"]

estimated_ownership_cost

Description

Summarizes the presumed total cost associated with owning and operating the offer over its expected lifespan. Helps users make informed decisions beyond the initial purchase price.

Guideline

Clear and not verbose. Use "/" to represent per.

Required
No
Expected Type
Array<String>

Correct Example

JSON
"estimated_ownership_cost": ["£150/month fuel"]

Incorrect Example

JSON
"estimated_ownership_cost": ["Fuel cost estimated at £150 per month"]

discontinued_on

Description

Specifies the official date after which the offer is no longer manufactured or actively sold by the producer. Enables planning around long-term viability.

Guideline

Use the ISO 8601 date format. Can be in the future or past.

Required
No
Expected Type
String

Correct Example

JSON
"discontinued_on": "2025-06-24"

Incorrect Example

JSON
"discontinued_on": "10/06/2025"

repairability

Description

Indicates how easily the offer can be repaired if faulty. Enables users to assess potential of repairing the offer.

Guideline

Use the enumerated values.

Enumerated Values

  • easy — Can be fixed with basic tools and guidance
  • moderate — Needs some skill or special parts
  • hard — Hard to fix due to complexity or design
  • not — Repair not possible or practical
Required
No
Expected Type
String

carbon_footprint

Description

Represents the estimated total carbon emissions generated by the offer over its full lifecycle. Enables more sustainable purchasing choices.

Guideline

Grams or kilograms of CO₂e.

Required
No
Expected Type
String

Correct Example

JSON
"carbon_footprint": "12.3kg CO₂e"

Incorrect Example

JSON
"carbon_footprint": "12.3kg"