Error codes
Last updated October 24th, 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 | The request body parameters you entered aren’t valid. Check whether you’ve entered the proper parameters. |
| INTERNAL_SERVER_ERROR | Internal Server Error | We’ve encountered an error on our end. Please try again later. |
Upload devices
| Error code | Error message | Description |
|---|---|---|
| INVALID_DEVICE_ID | Couldn't find device with ID: (%s) Couldn't upload device with ID: (%s) |
One or more device IDs you're trying to upload are invalid. Make sure you've entered the correct IDs. |
| IMEI_EXIST_IN_DIFFERENT_ACCOUNT | Device IMEI (%s) already uploaded to another account | This device was already uploaded to another customer's account. Make sure you've entered the IMEI properly, and that the device belongs to you. |
| SERIAL_EXIST_IN_DIFFERENT_ACCOUNT | Device serial number (%s) already uploaded to another account | This device was already uploaded to another customer's account. Make sure you've entered the serial number properly, and that the device belongs to you. |
| MEID_EXIST_IN_DIFFERENT_ACCOUNT | Device MEID (%s) already uploaded to another account | This device was already uploaded to another customer's account. Make sure you've entered the MEID properly, and that the device belongs to you. |
| IMEI_EXIST_IN_SAME_ACCOUNT_BY_SAME_UPLOADER | Device IMEI (%s) already uploaded through same source | A device with this IMEI was already uploaded to your account through the same source. |
| SERIAL_EXIST_IN_SAME_ACCOUNT_BY_SAME_UPLOADER | Device serial number (%s) already uploaded through same source | A device with this serial number was already uploaded to your account through the same source. |
| MEID_EXIST_IN_SAME_ACCOUNT_BY_SAME_UPLOADER | Device MEID (%s) already uploaded through same source | A device with this MEID was already uploaded to your account through the same source. |
| IMEI_EXIST_IN_SAME_ACCOUNT_BY_DIFFERENT_UPLOADER | Device IMEI (%s) already uploaded through different source | A device with this IMEI was already uploaded to your account through a different source. |
| SERIAL_EXIST_IN_SAME_ACCOUNT_BY_DIFFERENT_UPLOADER | Device serial number (%s) already uploaded through different source | A device with this serial number was already uploaded to your account through a different source. |
| MEID_EXIST_IN_SAME_ACCOUNT_BY_DIFFERENT_UPLOADER | Device MEID (%s) already uploaded through different source | A device with this MEID was already uploaded to your account through a different source. |
| IMEI_SUBMITTED_FOR_EXISTING_SERIAL_IN_SAME_ACCOUNT | Device IMEI (%s) already uploaded using serial number (%s) | A device with this IMEI was already uploaded to your account using its serial number. |
| SERIAL_SUBMITTED_FOR_EXISTING_IMEI_IN_SAME_ACCOUNT | Device serial number (%s) already uploaded using IMEI (%s) | A device with this serial number was already uploaded to your account using its IMEI. |
| MEID_SUBMITTED_FOR_EXISTING_IMEI_SERIAL_IN_SAME_ACCOUNT | Device MEID (%s) already uploaded using IMEI or serial number (%s) | A device with this MEID was already uploaded to your account using its IMEI or serial number. |
| IMEI_SUBMITTED_FOR_EXISTING_SERIAL_IN_DIFFERENT_ACCOUNT | Device IMEI (%s) already uploaded to another account using serial number (%s) | A device with this IMEI was already added to a different account, but using its serial number. |
| SERIAL_SUBMITTED_FOR_EXISTING_IMEI_IN_DIFFERENT_ACCOUNT | Device serial number (%s) already uploaded to another account using IMEI (%s) | A device with this serial number was already uploaded to a different account, but using its IMEI. |
| MEID_SUBMITTED_FOR_EXISTING_IMEI_SERIAL_IN_DIFFERENT_ACCOUNT | Device MEID (%s) already uploaded to another account using IMEI or serial number (%s) | A device with this MEID was already uploaded to a different account, but using its IMEI or serial number. |
| INVALID_IMEI_CHECKSUM | Couldn't find device IMEI | The device IMEI isn't valid. Make sure you've entered the correct IMEIs. |
| INVALID_SERIAL_CHECKSUM | Couldn't find device serial number | The device serial number isn't valid. Make sure you've entered the correct serial numbers. |
| INVALID_MEID_CHECKSUM | Couldn't find device MEID | The device MEID isn't valid. Make sure you've entered the correct MEIDs for your devices. |
| KDI_VALIDATION_ERROR_DEVICES | Couldn't upload non-Samsung device | The device you're trying to upload wasn't manufactured by Samsung. Make sure you include only Samsung devices, and that you've entered the device IDs properly. |
| FAILED_DEVICE_UPLOAD | Couldn't upload any devices | We couldn't upload any of your devices. Make sure you include only Samsung devices, and that you've entered the device IDs properly. |
| DEVICE_IN_PROGRESS | Device operation in progress | An operation is already being performed on this device. Please try again later. |
Delete devices
| Error code | Error message | Description |
|---|---|---|
| INVALID_DEVICE_ID | Couldn't find device with ID: (%s) Couldn't delete device with ID: (%s) |
One or more device IDs you're trying to delete are invalid. Make sure you've entered the correct IDs. |
| ALL_DEVICE_DELETE_FAILED | Couldn't delete any devices | We couldn't delete any of the devices in your operation. Make sure you've entered the correct device IDs. |
| PARTIAL_DEVICE_DELETE_FAILED | Only some devices were deleted | We could only delete some of the devices in your operation. Make sure you've entered the device IDs properly. |
| DEVICE_NOT_FOUND | Couldn't find any devices | Couldn't find any of your devices. Make sure you've entered the correct device IDs. |
| DEVICE_DELETE_IN_PROGRESS | Device deletion in progress | These devices are already being deleted. |
| DEVICE_IN_PROGRESS | Device operation in progress | An operation is already being performed on this device. Please try again later. |
| KNOX_SERVICE_FAILED_DEVICE_DELETE | Couldn't delete device from: | The device couldn't be deleted from certain services. |
| INVALID_TARGET_SERVICE | Invalid targetServices. Valid targetServices are: | The targetServices you provided aren't valid. Make sure you enter one of the services listed in the error message. |
| INVALID_SCOPE_REQUEST | Not authorized to perform action | You don't have the right authorization to perform this operation. Double-check whether your app has requested the right scopes. |
Get devices
| Error code | Error message | Description |
|---|---|---|
| DEVICE_NOT_FOUND | Couldn’t find any requested devices | We couldn’t find any of the devices you requested. Make sure you’ve entered the device IDs properly. |
| OPERATION_ID_NOT_FOUND | Couldn’t find operation ID | The operation ID you provided either doesn’t exist, or is associated with a device deletion request that’s already complete. |
| INVALID_NEXT_FORMAT | Invalid searchAfter value | The searchAfter value isn’t valid. Enter a device ID to start pagination after. |
| INVALID_DEVICE_IMEI | Couldn’t find device IMEI: (%s) | The device IMEI isn’t valid. Make sure you’ve entered the correct IMEIs. |
| INVALID_DEVICE_SERIAL | Couldn’t find device serial number: (%s) | The device serial number isn’t valid. Make sure you’ve entered the correct serial numbers. |
| INVALID_DEVICE_MEID | Couldn’t find device MEID: (%s) | The device MEID isn’t valid. Make sure you’ve entered the correct MEIDs. |
On this page
Is this page helpful?