Errors

In this guide, we will talk about what happens when something goes wrong. Mistakes happen. Let's look at some status codes and error types you might encounter.

You can tell if your request was successful by checking the status code when receiving an API response. If a response comes back unsuccessful, you can use the error type and error message to figure out what has gone wrong and do some rudimentary debugging (before contacting support).

SMS DLR Error Codes

Here is a list of the different categories of status codes returned. Use these to understand if a request was successful.

SMS DLR CODESTATUS DESCRIPTION
UNDELIV err:0dcAbsent Subscriber
EXPIRED err:206Absent Subscriber
EXPIRED err:21bAbsent Subscriber
UNDELIV err:21bAbsent Subscriber
EXPIRED err:023Absent Subscriber
EXPIRED err:027Absent Subscriber
EXPIRED err:053Absent Subscriber
EXPIRED err:054Absent Subscriber
UNDELIV err:058Absent Subscriber
UNDELIV err:439Absent subscriber or ported subscriber or subscriber is barred
UNDELIV err:254Subscriber's phone inbox is full
EXPIRED err:254Subscriber's phone inbox is full
EXPIRED err:220Subscriber's phone inbox is full
EXPIRED err:120Subscriber's phone inbox is full
REJECTD err:008Subscriber's phone inbox is full
UNDELIV err:255Invalid or inactive mobile number or subscriber's phone inbox is full
UNDELIV err:20bInvalid or inactive mobile number
UNDELIV err:004Invalid or inactive mobile number
UNDELIV err:510Invalid or inactive mobile number
EXPIRED err:215Invalid or inactive mobile number
EXPIRED err:20dSubscriber is barred on the network
UNDELIV err:130Subscriber is barred on the network
UNDELIV err:131Subscriber is barred on the network
EXPIRED err:222Network operator system failure
EXPIRED err:602Network operator system failure
EXPIRED err:306Network operator system failure
UNDELIV err:032Network operator system failure or operator not supported
UNDELIV err:008Subscriber is on DND
UNDELIV err:085Subscriber is on DND
UNDELIV err:065Message content or senderID is blocked on the promotional route
UNDELIV err:600Message content or senderID is blocked on the promotional route
EXPIRED err:40aSenderID not whitelisted on the account
UNDELIV err:082Network operator not supported
UNDELIV err:00aSenderID is restricted by the operator
EXPIRED err:078Restricted message content or senderID is blocked.
UNDELIV err:432Restricted message content or senderID is blocked.

USSD Error Codes

Error codes for Ussd Inbound Callback Here is a list of the error types for USSD code

ERROR CODEERROR DESCRIPTION
E-410Insufficient funds on the USSD code account.
E-420Client callback URL unreachable or timeout.
E-430Client callback URL returned bad or unexpected response.
E-424Client callback URL returned bad or unexpected response.

Was this page helpful?