Login

  • Webservices Gateway Sms
  • Status codes

Status codes

While working with our API, you may find some status and error codes to detect and solve. This page cointains a list of all codes, with detailed instructions that will help you to understand and fix possible problems.

General status codes

PENDING

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

Status
PENDING_WAITING_DELIVERY

Message has been processed and sent to the next instance i.e. mobile operator with request acknowledgment from their platform. Delivery report has not yet been received and is awaited, so the status is still pending.

PENDING_ENROUTE

Message has been processed and sent to the next instance i.e. mobile operator.

PENDING_ACCEPTED

Message has been accepted and processed, and is ready to be sent to the next instance i.e. operator.

UNDELIVERABLE

The message has not been delivered.

Status
UNDELIVERABLE_REJECTED_OPERATOR

Message has been sent to the operator, whereas the request was rejected, or a delivery report with status “REJECTED” was reverted.

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

The message has successfully been processed and delivered.

Status
DELIVERED_TO_OPERATOR

Message has been successfully sent and delivered to the operator.

DELIVERED_TO_HANDSET

Message has been successfully processed and delivered to the recipient.

EXPIRED

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.

Status
EXPIRED_EXPIRED

The 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.

EXPIRED_DLR_UNKNOWN

The 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

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

Status
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 on the coverage status or set up the network in question.

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.

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.

REJECTED_SOURCE

Your account is set to accept only registered sender IDs while the sender ID defined in the request has not been registered on your account.

REJECTED_NOT_ENOUGH_CREDITS

Your account is out of credits for further submission - please top up your account. For further assistance in topping up or applying for online account top up service, you may contact your Account Manager.

REJECTED_SENDER

The sender ID has been blacklisted on your account via Gateway SMS websites portals - please remove the blacklist on your account or contact Support for further assistance.

REJECTED_DESTINATION

The destination number has been blacklisted either at the operator request or on your account via Gateway SMS websites portals - please remove the blacklist on your account via portal.Gateway SMS.com or contact Support for more information.

REJECTED_PREPAID_PACKAGE_EXPIRED

Account credits have expired past their validity period - please top up your sub account with credits to extend the validity period.

REJECTED_DESTINATION_NOT_REGISTERED

Your account has been set up for submission only to a single number for testing purposes - kindly contact your Account Manager to remove the limitation.

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.

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.

REJECTED_SYSTEM_ERROR

The request has been rejected due to an expected system error, please retry the submission or contact our technical support team for more details.

REJECTED_DUPLICATE_MESSAGE_ID

The request has been rejected due to a duplicate message ID specified in the submit request, while message IDs should be a unique value.

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 feel free to visit the below articles or contact our Support team for clarification.

User Data Header
Concatenated SMS

REJECTED_MESSAGE_TOO_LONG

Message has been received, but the total message length is more than 25 parts or message text which exceeds 4000 bytes as per our system limitation.

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.

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 in verifying number validity.