Skip to content

SDK Error Reference ​

This page provides a comprehensive reference of all error types and codes that can be returned when using the Vonage Client SDK. Understanding these errors will help you implement proper error handling in your application.

Error Structure ​

All errors in the Client SDK are instances of VonageError with the following properties:

PropertyTypeDescription
typestringThe category of error (see Error Types below)
codestringSpecific error code identifying the exact error
messagestringHuman-readable description of the error: what happened, where, and what to do
sourcestringA short trace of the code path that failed. Send it, with the code, when you contact Vonage support
isRetriablebooleanWhether the failure is transient and worth retrying
retryAfternumberOptional. How long to wait before retrying, when the server said so

For the cause of each error and what to do about it, see Troubleshooting.

Error Types ​

The SDK uses the following error type categories:

Error TypeDescription
CS_ERRORBackend service errors (API errors from Vonage backend services)
SESSION_ERRORAuthentication and session-related errors
NETWORK_ERRORNetwork connectivity issues, timeouts, and HTTP 5xx server errors
INTERNAL_ERRORSDK-generated errors including media errors, validation, and parsing issues
UNKNOWN_ERRORUnexpected errors that should be reported to support

Complete Error Code Reference ​

CS_ERROR Codes ​

Backend service errors returned from the Vonage API:

Error CodeHTTP CodeDescription
http:error:db-unavailable500Database is temporarily unavailable
http:error:service-not-available503Service is temporarily unavailable
http:error:not-found404Endpoint does not exist or you do not have access

SESSION_ERROR Codes ​

Authentication and authorization errors:

Error CodeDescription
internal:auth:authorization_errorInvalid or missing authorization token
system:error:expired-tokenThe provided token has expired
system:error:invalid-tokenThe provided token is invalid
system:error:missing-tokenNo token was provided

NETWORK_ERROR Codes ​

Network and connectivity errors:

Error CodeHTTP CodeDescription
internal:error:serviceNotAvailable503Service temporarily unavailable, retry recommended
http:error:internal500Internal server error, try again shortly

INTERNAL_ERROR Codes ​

SDK-generated errors including media, validation, and parsing issues:

Media Errors ​

Error CodeDescription
voice:error:media_timeoutEmergency calls only: the call's media connection failed or closed before the call connected
voice:error:media_setup_failedserverCall / answerCall: this device's audio never reached Vonage, after retries
voice:error:media_connection_lostserverCall: the call was placed, but this device's audio connection dropped before it connected
voice:error:call_not_confirmedserverCall: the call was placed with healthy connections, but Vonage did not confirm it started
voice:error:call_already_endedanswerCall: the call ended before it could be answered
voice:error:websocket_signaling_connection_lostThe signaling WebSocket connection dropped while setting up a call and did not recover
voice:error:no_call_foundNo emergency call found with the specified call ID
voice:error:no_call_media_foundNo call media found for the specified call
voice:error:no_offer_foundNo SDP offer was generated for the call
voice:error:no_answer_foundNo SDP answer was received for the call
media:error:media_not_foundMedia connection not found for the specified call ID
media:error:peer_connection_not_foundWebRTC peer connection not found for the specified call ID
media:error:track_not_foundAudio track not found for the specified call ID
media:error:create_answer_errorFailed to create SDP answer
media:error:create_offer_errorFailed to create SDP offer
media:error:create_media_errorFailed to create local media
media:error:process_answer_errorFailed to process SDP answer
media:error:process_offer_errorFailed to process SDP offer
media:error:audio_transformer_errorError in audio processing/transformation
media:error:noise_suppression_already_enabledNoise suppression is already enabled
media:error:noise_suppression_already_disabledNoise suppression is already disabled
media:error:noise_suppression_models_not_foundNoise suppression models not found
media:warning:no_microphone_audioConnected call: this device is not capturing audio from the microphone (reported through onCallMediaWarning)
media:warning:audio_not_sentConnected call: the microphone captures audio, but this device is not sending it
media:warning:audio_not_reaching_vonageConnected call: this device sends audio, but Vonage is not receiving it
media:warning:no_audio_from_vonageConnected call: no audio is reaching this device from Vonage
media:warning:remote_audio_silentConnected call: audio reaches this device, but it is silent

Validation and Parsing Errors ​

Error CodeDescription
internal:error:parsing_exceptionFailed to parse response from server
internal:error:unsanitized_input_errorRequest contains unsanitized input and was rejected
internal:error:illegal_argument_exceptionIncorrect arguments provided to method
internal:error:unexpected_null_valueUnexpected null value encountered

Emergency-Specific Errors ​

Error CodeDescription
emergency:error:invalid_reconnect_token_originReconnect token is missing or has invalid origin
emergency:error:call_timeoutEmergency call operation timed out

UNKNOWN_ERROR ​

Error CodeDescription
N/AUnexpected error that doesn't fit other categories - should be reported to support

Built with VitePress.