Errors

Errors are JSON with a message. Validation errors also name the field.

Reference

HTTPMeaningWhat to do
400Validation failed. The field is named in the responseFix the field and retry
401API key missing or invalidSend a valid x-api-key
403Account suspended, subscription inactive, or device disconnected or disabledCheck your plan and the device status
404Device not foundUse the id of a device in your account
409Device not ready (code DEVICE_NOT_READY)Wait for the device to connect, then retry
429Daily message limit reachedWait 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