One REST endpoint takes a model + serial and returns 12 verified data points — unlocking appliance-aware features in insurance underwriting, IoT onboarding, marketplace verification, and property-tech. p50 latency under 800ms cached. Predictable per-call pricing. 138 brands. No enterprise dance required.
API Overview
ApplianceIQ exposes a REST API at api.applianceiq.com/v1. Four endpoints cover the full product:
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/lookup | Full 12-field appliance profile from model + serial |
| GET | /v1/recalls/{model} | Recall data only — faster and cheaper for recall-only use cases |
| POST | /v1/ocr/label | Image → extracted model + serial → full profile |
| GET | /v1/rate-limit-info | Current usage window — calls made, remaining, reset timestamp |
Authentication
All requests require an API key in the X-API-Key header. Generate separate keys for development and production environments — never expose your production key in client-side code.
The Canonical Lookup
The /v1/lookup endpoint is the workhorse. POST model_number and optional serial_number, receive all 12 fields:
OCR Endpoint
The /v1/ocr/label endpoint accepts a base64-encoded image of an appliance nameplate and returns extracted brand, model, and serial — which you then pass to /v1/lookup for the full profile. Ideal for mobile apps, self-service portals, and field tech tools where the user can photograph the label rather than manually transcribe it.
Webhooks for Recall Changes
Subscribe to recall events by model number. When a model in your indexed database receives a new CPSC recall, ApplianceIQ POSTs to your endpoint within 60 seconds. Available on Startup and Scale tiers.
Example Integrations
- Insurance underwriting: At policy application, verify appliance age and recall status from customer-provided model + serial. Flag out-of-age or recalled appliances for underwriter review before binding coverage.
- IoT device onboarding: When a connected appliance registers on your platform (via Wi-Fi setup flow), call
/v1/lookupwith the model + serial from the device's registration data. Automatically associate warranty, recall, and lifespan data with the device record. - Used-appliance marketplace: At listing time, verify seller-provided appliance details and flag recalled units before they appear in search results. Recall-checked listings convert better — buyers trust the platform.
- Real-estate listing enrichment: At MLS listing creation, run
/v1/lookupon each appliance listed in the property details. Add age, recall status, and lifespan estimates to the listing data layer.
Error Handling
ApplianceIQ uses standard HTTP status codes. Key cases to handle:
200 OKwithoverall_confidence < 0.5: Data returned but low confidence — flag for manual review rather than auto-populating downstream systems404 Not Found: Model number not in database (138 brands covered; niche or regional brands may return 404)429 Too Many Requests: Rate limit hit — implement exponential backoff503 Service Unavailable: Temporary — retry after delay; check status.applianceiq.com
Rate Limits and Pricing
Dev tier: 100 free lookups/month, $0.05/call after. Startup tier: $99/month for 5,000 lookups, $0.04/call overage. Scale: custom volume pricing. Recall-only calls to /v1/recalls do not count against the lookup quota. Check /v1/rate-limit-info before bulk jobs to avoid mid-job throttling.