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. |
61 = OUTSTANDING INVITE | An invite for this target (user or group) is currently outstanding, so a new one will not be sent | Try again later. |
62 = EXISTING CALL | An existing call for this target (user or group) is already going, so a new invite will not be sent. | Try again later. |
63 = INTERMEDIATE CERT TIMESTAMP INVALID | The intermediate certificate has an invalid timestamp. This error code. covers both the not yet valid and expired cases. | Try again later. |
64 = INTERMEDIATE CERTIFICATE BAD | The intermediate certificate is bad for some reason other than a timestamp issue. | Contact Support. |
65 = ROOT CERT TIMESTAMP INVALID | The root certificate has an invalid timestamp. This error code covers both the not yet valid and expired cases | Contact Support. |