Close mobile menu
HomeProgrammable SMSProgrammable VoiceText To SpeechVerifyConversationsBetaNumbersBetaLookupMMSHLRReportingBetaBalanceContactsGroups

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
0
EC_NO_ERRORN/A
1
EC_UNKNOWN_SUBSCRIBERPermanent
2
EC_UNKNOWN_BASE_STATIONPermanent
3
EC_UNKOWN_MSCIntermediate
5
EC_UNIDENTIFIED_SUBSCRIBERIntermediate
7
EC_UNKNOWN_EQUIPMENTIntermediate
8
EC_ROAMING_NOT_ALLOWEDIntermediate
9
EC_ILLEGAL_SUBSCRIBERPermanent
10
EC_BEARERSERVICE_NOT_PROVISIONEDIntermediate
11
EC_TELESERVICE_NOT_PROVISIONEDIntermediate
12
EC_ILLEGAL_EQUIPMENTIntermediate
13
EC_CALL_BARREDIntermediate
21
EC_FACILITY_NOT_SUPPORTEDIntermediate
26
EC_SUBSEQUENT_HANDOVER_FAILUREIntermediate
27
EC_ABSENT_SUBSCRIBERIntermediate
28
EC_ABSENT_SUBSCRIBER_NO_PAGEIntermediate
29
EC_ABSENT_SUBSCRIBER_IMSI_DETACHEDIntermediate
30
EC_CONTROLLING_MSC_FAILUREIntermediate
31
EC_SUBSCRIBER_BUSY_FOR_MT_SMSIntermediate
32
EC_SM_DELIVERY_FAILUREIntermediate
33
EC_MESSAGE_WAITING_LIST_FULLIntermediate
34
ECSYSTEM_FAILURE
1
Intermediate
35
ECDATA_MISSING
1
Permanent
36
ECUNEXPECTED_DATA_VALUE
1
Permanent
37
ECSYSTEM_FAILURE
2
Permanent
38
ECDATA_MISSING
2
Permanent
39
ECUNEXPECTED_DATA_VALUE
2
Permanent
40
ECUNEXPECTED_DATA_VALUE
2
Intermediate
71
EC_UNKNOWN_ALPHABETPermanent
72
EC_USSD_BUSYIntermediate
101
EC_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.

Cookie Settings