Common error codes

The following table lists error codes common to the IoT Hub APIs. HTTP status code being N/A means the error occurs only through AMQP or MQTT.

Error code Description HTTP status code
400004 The body of the request is not valid; for example, it cannot be parsed, or the object cannot be validated. 400 Bad Format
400027 See 400027 ConnectionForcefullyClosedOnNewConnection. N/A
400103 InvalidContentEncodingOrType 400 Bad Request
401002 IotHub Unauthorized Access 401 Unauthorized
401003 The authorization token cannot be validated; for example, it is expired or does not apply to the request’s URI and/or method. To learn more, see 401003 IoTHubUnauthorized. 401 Unauthorized
403010 This operation is not valid for the current IoT Hub tier. How To Upgrade your IoT Hub 403 Forbidden
403002 See 403002 IoTHubQuotaExceeded. 403 Forbidden
403004 See 403004 DeviceMaximumQueueDepthExceeded. 403 Forbidden
403006 See 403006 DeviceMaximumActiveFileUploadLimitExceeded. 403 Forbidden
404001 See 404001 DeviceNotFound. 404 Not Found
404104 See 404001 DeviceNotFound. 404 Not Found
404103 See 404103 DeviceNotOnline. 404 Not Found
404104 See 404104 DeviceConnectionClosedRemotely. 404 Not Found
409001 See 409001 DeviceAlreadyExists. 409 Conflict
409002 See 409002 LinkCreationConflict. N/A
412001 The etag in the request does not match the etag of the existing resource, as per RFC7232. 412 Precondition Failed
412002 See 412002 DeviceMessageLockLost. N/A
413001 Message sent to the IoT Hub exceeds the maximum allowable size for IoT Hub messages. 413 RequestEntityTooLarge
429001 See 429001 ThrottlingException. 429 Too Many Requests
500xxx See 500xxx Internal errors. 500 Internal Server Error
500001 See 500xxx Internal errors. 500 Internal Server Error
503xxx Service Unavailable Service Unavailable
503003 See 503003 PartitionNotFound. 503 Service Unavailable
503008 Receive link throttled. Message throttled, please retry operation. 503 Server Unavailable
504101 See 504101 GatewayTimeout. 504 Gateway Timeout