Single Device Lookup | Trust Trade

`GET /devices/{id}`

Look up a single device by identifier. All lookups are case-insensitive. Costs 1 credit.

Path parameter

Name	Type	Description
`id`	string	Device identifier (SKU, Apple model ID, or MDM identifier)

Example request

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.trusttrade.com/v1/devices/MBA-M2-256-8GB

Example response

{
  "deviceId": "MBA-M2-256-8GB",
  "displayName": "MacBook Air 13\" M2 256GB 8GB",
  "currentValuation": {
    "fair": 475,
    "good": 500,
    "excellent": 525
  },
  "msrp": 1199,
  "residualPct": 41.7,
  "valueTier": "Strong",
  "depreciation": {
    "trend": "decreasing",
    "projection": {
      "months": 12,
      "fair": 402,
      "good": 425,
      "excellent": 447
    },
    "refreshSignal": "hold",
    "confidence": "high"
  },
  "currency": "USD",
  "confidence": "high",
  "validUntil": "2026-03-30T09:00:00Z"
}

Caching

Responses include Cache-Control: public, max-age=86400 (24 hours). Pricing data is refreshed daily.

Errors

Status	Code	Description
401	`unauthorized` / `invalid_api_key`	Missing or invalid API key
402	`insufficient_credits`	No credits remaining
404	`not_found`	Device not in catalog
429	`rate_limited`	Rate limit exceeded
503	`service_unavailable`	Pricing data temporarily unavailable

See response fields for a detailed breakdown of each field.