SMS API Troubleshooting

MessageBird offers multiple tools to help you to quickly understand any unexpected behavior between the MessageBird SMS API and your application.

Explore the SMS logs in the Dashboard

If you run into issues with SMS message delivery, the best place to start troubleshooting is the SMS Logs in the MessageBird Dashboard.

Message Logs

There you can find an overview of the sent and received messages for the last 30 days, and you can export messages older than 30 days.

Select the eye symbol on the far right side of the logs to drill into each specific message for information such as ID, Originator, Send Time, Message, and Summary.

You can filter the SMS logs by Status (e.g., filter by undelivered) using the Filter button on the top-right.

SMS error codes

If you've received an error response and code from MessageBird, you can troubleshoot the error by exploring the SMS Error Codes below.

The SMS Error codes, or extended error codes, are in addition to the base states we're reporting to a client. These codes are reported as part of the HTTP status report or in the SMPP deliver_sm delivery report.

Error CodeError Code DescriptionIntermediate or Permanent Status
0EC_NO_ERRORN/A
1EC_UNKNOWN_SUBSCRIBERPermanent
2EC_UNKNOWN_BASE_STATIONPermanent
3EC_UNKOWN_MSCIntermediate
5EC_UNIDENTIFIED_SUBSCRIBERIntermediate
7EC_UNKNOWN_EQUIPMENTIntermediate
8EC_ROAMING_NOT_ALLOWEDIntermediate
9EC_ILLEGAL_SUBSCRIBERPermanent
10EC_BEARERSERVICE_NOT_PROVISIONEDIntermediate
11EC_TELESERVICE_NOT_PROVISIONEDIntermediate
12EC_ILLEGAL_EQUIPMENTIntermediate
13EC_CALL_BARREDIntermediate
21EC_FACILITY_NOT_SUPPORTEDIntermediate
26EC_SUBSEQUENT_HANDOVER_FAILUREIntermediate
27EC_ABSENT_SUBSCRIBERIntermediate
28EC_ABSENT_SUBSCRIBER_NO_PAGEIntermediate
29EC_ABSENT_SUBSCRIBER_IMSI_DETACHEDIntermediate
30EC_CONTROLLING_MSC_FAILUREIntermediate
31EC_SUBSCRIBER_BUSY_FOR_MT_SMSIntermediate
32EC_SM_DELIVERY_FAILUREIntermediate
33EC_MESSAGE_WAITING_LIST_FULLIntermediate
34ECSYSTEM_FAILURE1Intermediate
35ECDATA_MISSING1Permanent
36ECUNEXPECTED_DATA_VALUE1Permanent
37ECSYSTEM_FAILURE2Permanent
38ECDATA_MISSING2Permanent
39ECUNEXPECTED_DATA_VALUE2Permanent
40ECUNEXPECTED_DATA_VALUE2Intermediate
71EC_UNKNOWN_ALPHABETPermanent
72EC_USSD_BUSYIntermediate
101EC_SUBSCRIBER_INSUFFICIENT_BALANCEIntermediate

Via SMPP

The network_error_code TLV and the err parameter in a DLR’s short_message contains a number that references a specific error.

Via HTTP

The error code is reported as value of the statusErrorCode variable. This variable is only given when the data is available.

General API error codes

If you've received an error response and code from MessageBird that's not listed in the above SMS Error Codes list, you can troubleshoot the error by exploring the general API Error Codes.

In case of an API error, the body of the response includes a json formatted response that tells you exactly what's wrong.

Contact technical support

If you’re still having problems troubleshooting the SMS API, please don’t hesitate to contact us at support@messagebird.com; we're here to help you out.

Questions?

We’re always happy to help with code or other doubts you might have! Check out our Quickstarts, API Reference, Tutorials, SDKs, or contact our Support team.

Cookie Settings