Message Sending Response Codes
Status codes
Basing on https://admin.smartmessagingservices.net/wiki/download/attachments/12386334/SMSPL-SW-807-MCOR-0001+-+Web+Services+API+-+V1.06.2.pdf?version=1&modificationDate=1337252411000 and https://admin.smartmessagingservices.net/wiki/display/MC4API/Web+Service+to+query+status. Some status codes are omitted as they can't (yet) occur in our application.
statusCode return in Message submit for message Final Status
Status code | Priority | Final | Meaning | When? |
|---|---|---|---|---|
0 | 1 | N | Unknown | Message with the given id not found. It is possible that the message was submitted, but not yet processed by a worker. Or that such a message doesn't exist. |
| 2 | 9 | Y | Delivered | Message was sent and Delivery Receipt was received |
| 3 | 6 | Y | Expired | Message delivery failed and message expired (SMSC will no longer try to deliver it) |
| 4 | 2 | Y | Deleted | Message was deleted by SMSC |
5 | 4 | Y | Undeliverable | Message undeliverable as determined by SMSC |
| 8 | 5 | Y | Rejected | Message rejected by SMSC |
| 10 | 7 | N | Submitted | Last event is "request received". Not yet routed. May be temporarily unroutable. |
11 | 8 | N | Sent | Last event is "sent" |
| 12 | 3 | Y | Not deliverable | Last event is "unroutable". There's no bind (even among inactive ones) that can accept the message. |
Priority relates to the status returned when a single message sent to us is longer than 160 characters and is sent as multiple parts to the SMSC making it possible for each message part to have a different status.
If message parts have different statuses, the status returned in the query process will be the lowest priority status within the relevant message parts. It is possible for one message part to show as delivered while the others show as sent. A multipart message will not display on a handset until all message parts are delivered so the valid total message status is sent and this is what your message status query will return. You can log into the user web application on MC5 and view the status of the individual message parts as each Outbound message to the SMSC shows as a separate entry in the SMS Out Volume Report
messageStatus returned for Message Submit indicating status of the submit.
Status code | Final | Meaning | When? |
|---|---|---|---|
| 11 or 10 | N | Acceptance Status Code | Message Submit Accepted |
-101 | Y | No username | |
-102 | Y | No password | |
| -103 | Y | Recipient Opted Out | |
| -104 | Y | Invalid recipient | Recipient number invalid - validation rules - numeric length: 3-13 inclusive |
| -105 | Y | Invalid source | Sender number invalid - No Sender Exist with this Source Address or number is outside range 3-13 characters |
| -106 | Y | Empty text | Empty Message Content - For SMS means no message Text was supplied. For MMS means that both the body text and image content are null; |
| -107 | Y | Two Many Destinations in the Destinations list | Max 50 Destination Address Allowed. |
| -108 | Y | Invalid Request | Request has parameter no in request structure, Request parameter value is not the correct type, |
| -109 | Y | No MMS Pricing Configured | For MMS messages only. |
| -110 | Y | Unsupported Media File Type | For MMS messages only |
| -111 | Y | No Valid Recipients | Either recipients where not provided in the call or every recipient failed the validation process |
| -112 | Y | Message Exceeds Max Size | |
| -113 | Y | Media exceeds maximum size of 1.95Mb | |
| -130 | Y | Customer Not Found | Customer record disabled or not found for Sender |
-200 | Y | Invalid username/password | Last event: "invalid username/pass" |
-201 | Y | User disabled | Last event: "user disabled" |
-210 | Y | Insufficient credits | Last event: "no credits" for prepaid accounts only |
| -230 | Y | Document ID not matched | User does not have rights to check message status |
-910 | Y | SMSC error | Last event: "send failure" |
-999 | Y | Internal error |