Response Fields

Valuation fields

Field	Type	Description
deviceId	string	Normalized device identifier (SKU format)
displayName	string	Human-readable device name
currentValuation.fair	number	Conservative estimate (USD)
currentValuation.good	number	Mid-market value (USD) — the primary price point
currentValuation.excellent	number	Best-case value (USD)
msrp	number	Original retail price (USD)
residualPct	number	Percentage of MSRP retained (good / msrp × 100)
valueTier	string	Overall value retention category
currency	string	Always USD
confidence	string	Data quality indicator
validUntil	string	ISO 8601 timestamp — pricing freshness

Value tiers

Tier	Meaning
Peak	Retains exceptional value relative to MSRP
Strong	Above-average value retention
Moderate	Average depreciation curve
Low	Below-average value retention

Depreciation

The depreciation object provides forward-looking insights:

Field	Type	Values	Description
trend	string	stable, increasing, decreasing	Price direction over recent snapshots
projection.months	integer	—	Projection horizon
projection.fair	number	—	Projected fair value
projection.good	number	—	Projected good value
projection.excellent	number	—	Projected excellent value
refreshSignal	string	hold, considerRefreshing, refreshNow	Trade-in timing guidance
confidence	string	high, medium, low	Projection confidence

Refresh signals

• hold — the device retains strong value; no urgency to trade in
• considerRefreshing — approaching the optimal trade-in window; start planning
• refreshNow — past the optimal trade-in window; value is declining faster than average

Batch-specific fields

In batch responses, each device also includes:

Field	Type	Description
quantity	integer	Number of units (after deduplication and quantity summing)