Client Error Codes
This list of common codes may help diagnose activation problems or operational issues. The error codes that contain "CONFIG_UPDATE" refer to the web-server SSL cert. The "SERVER" error codes are the ECDSA cert, not the web-server SSL cert.
Client Error Codes
|
Error Code |
Description |
Possible Resolution |
|
0 = AUTH FAILURE |
User authentication has failed. |
Check and clear Public Key. |
|
1 = SERVER BUSY |
Server is busy. |
Try again later. |
|
2 = SOFTWARE INVALID |
The currently running software is invalid i.e. it is most likely it is too old to run on the current system. |
Prompt user to update to the current release. |
|
3 = NETWORK TIMEOUT |
The current network operation timed out. |
Try again later. |
|
4 = NETWORK FAILURE |
The network has failed for some reason. |
Try carrier vs. WiFi. Check network connection, check web browser to google, check firewall. |
|
5 = FILESYSTEM FULL |
The filesystem is full and list data could not be saved. |
Free up space in the device. |
|
8 = CONFIG UPDATE FAILURE BUSY |
An error occurred during config updating (or provisioning) due to the HTTP subsystem being busy either running another transaction, or not being able to get an HTTP socket from the system. |
Try again. |
|
9 = CONFIG UPDATE FAILURE TIMEOUT |
An error occurred during config updating or provisioning due to a socket timeout. i.e. we could not contact the server . |
Try again. |
|
10 = CONFIG UPDATE FAILURE NO DATA |
An error occurred during config updating or provisioning due to the server sending back no data. e.g. the user was not provisioned. |
Resend activation code. |
|
11 = STARTUP FAILURE |
An error occurred during startup. |
Force quit the app and then power cycle the phone. Restart app and/or reboot phone. |
|
12 = UPDATE SERVICE STATE FAILURE |
An error occurred updating the DnD state. |
No action needed. It will fix itself eventually. |
|
13 = UPDATE PRESENCE FAILURE |
An error occurred updating presence. |
Try again. |
|
14 = GET GROUP MEMBER PRESENCE FAILURE |
An error occurred getting group member presence. |
Try again. |
|
15 = ORIGINATE ADHOC CALL FAILURE |
An error occurred originating an adhoc call. |
Try again. |
|
16 = ORIGINATE GROUP CALL FAILURE |
An error occurred originating a group call. |
Try again. |
|
18 = FATAL ERROR |
A fatal error has occurred and the core is no longer running. |
Force quit the app and then power cycle the phone. |
|
19 = NETWORK OFFLINE |
The network is offline and cannot complete the desired operation. |
Verify that data is available (visit a new web page), check firewall. |
|
20 = UNTRUSTED |
The handset public key is untrusted by the network. |
Check trusted status in portal |
|
21 = KEY AGREE FAILED |
The key agreement process failed. |
Force quit the app, power cycle phone, clear public key |
|
22 = VP REQUIRED |
Voice privacy is required and the handset does not support it. |
Update to current store version. |
|
23 = SECURITY ERROR |
A security error occurred. |
Try again later. |
|
24 = MESSAGING FAILURE |
A messaging transaction failed. |
Try again later. |
|
26 = SERVER AUTH FAILURE |
The server failed to authenticate with the handset. |
Contact Support. |
|
28 = ANSWER CALL FAILURE |
The core failed to accept the incoming alert call. |
Try again, restart the app and/or reboot phone. |
|
29 = SET CONTACT DND FAILURE |
The contact DnD could not be set. |
Try again, restart app and or reboot phone |
|
30 = SET GROUP DND FAILURE |
The group DnD could not be set. |
Force stop the app and then power cycle the phone. |
|
31 = SERVER UNTRUSTED |
The server is not trusted by the client. |
Contact Support. |
|
33 = OPERATION NOT ALLOWED |
The requested operation is not allowed. |
Check feature keys. |
|
34 = LOCATION MANAGEMENT FAILURE |
An error occurred with the location manager. |
Force stop the app and then power cycle the phone. |
|
35 = MAX CALL LIMIT |
A new call could not be started because the max call limit was reached. |
Force stop the app and then power cycle the phone. |
|
36 = CALL INVALID |
The call object is invalid. |
Force stop the app and then power cycle the phone. |
|
37 = LIST SYNC FAILURE |
An error occurred with the list syncer. |
Force stop the app and then power cycle the phone. |
|
38 = CONFIG UPDATE FAILURE INTERNAL |
An error occurred during config updating or provisioning due to an internal server error. |
Contact Support. |
|
39 = CONFIG UPDATE FAILURE DEVICE NOT FOUND |
The device not being found in the system. |
Add the device to the system in the portal. |
|
40 = CONFIG UPDATE FAILURE DEVICE NOT TRUSTED |
The device not being trusted by the system. |
Check trust status in portal. |
|
41 = CONFIG UPDATE FAILURE PUBLIC KEY REQUIRED |
No public key being sent and it is required on this system. |
Try again. |
|
42 = CONFIG UPDATE FAILURE PUBLIC KEY MISMATCH |
A mismatch between the public key sent and the one in the system |
Check and clear the public key. |
|
43 = CONFIG UPDATE FAILURE ACCESS TOKEN REQUIRED |
An access token being required but not provided. |
Check config on OAuth 2.0 system. |
|
44 = CONFIG UPDATE FAILURE ACCESS TOKEN INVALID |
An invalid access token being provided. |
Check config on OAuth 2.0 system. |
|
45 = CONFIG UPDATE FAILURE USER NOT FOUND |
The user not being found. |
Add the user to the system in the portal and/or check the OAuth field in the user config. |
|
47 = PROCESSING DELAY EXCEEDED |
A core event took too long to process. Too many of these within a time period mean app performance is suffering. |
Prompt user to reboot phone. |
|
48 = SERVER TOO OLD |
The server is too old to support this client. Specifically either the main protocol or one of its sub-protocols is not at the required minimum defined in this client. |
User authentication has failed. |
|
49 = FEATURE NOT SUPPORTED |
The client attempted to use a feature that is not supported on the server the client is connected to. |
Check features in server and feature keys in server. |
|
50 = CONFIG UPDATE FAILURE SECURITY |
A security violation occurred while executing the transaction. |
Contact Support. |
|
51 = CONFIG UPDATE HANDSHAKE |
An SSL handshake failure occurred. The most common reason this happens is that there is an SSL proxy/interceptor in the path and the certificate that is not available to the app. May also be a misconfiguration in the server. |
Contact Support. |
|
52 = CONFIG UPDATE FAILURE GENERAL |
A general failure occurred during a config update that is not covered by one of the other config update error codes listed above. |
Contact Support. |
|
53 = SERVER CERTIFICATE NAME MISMATCH |
The subject in server certificate does not match the server the client is running on. |
Contact Support.
|
|
54 = SERVER CERTIFICATE EXPIRED |
The server certificate is expired. This error code covers both the not yet valid and expired cases. |
Check device date and time. |
|
55 = SERVER CERTIFICATE BAD |
Either the server certificate or the intermediate certificate is bad for some reason. |
Contact Support.
|
|
56 = VP INTERNAL ERROR |
The voice privacy library is broken. |
Contact Support.
|
|
57 = CONFIG UPDATE FAILURE CODE EXPIRED |
The activation code has expired. |
Assign a new activation code. |
|
58 = EMAIL SUPPORT FAILURE |
An error occurred when performing an email support transaction. |
Try again later. |
|
59 = CONFIG UPDATE FAILURE GENERAL PERMANENT |
A general failure occurred during config update that is not covered |
Contact Support. |
|
60 = INVALID PARAMETER |
An invalid parameter was passed in a request. |
Try again later. |