MENU
    Search... Close
    View All Essentials
    Response Status and Error Codes

    Response Status and Error Codes

    When using our API, you may encounter certain status and error codes that you need to understand or troubleshoot. This page contains a list of all codes with thorough descriptions and action steps you need to take if you are looking to resolve a problem. 

    TIP

    Use the page Search field or the Find option to quickly locate the code name you are looking for.

    HTTP Status Codes

    Every HTTP transaction has a status code sent back by the server to define how the server has handled the transaction. The most common statuses you may have encountered are 200 OK and 404 Not Found. Check out the list of the HTTP status codes to learn more.

     

    API Status Codes

    Besides the standard HTTP status code, the status object may be returned as part of the API response message, delivery report, or message log.

    Status object example:

    {  
   "groupId":3,
   "groupName":"DELIVERED",
   "id":5,
   "name":"DELIVERED_TO_HANDSET",
   "description":"Message delivered to handset"
}

    General Status Codes

    PENDING (group id: 1) - general status codes

    The message has been processed and sent to the next instance, i.e., a mobile operator.

    Id Status
    3 PENDING_WAITING_DELIVERY
    • Message has been processed and sent to the next instance, i.e., a mobile operator with request acknowledgment from their platform. The delivery report has not yet been received and is awaited, so the status is still pending.
    7 PENDING_ENROUTE
    • Message has been processed and sent to the next instance, i.e., mobile operator.
    26 PENDING_ACCEPTED
    • Message has been accepted and processed, and it`s ready to be sent to the next instance, i.e., operator.

    UNDELIVERABLE (group id: 2) - general status codes

    The message has not been delivered.

    Id Status
    4 UNDELIVERABLE_REJECTED_OPERATOR
    • Message has been sent to the operator, whereas the request was rejected, or a delivery report with status REJECTED was reverted.
    9 UNDELIVERABLE_NOT_DELIVERED
    • Message has been sent to the operator but has failed to deliver since a delivery report with status UNDELIVERED was reverted from the operator.

    DELIVERED (group id: 3) - general status codes

    The message has been successfully processed and delivered.

    Id Status
    2 DELIVERED_TO_OPERATOR
    • Message has been successfully sent and delivered to the operator.
    5 DELIVERED_TO_HANDSET
    • Message has been successfully processed and delivered to the recipient.

    EXPIRED (group id: 4) - general status codes

    The message has been sent and has either expired due to pending past its validity period (our platform default is 48 hours), or the delivery report from the operator has reverted the expired as a final status.

    Id Status
    15 EXPIRED_EXPIRED
    • Message was received and sent to the operator. However, it has been pending until the validity period has expired or the operator returned EXPIRED status in the meantime.
    29 EXPIRED_DLR_UNKNOWN
    • Message has been received and forwarded to the operator for delivery. However, the delivery report from the operator has not been formatted correctly or has not been recognized as valid.

    REJECTED (group id: 5) - general status codes

    The message has been received but has either been rejected by Infobip or the operator has reverted REJECTED as final status.

    Id Status
    6 REJECTED_NETWORK
    • Message has been received, but the network is either out of our coverage or is not set up on your account. Your Account Manager can inform you about the coverage status or set up the network in question.
    8 REJECTED_PREFIX_MISSING
    • Message has been received but has been rejected as the number is not recognized due to an incorrect number prefix or number length. This information is different for each network and is regularly updated.
    10 REJECTED_DND
    • Message has been received and rejected due to the user being subscribed to DND (Do Not Disturb) services, disabling any service traffic to their number.
    11 REJECTED_SOURCE
    • Your account is set to accept only registered sender IDs, and the sender ID defined in the request has not been registered on your account.
    12 REJECTED_NOT_ENOUGH_CREDITS
    • Your account is out of credits for further submission. Top up your account. For further assistance in topping up or applying for an online account top-up service, you may contact your Account Manager.
    13 REJECTED_SENDER
    • The sender ID has been blocklisted on your account via Infobip web interface. Remove the blocklist on your account or contact Support for further assistance.
    14 REJECTED_DESTINATION
    • The destination number has been blocklisted either at the operator request or on your account via web interface, please remove the blocklist on your account via Infobip web interface or contact Support for more information.
    17 REJECTED_PREPAID_PACKAGE_EXPIRED
    • Account credits are past their validity period. Top up your sub-account with credits to extend the validity period.
    18 REJECTED_DESTINATION_NOT_REGISTERED
    • Your account has been set up for submission only to a single number for testing purposes, contact your Account Manager to remove the limitation.
    19 REJECTED_ROUTE_NOT_AVAILABLE
    • Message has been received on the system. However, your account has not been set up to send messages, i.e., no routes on your account are available for further submission. Your Account Manager will be able to set up your account based on your preference.
    20 REJECTED_FLOODING_FILTER
    • Message has been rejected due to an anti-flooding mechanism. By default, a single number can only receive 20 varied messages and 6 identical messages per hour. If there is a requirement, the limitation can be extended per account on request to your Account Manager.
    21 REJECTED_SYSTEM_ERROR
    • The request has been rejected due to an expected system error. Retry the submission or contact our technical support team for more details.
    23 REJECTED_DUPLICATE_MESSAGE_ID
    • The request has been rejected due to a duplicate message ID specified in the submit request; the message IDs should be a unique value. For more information, refer to SMS on the Infobip API Developer Hub.
    24 REJECTED_INVALID_UDH
    • Message has been received and our system detected the message was formatted incorrectly because of either an invalid ESM class parameter (fully featured binary message API method) or an inaccurate amount of characters when using esmclass:64 (UDH). For more information, visit the articles below or contact our Support team for clarification.
      User Data Header
      Concatenated SMS
    25 REJECTED_MESSAGE_TOO_LONG
    • Message has been received, but the total message length is more than 25 parts or the message text exceeds 4000 bytes as per our system limitation.
    51 MISSING_TO
    • The request has been received, however, the to parameter has not been set or it is empty, i.e., there must be valid recipients to send the message.
    52 REJECTED_DESTINATION
    • The request has been received, however, the destination is invalid—the number prefix is not correct as it does not match a valid number prefix by any mobile operator. Number length is also taken into consideration when verifying number validity.

    Voice Status Codes

    REJECTED (group id: 5) - Voice status codes

    The message has been received but has either been rejected by Infobip or the operator has reverted rejected as the final status.

    Id Status
    53 REJECTED_INVALID_AUDIO_FILE_URL
    • The URL of the audio file is invalid and could not be read properly.
    54 REJECTED_UNSUPPORTED_LANGUAGE
    • The language submitted within the request is not supported and request couldn’t be processed correctly.
    55 REJECTED_MESSAGE_IS_EMPTY
    • Native to Voice services, this status is returned in case there is no text sent in your Voice message request.
    56 REJECTED_INVALID_NOTIFY_URL
    • Native to Voice services, this status is returned in case the notifyUrl parameter is not formatted properly. Refer to Send Voice over API for more information.
    57 REJECTED_INVALID_NOTIFY_CONTENT_TYPE
    • Native to Voice services, this status is returned in case the notifyContentType parameter is not formatted properly. Refer to Send Voice over API for more information.
    58 REJECTED_INVALID_DTMF_SIGN
    • Defined value for repeating message is invalid and must be a positive number.
    59 REJECTED_INVALID_DTMF_TIMEOUT
    • Defined value for the waiting period is invalid and must be a positive number.
    60 REJECTED_INVALID_RING_TIMEOUT
    • Defined value for the duration of the call is invalid and must be a positive number.
    61 REJECTED_INVALID_CALL_TIMEOUT
    • Defined value for the total period of the call is invalid and must be a positive number.
    62 REJECTED_INVALID_MACHINE_DETECTION
    • The action which attempts to detect answering machines at the beginning of the call is invalid.
    63 REJECTED_INVALID_ACTIONS
    • Actions submitted in HTTP API request are invalid.
    64 REJECTED_INVALID_ACTION_GROUPS
    • Action groups submitted in HTTP API request are invalid.
    83 REJECTED_MACHINE_DETECTION_DISABLED
    • Machine detection is not enabled. Contact your dedicated Account manager.

    MMS Status Codes

    REJECTED (group id: 5) - MMS status codes

    The message has been received but has either been rejected by Infobip or the operator has reverted rejected as the final status.

    Id Status
    56 REJECTED_INVALID_NOTIFY_URL
    • Status is returned when notifyUrl parameter is not formatted properly.
    77 REJECTED_MESSAGE_TEXT_TOO_LONG
    • Message has been received, but the textual part of message length exceeds 1600 characters set as our system limitation.

    Push Notifications Status Codes

    UNDELIVERABLE (group id: 2) - push notifications status codes

    The message has not been delivered.

    Id Status
    66 UNDELIVERABLE_NO_DESTINATION
    • The status occurs when in a Push API call in object TO defined filter which doesn’t resolve any pushRegistrationIds as destinations for Push delivery. Field to is used to query the message recipient segment. For example, you can try to target according to a “tag” which doesn’t exist at any of instances of the requested ApplicationCode; it will return no destinations as we couldn’t find anything that would satisfy the requested conditions in our database. In another example, you may want to target all application instances (devices) with the Android OS. In this case, you have to use CloudType: GCM and API internally will resolve all destinations and will send the message to all Android devices linked to the requested ApplicationCode. You can also check your valid registrations by using filtering in our web interface. You can more information about User Data at our SDK pages: iOS and Android.

    REJECTED (group id: 5) - push notifications status codes

    The message has been received but has either been rejected by Infobip, or the operator has reverted rejected as final status.

    Id Status
    65 REJECTED_NO_APPLICATION
    • The status occurs when an invalid or non-existent ApplicationCode is used in the field from in a Push API call. Each application profile has its own unique ApplicationCode. ApplicationCode is used in SDK as a key identifier for the Application installed on an end user’s device able to communicate with our platform. For the paired device + installed app, pushRegistrationId is issued and it is uniquely linked to ApplicationCode. You should be able to get all available applications or check the configuration.

    Error Codes

    Error object can be returned as part of the send message response or Delivery report response.

    Error object example:

    {  
   "groupId":0,
   "groupName":"OK",
   "id":0,
   "name":"NO_ERROR",
   "description":"No Error",
   "permanent":false
}

    General Error Codes

    OK (group id: 0) - general error codes

    The request has been completed successfully.

    ID Permanent Error
    0 false NO_ERROR
    • There is no error description provided. Mostly returned for successful delivery, or when error code was not returned by the operator.

    HANDSET_ERRORS (group id: 1) - general error codes

    The request has not been completed due to handset related issues.

    ID Permanent Error
    1 true EC_UNKNOWN_SUBSCRIBER
    • The number does not exist or it has not been assigned to any active subscriber in the operator’s user database.
    5 false EC_UNIDENTIFIED_SUBSCRIBER
    • Unidentified Subscriber
    6 false EC_ABSENT_SUBSCRIBER_SM
    • The subscriber is detected unavailable as there was no paging response from the handset. This is often due to the handset being switched off or low signal area. Applies to MAP protocol version 3.
    7 false EC_UNKNOWN_EQUIPMENT
    • The mobile device has not been recognized by EIR (Equipment Identity Register) during device verification on the MAP protocol level at operator’s infrastructure.
    8 false EC_ROAMING_NOT_ALLOWED
    • The subscriber is currently in roaming in another country or other operator’s infrastructure - roaming delivery is not guaranteed due to lack of roaming agreements between many different operators.
    9 true EC_ILLEGAL_SUBSCRIBER
    • Illegal Subscriber
    11 true EC_TELESERVICE_NOT_PROVISIONED
    • The subscriber’s mobile service has been suspended by the operator.
    12 true EC_ILLEGAL_EQUIPMENT
    • Illegal Equipment
    13 false EC_CALL_BARRED
    • Message is rejected due to barring of message service; blocking is set by operator or subscriber for the number.
    21 false EC_FACILITY_NOT_SUPPORTED
    • Facility Not Supported
    27 false EC_ABSENT_SUBSCRIBER
    • The subscriber is offline in the network, as confirmed by the handset’s paging response. This is often due to the handset being switched off.
    31 false EC_SUBSCRIBER_BUSY_FOR_MT_SMS
    • Subscriber Busy For Mt SMS
    32 false EC_SM_DELIVERY_FAILURE
    • SM Delivery Failure
    33 false EC_MESSAGE_WAITING_LIST_FULL
    • Message Waiting List Full
    34 false EC_SYSTEM_FAILURE
    • System Failure
    35 false EC_DATA_MISSING
    • Data Missing
    36 false EC_UNEXPECTED_DATA_VALUE
    • Unexpected Data Value
    255 false EC_UNKNOWN_ERROR
    • Unknown Error
    256 false EC_SM_DF_MEMORYCAPACITYEXCEEDED
    • There has been a mobile subscriber equipment error whereas the handset memory has been exceeded.
    257 false EC_SM_DF_EQUIPMENTPROTOCOLERROR
    • There has been a mobile subscriber equipment error.
    258 false EC_SM_DF_EQUIPMENTNOTSM_EQUIPPED
    • There has been a mobile subscriber equipment error.
    259 false EC_SM_DF_UNKNOWNSERVICECENTRE
    • There has been a mobile subscriber equipment error.
    260 false EC_SM_DF_SC_CONGESTION
    • There has been a mobile subscriber equipment error.
    261 false EC_SM_DF_INVALIDSME_ADDRESS
    • There has been a mobile subscriber equipment error.
    262 false EC_SM_DF_SUBSCRIBERNOTSC_SUBSCRIBER
    • There has been a mobile subscriber equipment error.
    500 false EC_PROVIDER_GENERAL_ERROR
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    502 false EC_NO_RESPONSE
    • The message has been successfully processed and forwarded to the operator, but no response was returned from the operator upon the message submit request, or such error was reverted by the operator. The error also applies to similar errors on SS7 network level.
    503 false EC_SERVICE_COMPLETION_FAILURE
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    504 false EC_UNEXPECTED_RESPONSE_FROM_PEER
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    507 false EC_MISTYPED_PARAMETER
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    508 false EC_NOT_SUPPORTED_SERVICE
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    509 false EC_DUPLICATED_INVOKE_ID
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1024 false EC_OR_APPCONTEXTNOTSUPPORTED
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1025 false EC_OR_INVALIDDESTINATIONREFERENCE
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1026 false EC_OR_INVALIDORIGINATINGREFERENCE
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1027 false EC_OR_ENCAPSULATEDAC_NOTSUPPORTED
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1028 false EC_OR_TRANSPORTPROTECTIONNOTADEQUATE
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1029 false EC_OR_NOREASONGIVEN
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1030 false EC_OR_POTENTIALVERSIONINCOMPATIBILITY
    • General network protocol error caused by incompatible operator network protocol versions or parameters between two network components.
    1031 false EC_OR_REMOTENODENOTREACHABLE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1152 false EC_NNR_NOTRANSLATIONFORANADDRESSOFSUCHNATURE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1153 false EC_NNR_NOTRANSLATIONFORTHISSPECIFICADDRESS
    • No Translation For This Specific Address
    1154 false EC_NNR_SUBSYSTEMCONGESTION
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1155 false EC_NNR_SUBSYSTEMFAILURE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1156 false EC_NNR_UNEQUIPPEDUSER
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1157 false EC_NNR_MTPFAILURE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1158 false EC_NNR_NETWORKCONGESTION
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1159 false EC_NNR_UNQUALIFIED
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1160 false EC_NNR_ERRORINMESSAGETRANSPORTXUDT
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1161 false EC_NNR_ERRORINLOCALPROCESSINGXUDT
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1162 false EC_NNR_DESTINATIONCANNOTPERFORMREASSEMBLYXUDT
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1163 false EC_NNR_SCCPFAILURE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1164 false EC_NNR_HOPCOUNTERVIOLATION
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1165 false EC_NNR_SEGMENTATIONNOTSUPPORTED
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1166 false EC_NNR_SEGMENTATIONFAILURE
    • Mobile subscriber was not reachable due to a network operator protocol error.
    1281 false EC_UA_USERSPECIFICREASON
    • Message was aborted by network peer because of a network protocol error.
    1282 false EC_UA_USERRESOURCELIMITATION
    • Message was aborted by network peer because of a network protocol error.
    1283 false EC_UA_RESOURCEUNAVAILABLE
    • Message was aborted by network peer because of a network protocol error.
    1284 false EC_UA_APPLICATIONPROCEDURECANCELLATION
    • Message was aborted by network peer because of a network protocol error.
    1536 false EC_PA_PROVIDERMALFUNCTION
    • Message was aborted due to other network protocol errors.
    1537 false EC_PA_SUPPORTINGDIALOGORTRANSACTIONREALEASED
    • Message was aborted due to other network protocol errors.
    1538 false EC_PA_RESSOURCELIMITATION
    • Message was aborted due to other network protocol errors.
    1539 false EC_PA_MAINTENANCEACTIVITY
    • Message was aborted due to other network protocol errors.
    1540 false EC_PA_VERSIONINCOMPATIBILITY
    • Message was aborted due to other network protocol errors.
    1541 false EC_PA_ABNORMALMAPDIALOG
    • Message was aborted due to other network protocol errors.
    1792 false EC_NC_ABNORMALEVENTDETECTEDBYPEER
    • Message was aborted due to other network protocol errors.
    1793 false EC_NC_RESPONSEREJECTEDBYPEER
    • Message was aborted due to other network protocol errors.
    1794 false EC_NC_ABNORMALEVENTRECEIVEDFROMPEER
    • Message was aborted due to other network protocol errors.
    1795 false EC_NC_MESSAGECANNOTBEDELIVEREDTOPEER
    • Message was aborted due to other network protocol errors.
    1796 false EC_NC_PROVIDEROUTOFINVOKE
    • Message was aborted due to other network protocol errors.

    USER_ERRORS (group id: 2) - general error codes

    User error occurred.

    Id Permanent Error
    2049 true EC_IMSI_BLACKLISTED
    • IMSI blocklisted
    2052 true EC_BLACKLISTED_DESTINATIONADDRESS
    • The destination number has been blocklisted either at the operator`s request or on your account via the Infobip web interface. Go to the Infobip web interface to remove the blocklist on your account or contact Support for more information.
    2053 true EC_BLACKLISTED_SENDERADDRESS
    • The sender number has been blocklisted either at the operator request or on your account via Infobip web interface. Go to the Infobip web interface to remove the blocklist on your account or contact Support for more information.
    2053 true EC_SOURCE_ADDRESS_BLACKLISTED
    • Source address is blocklisted on the Infobip account.
    4096 true EC_INVALID_PDU_FORMAT
    • Invalid PDU Format
    4099 true EC_MONTHLY_LIMIT_REACHED
    • Your account monthly credit limit has been reached. For further financial assistance, please contact your account manager.
    4100 true EC_MESSAGE_CANCELED
    • The request was received, but has not been sent to the next instance within its validity period and has expired with the appropriate error code EC_MESSAGE_CANCELED, or the same error code was reverted from the operator.
    4101 true EC_VALIDITYEXPIRED
    • The message was sent to the next instance and has not been delivered within the message validity period, thus it has expired with the appropriate error code EC_VALIDITYEXPIRED or the error code was reverted from the operator.
    4102 true EC_NOTSUBMITTEDTOSMPPCHANNEL
    • Inbound SM can not be transferred via SMPP due to the lack of SMPP connectivity.
    4103 true EC_DESTINATION_FLOODING
    • Related to status REJECTED_FLOODING_FILTER, the message is rejected due to the number of messages sent to a single number.
    4104 true EC_DESTINATION_TXT_FLOODING
    • Related to status REJECTED_FLOODING_FILTER, the message is rejected due to the number of identical messages sent to a single number.

    OPERATOR_ERRORS (group id: 3) - general error codes

    The request has not been completed due to operator issues.

    ID Permanent Error
    10 true EC_BEARER_SERVICE_NOT_PROVISIONED
    • Bearer Service Not Provisioned
    20 false EC_SS_INCOMPATIBILITY
    • SS Incompatibility
    51 true EC_RESOURCE_LIMITATION
    • Indicates that invoked MAP operation could not be finished due to the network congestion - this is an SS7 network congestion error on the MAP protocol level.
    71 false EC_UNKNOWN_ALPHABET
    • Unknown Alphabet
    501 false EC_INVALID_RESPONSE_RECEIVED
    • Invalid Response Received
    2048 false EC_TIME_OUT
    • Time Out
    2050 true EC_DEST_ADDRESS_BLACKLISTED
    • The number was found blocklisted in the DND (Do Not Disturb) blocklist provided by the operator, or the same error code was reverted by the operator.
    2051 false EC_INVALIDMSCADDRESS
    • Text blocklisted
    4097 false EC_NOTSUBMITTEDTOGMSC
    • Not Submitted To GMSC
    4102 true EC_NOTSUBMITTEDTOSMPPCHANNEL
    • Not Submitted To Smpp Channel

    Voice Error Codes

    OK (group id: 0) - voice error codes

    The request has been completed successfully.

    ID Permanent Error
    5000 true VOICE_ANSWERED
    • The call has been received and answered.
    5001 true VOICE_ANSWERED_MACHINE
    • The call has been received and answered by a voice machine.

    HANDSET_ERRORS (group id: 1) - voice error codes

    The request has not been completed due to handset related issues.

    ID Permanent Error
    5480 false EC_VOICE_ERROR_TEMPORARILY_NOT_AVAILABLE
    • Destination address is currently not available.

     


    5603 


    false         

    EC_DECLINE

    • Destination does not wish to participate in the call or cannot do so.

    OPERATOR_ERRORS (group id: 3) - voice error codes

    The request has not been completed due to operator issues.

    ID Permanent Error
    5002 true EC_VOICE_USER_BUSY
    • The end user is currently busy to receive the Voice call.
    5003 true EC_VOICE_NO_ANSWER
    • The end user received a call but didn’t answer it.
    5004 true EC_VOICE_ERROR_DOWNLOADING_FILE
    • The file specified in the HTTP request is inaccessible and could not have been downloaded.
    5005 true EC_VOICE_ERROR_UNSUPPORTED_AUDIO_FORMAT
    • The format of the file specified is not supported.
    5400 false EC_VOICE_ERROR_BAD_REQUEST
    • The received request was rejected because it wasn’t formatted correctly.
    5403 false EC_VOICE_ERROR_FORBIDDEN
    • The received request was rejected by the operator.
    5404 false EC_VOICE_ERROR_DESTINATION_NOT_FOUND
    • The server has definitive information that the user does not exist at the domain specified in the Request-URI.
    5407 false EC_VOICE_ERROR_PROXY_AUTHENTICATION_REQUIRED
    • The request requires user authentication on the operator’s end.
    5408 false EC_VOICE_ERROR_REQUEST_TIMEOUT
    • There was no coverage for a specific destination number or the end user couldn’t be found in time during the call.
    5410 false EC_VOICE_ERROR_GONE
    • The user existed once, but operator doesn’t support destination address anymore.
    5413 false EC_VOICE_ERROR_REQUEST_ENTITY_TOO_LARGE
    • Request entity-body is larger than the server is willing or able to process.
    5414 false EC_VOICE_ERROR_REQUEST_URI_TOO_LONG
    • The server is refusing to process the request because the Request-URI is longer than the server is willing to interpret (destination too long).
    5415 false EC_VOICE_UNSUPPORTED_MEDIA_TYPE
    • Format of the file is not supported.
    5484 false EC_VOICE_ERROR_ADDRESS_INCOMPLETE
    • Specified destination number is incomplete.
    5487 false EC_VOICE_ERROR_REQUEST_TERMINATED
    • Request has been terminated with a cancel button and end user refused to receive a voice call.
    5488 false EC_VOICE_ERROR_NOT_ACCEPTABLE_HERE
    • The format of the request is not acceptable on the operator’s end.
    5491 false EC_VOICE_ERROR_REQUEST_PENDING
    • Server has some pending request from the same dialog.
    5492 true EC_DUPLICATE_MESSAGE
    • The same voice message has already been sent to this destination address.
    5501 true EC_VOICE_NOT_IMPLEMENTED
    • The submitted request is not supported on the operator’s end.
    5503 true EC_VOICE_SERVICE_UNAVAILABLE
    • The service failed to complete the request.

    WebRTC Error Codes

    OK (group id: 0) - WebRTC error codes. The request has been completed successfully.

    ID Permanent Error
    5700 true ANSWERED
    • The call has been received and answered.
    5701 true EC_CALL_ANSWERED_ON_ANOTHER_DEVICE
    • The call was answered on another device.

    HANDSET_ERRORS (group id: 1) - WebRTC error codes

    The request has not been completed due to handset related issues.

    ID Permanent Error
    5720 true EC_NO_PEER_CONNECTION
    • The peer connection hasn't been established.
    5721 true EC_INVALID_DTMF_CONFIG_NO_AUDIO_TRACK
    • Invalid DTMF configuration (no audio track).
    5722 true EC_DTMF_UNAVAILABLE
    • DTMF options is not available.
    5723 true EC_DTMF_INVALID_TONE
    • Invalid DTMF tone sent. Allowed tones are digits 1-9, * and #.
    5724 true EC_NO_LOCAL_STREAM
    • Local stream was not initialized.
    5725 true EC_NO_AUDIO_TRACK
    • The audio track is missing.
    5726 true EC_NO_VIDEO_TRACK
    • The video track is missing.
    5727 true EC_NO_DISPLAY_MEDIA
    • Display media API is not available.
    5728 true EC_UNKNOWN_SCREEN_SHARE_ERROR
    • Unknown screen share error.

    USER_ERRORS (group id: 2) - WebRTC error codes

    User error occurred.

    ID Permanent Error
    5800 true EC_NO_ANSWER
    • The end user received the call but did not answer it.
    5801 true EC_USER_BUSY
    • The end user is currently busy and not able to receive the call.
    5802 true EC_PERMISSION_DENIED
    • Permission to use camera and/or microphone was denied.
    5803 true EC_DEVICE_NOT_FOUND
    • Device does not have a camera and/or microphone connected/enabled.
    5804 true EC_DEVICE_NOT_AVAILABLE
    • Camera or microphone is already in use.
    5805 true EC_ACTIVE_CALL_ON_INCOMING_CAL
    • The end user received an incoming call while they were on another active call.
    5806 true EC_CALL_TERMINATED
    • Call terminated.
    ID Permanent Error
    5850 true EC_USER_ALREADY_JOINED
    • The end user is already joined on another device.
    5851 true EC_MAX_USERS_LIMIT_REACHED
    • The maximum number of users was already reached.
    5852 true EC_VIDEO_PUBLISHERS_LIMIT_REACHED
    • The maximum number of users that are publishing a video was already reached.

    OPERATOR_ERRORS (group id: 3) - WebRTC error codes

    The request has not been completed due to operator issues.

    ID Permanent Error
    5900 true EC_FORBIDDEN
    • The received request was rejected.
    5901 true EC_REQUEST_TIMEOUT
    • There was no coverage for a specific destination number, or the end user could not be reached in time for the call.
    5902 true EC_INTERNAL_SERVER_ERROR
    • The server could not process the request because of an unexpected error.
    5903 true EC_DESTINATION_NOT_FOUND
    • The server has definitive information that the end user does not exist within the domain specified in the Request-URI.
    5904 true EC_SERVICE_TEMPORARY_UNAVAILABLE
    • The service is temporary unavailable.
    5905 true EC_REQUEST_PENDING
    • The server has a pending request from the same dialog.
    5906 true EC_ADDRESS_INCOMPLETE
    • The specified destination number is incomplete.
    5907 true EC_TEMPORARILY_NOT_AVAILABLE
    • The destination address is currently unavailable.
    5990 true EC_CONNECTION_ERROR
    • There has been a connection error.
    5991 true EC_UNKNOWN_WEBRTC_ERROR
    • There has been an unknown WebRTC error.

    Push Notification Error Codes

    Registration error (group id: 1) - push notification error codes

     

    Messages not sent due to device registration problems (e.g., in cases of uninstalled applications).

    ID Permanent Error
    8001 true EC_DEVICE_APP_UNINSTALL
    • User has uninstalled the application on device or device cloud token expired.
    8002 true EC_GCM_MISMATCH_SENDER_ID
    • FCM responded with MismatchSenderId in response error field. Sender ID is a unique numerical value created when you create your Firebase project, available in the Cloud Messaging tab of the Firebase console`s Settings panel. The sender ID is used to identify each app server that can send messages to the client app. Check your application build configuration.
    8003 true EC_NO_APPLICATION_FOUND
    • Application with provided ApplicationCode is not found at Infobip Push service. Check your message target parameters.
    8004 true EC_NO_REGISTRATION_ID_FOUND
    • Registration with provided PushRegistrationId does not exist or has expired.

    Cloud error (group id: 3) - push notification error codes

    Messages not sent due to Clouds communication issues.

    Id Permanent Error
    8005 true EC_SYS_ERROR_FROM_CLOUD
    • Failed to send push notification. Cloud (FCM or APNS) responded with error while processing the request.
    8006 true EC_INVALID_GCM_AUTH_DATA
    • Invalid cloud authentication data (Server Key). FCM responded with status 401 (Unauthorized). Check your Application configuration for Android on the Infobip web interface.
    8007 true EC_INVALID_APNS_CERT
    • Invalid certificate for APNS. Check your Application configuration for iOS on the Infobip web interface.
    8008 true EC_APPLICATION_CLOUD_TYPE_DISABLED
    • Cloud type was disabled by client for the application. Request is targeted to registration with cloud type that was disabled by the client. Check your Application configuration on the Infobip web interface.
    8009 true EC_PUSH_INTERNAL_REQUEST_ERROR
    • Internal error. Please try again later and, if the problem persists, contact Support for further assistance.
    8010 true EC_INVALID_PUSH_PAYLOAD
    • Invalid push payload data. Please contact Support for further assistance.
    8011 true EC_PUSH_INTERNAL_GW_ERROR
    • Internal error. Please try again later and if problem persists, contact Support for further assistance.
    8012 true EC_PUSH_CLOUD_TEMP_UNAVAILABLE
    • Push Cloud (FCM or APNS) is temporarily unavailable. Message is pending in retry.

    Email Error Codes

    Dropped (group id: 1) - email error codes

    The request has not been completed successfully as emails were dropped by the mail delivery system on the end-user side.

    ID Permanent Error
    6001 true EC_EMAIL_BLACKLISTED
    • The sender name used is a part of real-time database which consists of forbidden domains/sender names/IPs that are categorized as spam-friendly.
    6002 true EC_EMAILS_SPAM_CONTENT
    • Emails are dropped due to spam content.
    6003 true EC_EMAIL_UNSUBSCRIBED_EMAIL_ADDRESS
    • Got Bounced message as sender possibly is being unsubscribed by recipient.
    6004 true EC_BOUNCED_EMAIL_ADDRESS
    • Confirmation that email cannot be delivered as bounce message was reverted on the previous attempt.
    6005 true EC_EMAIL_DROPPED
    • Recipient had previously bounced, unsubscribed, or complained of spam so we will not attempt delivery and the message will be dropped.
    6016 true EC_EMAIL_SENDER_DOMAIN_BLOCKED
    • Sender domain blocked. This generally happens when the sender domain exceeds the bounce threshold.
    6017 true EC_EMAIL_IP_BLACKLISTED
    • Sender IP address is blocklisted, in which case the IP needs delisting.
    6018 true EC_INVALID_GATEWAY_REQUEST
    • There are one or more validation errors present when forming the email gateway request. Contact support.

    Bounced (group id: 2) - email error codes

    The request has not been completed successfully and we received NDR (Non-delivery receipt).

    ID Permanent Error
    6006 true EC_INVALID_EMAIL_ADDRESS
    • Sender name is not a valid one - Either invalid characters or either invalid domain was used.
    6007 true EC_MAILBOX_TEMPORARY_UNAVAILABLE
    • End-user’s mailbox might be temporarily unavailable on the server.
    6008 true EC_DEFERRED_DUE_TO_INSUFFICIENT_STORAGE
    • End-user’s mailbox has reached its full capacity defined on the server.
    6009 true EC_MAILBOX_UNAVAILABLE
    • End-user’s mailbox might have restricted access or simply does not exist on the server.
    6010 true EC_STORAGE_LIMIT_EXCEEDED
    • End-user’s mailbox has reached its full capacity defined on the server.
    6012 true EC_HARD_BOUNCE
    • We received a bounced message (Non-delivery receipt). Possible reasons: Recipient email address does not exist; Domain name does not exist; Recipient email server has completely blocked delivery.

    System Error (group id: 3) - email error codes

    The request has not been completed successfully due to system-related errors.

    ID Permanent Error
    6014 true EC_PERMANENT_SENDING_ERROR
    • Most commonly the issue lies within the domain used as the sender as it probably has not been registered yet.
    6015 true EC_EMAIL_GATEWAY_ERROR
    • Sending email failed due to internal error.

    Chat Error Codes

    (RCS, WhatsApp, Facebook messenger, LINE, Viber)

    Client error (group id: 1) - chat error codes

    The request has not been completed successfully due to application misconfiguration or a bad/invalid request issued by the client.

    ID Permanent Error
    7001 true EC_UNKNOWN_APPLICATION
    • Application used to send the message does not exist. Make sure you have created the application and that you are using a valid application key.
    7002 true EC_UNKNOWN_USER
    • Receiving user does not exist. Check that the user has subscribed to the service and that you are using the correct user key.
    7003 true EC_BLOCKED_USER
    • Receiving user has blocked communication.
    7004 true EC_UNAUTHORIZED_ACCESS
    • Invalid or unrecognized service access credentials. Make sure that you are using the correct access credentials issued by the service provider.
    7005 true EC_FORBIDDEN_ACCESS
    • Authentication was recognized, but not allowed. Check that your application is allowed to send messages, and that it is published or approved by the provider.
    7006 true EC_BAD_REQUEST
    • The received request was incomplete or invalid (invalid parameter value, consecutive spaces etc.)
    7007 true EC_ILLEGAL_TRAFIC_TYPE
    • Attempt to send a message with not allowed type.
    7008 true EC_INVALID_TEMPLATE_ARGS
    • Message does not match the template. Check template arguments and text.
    7009 true EC_INVALID_TEMPLATE
    • Template used to send the message does not exist. Make sure the template is created and that you are using a valid template.
    7010 true EC_NO_SESSION
    • User did not initiate a session and therefore cannot be contacted.
    7011 true EC_ACCOUNT_ISSUE
    • There is a problem with your account. Contact our Support team for more information.
    7012 false EC_DEPLOYMENT_CONFIGURATION_ERROR
    • Issue with WhatsApp deployment
    7013 false EC_MEDIA_HOSTING_ERROR
    • Provided media link has issues related to hosting.
    7014 false EC_MEDIA_UPLOAD_ERROR
    • Issue with media upload to provider
    7015 true EC_MEDIA_METADATA_ERROR
    • Issue with provided media metadata, content-type, size, etc.
    7016 true EC_SPAM_RATE
    • Message failed because there are restrictions (related to WhatsApp sender quality rating) on how many messages can be sent from this sender to unique end users during the rolling 24 hour period.
    7017 false EC_TOO_MANY_REQUESTS
    • Sending speed is too high
    7018 true EC_INTERNAL_BAD_MAPPING
    • Internal bad request
    7019 true EC_PROVIDER_BILLING_ERROR
    • Billing error on provider`s side (for now Viber only)
    7020 true EC_DEVICE_REPRODUCTION ERROR
    • Error displaying content on the end-user device
    7021 true EC_LIMITED_FUNCTIONALITY
    • Product functionality limited on the provider`s side.
    7022  true

    EC_MEDIA_UNSUPPORTED

    • The media format is not supported.
    7023  true

    EC_DATA_MISMATCH

    • Data mismatch between local and remotely synced source.
    7024  false

    EC_NOT_ALLOWED_SENDING_TIME

    • Message sent outsite of allowed time window.
    7025  true

    EC_UNSUPPORTED_MOBILE_APP_VERSION

    • Unsupported mobile application version.
    7026  true

    EC_MESSAGE_TYPE_EXHAUSTED

    • Supplier API limit exhausted for specific message type.
    7027 true

    EC_BLOCKED_CONTENT

    • Message content has been blocked.
    7102 true EC_DATA_MISMATCH
    • Data mismatch between local and remotely synced source.
    7201 true EC_UNSUPPORTED_DEVICE
    • The receiving user does not have a device that can receive this type of message.

     

    Provider error (group id: 2) - chat error codes

    The request has not been completed successfully due to a service provider error.

    ID Permanent Error
    7050 false EC_PROVIDER_INTERNAL_ERROR
    • Internal service provider error.
    7051 false EC_PROVIDER_TIMEOUT
    • Connection to service provider timed out.
    7052 true

    EC_PROVIDER_DR_ERROR

    • Provider error in delivery report, non-retryable due to platform limitations.

    System Error (group id: 3) - chat error codes

    The request has not been completed successfully due to a system-related error.

    ID Permanent Error
    7080 true EC_INTERNAL_ERROR
    • Internal error on the Infobip web interface. Contact Support to resolve the issue.
    7081 true EC_CONFIGURATION_ERROR
    • Internal configuration error. Contact Support to resolve the issue.
    7082 true EC_TEMPORARY_GATEWAY_ERROR
    • Temporary internal error. Contact our Support for more information.
    7083 true EC_SERVICE_NOT_ACTIVATED
    • Service not active. Contact Support to resolve the issue.
    7084 true EC_MISSING_SENDER_METADATA
    • Missing sender metadata. Contact our Support to perform the necessary adjustment.
    7280 true EC_DUPLICATE_REQUEST
    • Identical message was recently sent to the user.
    7281 true EC_BAD_ORIGIN
    • Request was sent from an unapproved origin. Contact Support to resolve the issue.

    Mobile Identity Error Codes

    ID Value Description
    100 EC_NO_COVERAGE No coverage for requested phone number.
    101 EC_GATEWAY_OPERATION_FAILED Provider service failed.
    102 EC_OPERATION_RESTRICTED Operation restricted.
    103 EC_ATP_ATTRIBUTE_QUERY_FAILED ATP attribute query failed
    200 EC_INVALID_REQUEST Validation failed for requested arguments.
    201 EC_INVALID_TOKEN The token is invalid or does not exist.
    202 EC_CONSENT_NOT_GRANTED User consent not granted.
    300 EC_MI_ACCOUNT_DISABLED User account is disabled for Mobile Identity service.
    301 EC_OPERATION_NOT_ALLOWED Service not allowed for this account.
    302 EC_COUNTRY_NOT_ALLOWED Destination country is not allowed for this account.
    303 EC_GATEWAY_NOT_ALLOWED Provider is not allowed for this account.
    304 EC_REJECTED_NOT_ENOUGH_CREDITS Not enough credits for this service.
    305 EC_MOBILE_DEVICE_TIMEOUT Timeout occurred during a mobile device redirect.
    306 EC_REJECTED_INVALID_IP_ADDRESS IP address not in MNO data range.
    1000 EC_INTERNAL_ERROR Internal error on the Infobip platform. Contact Support to resolve the issue.

    DLT Error Codes

    Applicable for the India region.

    ID Status Description
    4106 EC_BLOCKED_BY_DLT Message blocked by DLT Scrubbing.
    4 - Message sent, not delivered.
    4107 EC_DLT_SCRUBBING_TIMEOUT Timeout while performing DLT Scrubbing.
    4 - Message sent, not delivered.
    4108 EC_SENDER_BLOCKED_BY_DLT Sender blocked by DLT Scrubbing.
    4 - Message sent, not delivered.
    4109 EC_TELEMARKETER_BLOCKED_BY_DLT Telemarketer blocked by DLT Scrubbing.
    4 - Message sent, not delivered.
    4110 EC_ENTITY_BLOCKED_BY_DLT Entity blocked by DLT Scrubbing.
    4 - Message sent, not delivered.
    4111 EC_TEMPLATE_BLOCKED_BY_DLT Template blocked by DLT Scrubbing.
    4 - Message sent, not delivered.
    4112 EC_ENTITY_NOT_FOUND  No record found with EID as primary key. 
    4 - Message sent, not delivered.
    4113 EC_ENTITY_NOT_REGISTERED  No entry of entity on the platform. 
    4 - Message sent, not delivered.
    4114 EC_ENTITY_INACTIVE  Entity is inactive on the platform.               
    4 - Message sent, not delivered.
    4115 EC_ENTITY_BLACKLISTED  Entity is blacklisted on all platforms.
    4- Message sent, not delivered.
    4116 EC_INVALID_ENTITY_ID  Received wrong entity id format or no entity.
    4-Message sent, not delivered.
    4117 EC_ENTITY_ID_NOT_ALLOWED_FOR_TM Principal entity is not allowed for the TM.
    4 - Message sent, not delivered.
    4118 EC_TELEMARKETER_NOT_REGISTERED No entry of TMID on the platform.
    4 - Message sent, not delivered.
    4119 EC_TELEMARKETER_INACTIVE  Telemarketer is inactive on the platform.
    4  -Message sent, not delivered
    4120 EC_TELEMARKETER_BLACKLISTED  Telemarketer is blacklisted on all platforms.
    4 - Message sent, not delivered
    4121 EC_HEADER_NOT_FOUND  No record found with header (case sensitive).
    4 - Message sent, not delivered.
    4122 EC_HEADER_INACTIVE  Header is inactive on the platform.
    4- Message sent, not delivered.
    4123 EC_HEADER_BLACKLISTED  Header is blacklisted on all platforms.
    4 - Message sent, not delivered.
    4124 EC_PEID_NOT_MATCHED_WITH_HEADER Principle Entity Id is not matched with Header Id.
    4 - Message sent, not delivered
    4125 EC_HEADER_IN_FREEPOOL  Header in free pool. 
    4 - Message sent, not delivered.
    4126 EC_TEMPLATE_NOT_FOUND  No record found with Template Id as primary key/no template found.
    4 - Message sent, not delivered. 
    4127 EC_TEMPLATE_INACTIVE  Template is inactive on the platform.
    4 - Message sent, not delivered.
    4128 EC_TEMPLATE_BLACKLISTED  Template is blacklisted on all platforms.
    4 - Message sent, not delivered.
    4129 EC_TEMPLATE_NOT_MATCHED  Template not matched for given Template Id. 
    4 - Message sent, not delivered.
    4130 EC_HEADER_NOT_REGISTERED_FOR_TEMPLATE Header is not registered for the template.
    4 - Message sent, not delivered.
    4131 EC_TEMPLATE_VARIABLE_EXCEEDED_MAX_LENGTH Variable length exceeded the max configured length.
    4 - Message sent, not delivered.
    4132 EC_ERROR_IDENTIFYING_TEMPLATE Error in identifying the template.
    4 - Message sent, not delivered.
    4133 EC_INVALID_TEMPLATE_ID  Received wrong Template Id format or no Template Id tag.
    4 - Message sent, not delivered.
    4134 EC_TEMPLATE_NOT_REGISTERED_TO_ENTITY Template does not belong to PE.
    4 - Message sent, not delivered.
    4135 EC_PROMOTIONAL_TEMPLATE_USED_ON_OTHERS_HEADER Promotional Template used on other/transaction header.
    4 - Message sent, not delivered.
    4136 EC_INVALID_TEMPLATE_TYPE  Invalid template type. 
    4 - Message sent, not delivered.
    4137 EC_PREFERENCE_NOT_MATCHED  Blocked in preferences with MSISDN as PK.
    4 - Message sent, not delivered.
    4138 EC_INVALID_PROMO_TIME  Block promo hours (9PM to 10AM). 
    4 - Message sent, not delivered.
    4139 EC_SE_CATEGORY_BLOCK  SE category blocking on fully DND, if consent not available.
    4 - Messsage sent, not delivered.
    4140 EC_CONSENT_FAILED  General error code for Consent.
    4 - Message sent, not delivered.
    4141 EC_SCRUBBING_FAILED  General error code in case of any exceptions.
    4 - Message sent, not delivered.
    4142 EC_TLV_PEID_NOT_FOUND  TLV PEID missing/empty/null.
    4 - Message sent, not delivered.
    4143 EC_TLV_TMPID_NOT_FOUND  TLV TMPID missing/empty/null.
    4 - Message sent, not delivered.
    PAGE CONTENT

    Copyright © 2006-2021 Infobip ltd.