Appendix B - Error Codes for getMessageResponses

Last Updated: Thursday, July 2, 2020

Vibes Error Codes (1 - 20)

Vibes response codes indicate an error within the message request/provisioning before the message is given to the carrier. They will indicate problems with the setup, provisioning, premium support (if enabled) or carrier support for the shortcode.

Error Code	Description	Comments
1	No route found to carrier from source address.	The carrier has not been setup for this shortcode. (Being replaced, see #8).
2	~~Premium product not found for price point and source address.~~	~~The requested premium price is not a valid price point for this shortcode.~~
3	~~Carrier not configured for premium processing~~	Obsolete: Included for backwards consistency. ~~Premium is not supported for this carrier on the Shortcode.~~
4	~~Message has negative premium charge~~	Obsolete: Included for backwards consistency.
5	Message not within delivery time window.
6	Invalid delivery time window param.
7	Message stopped.	The message was stopped from being delivered. Used in extreme cases at client's request for a large number of queued messages.
8	No carrier route found for shortcode.	There is no carrier route for this shortcode (Similar to #1).
9	MDN blocked	MDN is on block list and was not delivered.
10	Multi-Part Message incomplete.	One or more parts of a Multi-part message was missing and could not be sent.
11	Vibes Internal Use.	Reserved for Vibes internal use.
12	Message capped.	This message exceeded the consumer's message amount and was capped.
13	Multi-Part Message waiting for parts.	Multi-part message expired waiting for additional parts.
14	Duplicate Multipart message.	A duplicate segment to a multi-part message was received and ignored.
15	Subscription not found.	Mobile Directory Number (MDN) was not subscribed to the requested list.
16	Shortcode Lease not found.	No shortcode lease exists for the company and shortcode.

Carrier MT Error Codes (21 - 100)

Carrier MT error codes are errors that occur during the transmission of a message to the carrier Short Message Service Center (SMSC). They indicate a failure of the carrier (SMSC) to accept the message for delivery, along with the reason for the failure. Some of these error conditions are enforced by Vibes prior to transmission and should never occur from the carrier, but the error code is included in the list for completeness.

Error Code	Description	Comments
21	Message content too long.	The maximum message length has been exceeded.
22	Message failed due to internal bind configuration error.	Contact Vibes Support to check source of configuration error.
23	Message failed due to internal error while submitting message.	A carrier-specific error has occurred. Check the specific SMPP error code, or Contact Vibes Support to check cause of the error.
24	Invalid source address (Shortcode).
25	Source address blocked.
26	Invalid destination address.	The destination Mobile Directory Number (MDN) for the message is invalid, due to the following: The MDN is not a valid subscriber on the carrier. The MDN cannot accept SMS messages. A pre-paid user account has run out of funds. The MDN account is suspended. For T-Mobile messages, this error could also be due to the following: The Subscriber is on a blocked list. They have message blocking enabled.
27	Destination address on a blocked list.	The destination MDN has been blocked by the carrier or, in certain cases, the account has been suspended or inactivated due to insufficient funds/payment.
28	Carrier message queue full.
29	Exceeded allowed Carrier throttle rates.
30	Carrier failed while delivering message due to temporary error.
31	Carrier failed while delivering message.
32	Carrier temporarily unable to route message.
33	Carrier unable to route message.
34	Carrier system unavailable.
35	Destination not opted in to receive messages from source address.
36	Invalid number of destinations.
37	Invalid distribution list name.
38	Invalid submit to distribution list.
39	Invalid number of messages.
40	Invalid scheduled delivery time.
41	Invalid Validity Period value.
42	MDN not active on the carrier network.	The MDN is not currently active based on the response code we have received from the carrier. When this error code is received, the MDN should be removed from any Subscription Lists.
100	Unknown Error while submitting to the Carrier.	Contact Vibes Support to check source of configuration error.

Carrier Delivery Receipt Error Codes (101 - 140)

Delivery Receipt error responses indicate the failure of the carrier to deliver a message to the phone. They will only be received if the message was requested to receive DLRs.

Error Code	Description	Comments
101	Carrier returned that the receipt state of the message is Unknown.	No carrier specific disposition was provided.
102	Message validity expired before the Carrier could deliver to the phone.
103	Message was deleted by the Carrier.
104	Message was undeliverable by the Carrier to the phone.
105	Message was accepted on behalf of the phone.
106	Message was rejected by the phone.
107	The MDN is not opted in for premium/subscription services.	Verizon-specific status for an MDN without an Opt-In. Not a part of the SMPP spec.
108	Carrier failed while submitting message.	Verizon-specific status. Not a part of the Short Message Peer-to-Peer (SMPP) specification. 1) Not a Verizon Subscriber. 2) Subscriber is without SMS service. 3) Subscriber is unauthorized (not opted in). 4) Content has been blocked by the Subscriber.
140	Unknown Error.	A general catch-all error when Vibes is not able to parse the status of the message returned by the carrier.