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.