Using ApplianceAPI with Claude Code
Query appliance model data, decode serial numbers, and check recalls directly from Claude Code sessions. Copy-paste prompts included.
Claude Code can call ApplianceAPI directly using curl or Node.js fetch. Pass a brand and model number, get back structured JSON with product data, serial decoding, and more. Copy-paste the prompts below to get started.
Direct HTTP Calls
Claude Code can call the ApplianceAPI REST endpoints directly using curl or fetch.
Copy-Paste Prompts
Pre-built prompts for model lookup, serial decoding, recall checks, and age estimation.
Structured Responses
JSON responses that Claude can parse, summarize, and act on within the conversation.
No Setup
Free tier, API key in header, instant results.
Quick Start
- Get your API key — Sign up at /signup (free tier, no credit card)
- Set as environment variable —
export APPLIANCE_API_KEY=your_key_here - Use in Claude Code — Ask Claude to make HTTP requests to the API endpoints with your key in the Authorization header
Ready-to-Use Prompts
Copy and paste these prompts directly into a Claude Code session:
Use curl to call ApplianceAPI and look up Whirlpool model WRS325SDHZ.
Parse the JSON response and tell me the product title and confidence score.Decode serial number FH212345X for a Whirlpool washer using the
ApplianceAPI serial decoder at /appliance-date/decode.
What year was it manufactured?Check if GE model GFE28GYNFS has any active recalls using ApplianceAPI.Write a Node.js function that takes a brand and model number,
calls ApplianceAPI, and returns a formatted summary with
photo URL, title, and age.Example: Enriching a Work Order
Paste this into Claude Code to see a complete workflow:
I have a service ticket for a Samsung WF45T6000AW with serial FH212345X.
Use ApplianceAPI to get the product photo, manufacture date, and recall status.
Format it as a summary I can paste into the work order.Claude Code will make the API calls, parse the responses, and generate a formatted summary with the product photo URL, decoded manufacture date, and recall status.
Advanced Prompts
These prompts work in Claude Code sessions with API access:
"I have a service ticket for a Samsung WF45T6000AW with serial FH212345X. Use curl to call ApplianceAPI at /api/v1/images to get the product photo, then call /appliance-date/decode to get the manufacture date. Summarize the appliance age, photo URL, and whether it has any recalls."
"I have a CSV of 50 appliances with brand, model, and serial columns. Write a Node.js script that calls ApplianceAPI for each row to decode the serial number and append the manufacture year and age to the CSV."
"Generate an appliance section for a home inspection report. The kitchen has a GE GFE28GYNFS refrigerator (serial LA543210) and a Whirlpool WDT750SAHZ dishwasher (serial DR2143567). Use ApplianceAPI to get the age, photo, and recall status for each. Format as markdown."
Why Claude Code + ApplianceAPI
Claude Code excels at multi-step workflows that combine API calls with reasoning. ApplianceAPI provides the raw data; Claude provides the interpretation.
- Serial decoding requires domain knowledge — each brand uses a different format. The API handles this complexity so Claude does not have to guess.
- Recall status changes frequently — Claude's training data may be months old. The API returns current CPSC data.
- Photos are not in text models — Claude cannot visualize an appliance from a model number alone. The API returns a verified image URL.
Complete Workflow: Fleet Appliance Audit
This example shows a multi-step Claude Code session using ApplianceAPI:
"I have a spreadsheet of 20 appliances from a property inspection. For each row, I need: (1) decode the serial number to get manufacture date, (2) calculate age, (3) compare against average lifespan, (4) check recall status, (5) flag any that are past expected lifespan or recalled. Output a summary table."
Claude Code would:
- Read the spreadsheet data
- For each appliance, call
POST /appliance-date/decodewith brand + serial - Calculate age from the returned manufacture date
- Compare against NAHB lifespan data (refrigerators 13-17 yrs, washers 10-14 yrs, etc.)
- Flag any past expected lifespan as "replacement recommended"
- Output a formatted summary table with status badges
Total time: under 2 minutes for 20 appliances. Manual process: 2-3 hours.
Claude Code Example
{
"success": true,
"brand": "Samsung",
"model": "WF45T6000AW",
"title": "Samsung 4.5 cu. ft. Front Load Washer",
"imageUrl": "https://applianceapi.com/assets/samsung/WF45T6000AW.jpg",
"confidence": "high"
}Frequently Asked Questions
How do I use ApplianceAPI in Claude Code?
Get an API key at /signup, then ask Claude Code to make HTTP requests to the API endpoints with your key in the Authorization header.
What endpoints can Claude Code call?
Model lookup (/api/v1/images), serial decoding (/appliance-date/decode), and all other REST endpoints documented at /docs.
Do I need to install anything?
No. Claude Code can use curl or Node.js fetch directly. No SDK or package installation needed.
Is there a free tier?
Yes. 10 lookups per month, no credit card required.