Error Codes

In the course of interacting with the API, various error codes may be encountered. These error codes are designed to provide specific information about issues that may arise during the request processing. Understanding these error codes is crucial for diagnosing problems and implementing appropriate solutions. This section provides a detailed explanation of each error code, its meaning, and recommended actions to resolve the issues.

400 - Bad Request

This error code indicates that something went wrong when processing the request. This can be due to a number of reasons, however the Android and Web Libraries will attempt to process the request and will use the fallback URLs if the request fails. For the Server to Server, it is recommended to try the fallback URLs if the request fails. If you continue to encounter this error, please contact support for further assistance.

409 - Conflict

The 409 Conflict error code indicates that there is a conflict with the request sent to the API and the licence being used. This can occur for multiple reasons, such as an incorrect library being used for the licence, there is a mismatch between the library variant and the licence, or the IMEI lookup feature is not allowed with the current licence. For these errors, the Android and Web Libraries will not attempt to use the fallback URLs. It is recommended for the Server to Server not to try the fallback URLs. Please ensure that the correct library is being used for the licence, and that the licence allows for the requested feature. If you continue to encounter this error, please contact support for further assistance.

410 - Gone

This error code indicates that the licence being used in the request has expired. As a result no results will be returned. The Android and Web Libraries will not attempt to use the fallback URLs. It is recommended for the Server to Server not to try the fallback URLs. Please contact support to renew your licence.

422 - Unprocessable Entity

This error code indicates that the request sent to the API is using an unknown or invalid licence. Please ensure that the licence being used is valid and has been correctly configured. The Android and Web Libraries will not attempt to use the fallback URLs. It is recommended for the Server to Server not to try the fallback URLs. If you continue to encounter this error, please contact support for further assistance.

429 - Too Many Requests

This error code indicates that the number of requests made to the API has exceeded the usage cap. When this occurs the API will not return any results and the Android and Web Libraries will not attempt to use the fallback URLs. It is recommended for the Server to Server not to try the fallback URLs. Please contact support to discuss increasing your usage cap.

Note: When contacting support, it is helpful to provide the reference id that is returned in the response from the API. This will help support to quickly identify the request in question and provide the necessary assistance.