Verify API Troubleshooting

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

Explore the Message Logs in your Dashboard

If you run into issues with SMS or Voice message and token delivery, the best place to start troubleshooting is in the Message Logs in your 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 for Verify

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.

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

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 trouble troubleshooting the Verify 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