Understanding Reasons of SMS Non-delivery

A message becomes Undelivered when it fails Unifonic validation or when the mobile operator returns a delivery receipt indicating that the device did not receive it. Use the error code and failure description to identify the cause.

Non-delivery error codes

Error codeError messageExplanation
ER-01No rate found or insufficient fundsThe account balance is insufficient or the required country package is missing.
ER-02Invalid destination numberThe recipient number failed validation and may be formatted incorrectly.
ER-03Invalid destination number (too long)The number contains more digits than expected for the country and operator.
ER-04Invalid destination number (too short)The number contains fewer digits than expected for the country and operator.
ER-05No route found for the destination numberThe number may be unknown or inactive, the device may not support SMS—for example, a landline—or the mobile operator may have an issue.
ER-06Invalid or empty message bodyThe message body is empty or contains no readable text.
ER-07Message filteredUnifonic or the operator blocked content that may violate operator guidelines.
ER-08Invalid Sender IDThe Sender ID is not registered, or the operator terminated its registration.
ER-09Duplicated messageThe message duplicates a recent message with the same content to the same recipient, contrary to operator guidelines.
ER-10timeScheduled parameter invalid or missingThe timeScheduled parameter must be valid and specify a future time.
ER-11Invalid message body (too long)The message is too long to deliver.
ER-12Message validity period is expiredThe customer-defined validity period expired before delivery.
ER-13Destination country not allowedThe recipient country is blocked for the account or Sender ID by geo-permissions.
ER-14Destination is in blacklistThe recipient number is on the blacklist.
ER-99Unknown errorThe operator returned a generic error without details, or Unifonic experienced a temporary internal failure. Check status.unifonic.com for incidents. Contact Customer Support if the error continues.