Error codes
Last updated June 26th, 2024
The Knox Device Management Service API uses the conventional HTTP response code to indicate the success or failure of a request. A 2XX
response code indicates success, a 4XX
response code indicates an error given the inputs of the request, and a 5XX
response code indicates a failure with the Knox Device Management Service platform.
Standard HTTP status codes
The following table lists the most common HTTP error responses:
Status code | Status message | Description |
---|---|---|
200 | Success | The request was successfully received. |
202 | Accepted | The request has been accepted and is currently being processed. |
400 | Bad request | The client has issued an invalid request. Verify your request (For example, check validation errors in your request load). |
401 | Unauthorized | Authorization for the API is required, but your request is not authenticated. |
403 | Forbidden | The request has been authenticated but does not have the appropriate permissions, or the requested resource not be found. |
404 | Not found | The requested path, resource, or user does not exist. |
500 | Server error | An error occurred on the server. Please try again later. |
Knox Device Management Service error codes
Knox Device Management Service specifies custom error codes for each endpoint. The custom error codes are returned under HTTP error code 400.
General error codes
Error code | Error message | Description |
---|---|---|
INVALID_PARAM | Invalid parameter(s) provided. | Request body parameters are invalid, check that you’ve entered the parameters properly. |
INTERNAL_SERVER_ERROR | Internal Server Error. Something unexpected happened. | Server has encountered an internal error, please try again later. |
Upload devices
Error code | Error message | Description |
---|---|---|
INVALID_DEVICE_ENROLL_TYPE | Device IMEI/serial number is invalid. | This IMEI or serial number is invalid. Ensure that the correct IMEI or serial number is provided. |
DUPLICATED_EXISTING_PRIMARY_DEVICES | This device already exists on a different account. | This device is already on another customer’s account. Make sure that you’ve entered the IMEI properly, and that this device belongs to you. |
DUPLICATED_DEVICES | This device is already uploaded to your account. | This device is already uploaded to your account. |
KDI_VALIDATION_ERROR_DEVICES | This device couldn’t be uploaded because it is not a Samsung device. | You are trying to upload a device that was not manufactured by Samsung. Make sure that you’ve entered the IMEI properly, and that you have a Samsung device. |
FAILED_DEVICE_UPLOAD | All devices failed to upload. Check that your IMEIs and serial numbers are valid, and that you’re uploading Samsung devices. | All devices in this operation couldn’t be uploaded. Make sure that you’ve entered the IMEIs properly, and that you’ve entered Samsung devices. |
INVALID_IMEI_CHECKSUM | Device IMEI is invalid. | This IMEI is invalid, make sure that you’ve entered the correct IMEIs. |
INVALID_SERIAL_CHECKSUM | Device serial number is invalid. | This serial number is invalid, make sure that you’ve entered the serial number correctly. |
INVALID_MEID_CHECKSUM | Device MEID is invalid. | This MEID is invalid, make sure that you’ve entered the MEID correctly. |
Delete devices
Error code | Error message | Description |
---|---|---|
INVALID_DEVICE_ENROLL_TYPE | Device IMEI/serial number is invalid. | This IMEI or serial number is invalid, make sure that they’ve been entered properly. |
FAILED_DEVICE_DELETE | No devices could be deleted. Check that your IMEIs and serial numbers are valid. | All devices in this operation couldn’t be deleted. Make sure that you’ve entered the IMEIs properly. |
DEVICE_DELETE_IN_PROGRESS | An operation to delete these devices is already in progress. | An operation to delete these devices is already in progress. |
DEVICE_IN_PROGRESS | Another operation is already being performed on this device. | An operation is currently being performed on this device, please try again later. |
Get devices
Error code | Error message | Description |
---|---|---|
IMEI_SERIAL_NOT_FOUND | Requested devices couldn’t be found. | This IMEI/serial number could not be found on your account. Make sure that you’ve entered the IMEI properly, and that this device is uploaded to your account. |
OPERATION_ID_NOT_FOUND | Invalid operationId provided. | The operation ID provided doesn’t exist or is used for device deletion, so devices couldn’t be found. |
On this page
Is this page helpful?