Errors
Errors are JSON with a message. Validation errors also name the field.
Reference
| HTTP | Meaning | What to do |
|---|---|---|
| 400 | Validation failed. The field is named in the response | Fix the field and retry |
| 401 | API key missing or invalid | Send a valid x-api-key |
| 403 | Account suspended, subscription inactive, or device disconnected or disabled | Check your plan and the device status |
| 404 | Device not found | Use the id of a device in your account |
| 409 | Device not ready (code DEVICE_NOT_READY) | Wait for the device to connect, then retry |
| 429 | Daily message limit reached | Wait for the next day or upgrade the plan |
Retry guidance
Do not retry 400, 401, 403 or 404 unchanged. Retry 409 after a pause, and 429 only after your limit resets.
Related
Last reviewed 2026-11-09. QuackAPI is an unofficial linked-device service. Acceptable use