Lookup Inventory by IMEI
Use this endpoint to find a specific device by IMEI, serial number, or asset tag.
Prerequisites
- API key with scope
inventory:read - The IMEI or serial number to search for
Example
curl "https://api.spectradiag.com/api/v1/inventory/lookup?imei=354123456789012" \
-H "Authorization: Bearer spk_live_xxx"Response
{
"success": true,
"data": {
"id": 5421,
"imeiSerial": "354123456789012",
"assetId": "DEV-001234",
"manufacturer_name": "Apple",
"a_model": "iPhone 13",
"storage": "128GB",
"color": "Blue",
"carrier": "Unlocked",
"currentLetterCode": "B",
"status": 6,
"simLock": "Unlocked",
"fmipLock": "Unlocked",
"mdm": "Clean",
"battery": "94",
"batch_name": "Intake-2026-05-15"
}
}Getting full device details + history
For more info — photos, history log, full condition data — use the detail endpoint:
curl "https://api.spectradiag.com/api/v1/inventory/5421" \
-H "Authorization: Bearer spk_live_xxx"Updating a device
If your workflow involves inspecting or re-grading devices, you can PATCH updates:
curl -X PATCH "https://api.spectradiag.com/api/v1/inventory/5421" \
-H "Authorization: Bearer spk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": 6,
"currentLetterCode": "A",
"notes": "Minor scratches cleaned up, regraded A"
}'This fires an inventory.updated webhook.
Common status codes
| Status | Meaning |
|---|---|
| 0-4 | Pre-inspection (intake) |
| 5 | Ready for sale |
| 6 | Ready for sale (verified) |
| 9 | Sold / reused |
| 10 | Recycled |
See the Inventory help docs for the full status lifecycle.