Base statuses
Status code | Priority | Final | Meaning | When? |
---|---|---|---|---|
0 | 1 | N | Unknown |
A message with the given id was 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. | ||||
1 | N | Rerouting | The message was impossible to deliver to given supplier and has to be routed again. | |
2 | 9 | Y | Delivered |
The message was sent and the Delivery Receipt was received as sent to |
us by the Mobile Network | ||||
3 | 6 | Y | Expired | Message delivery failed and the message expired (SMSC will no longer try to deliver it) as notified |
by Mobile Network | |||
4 | 2 | Y | Deleted |
The message was deleted by the Mobile Network | ||||
5 | 4 | Y | Undeliverable | Message undeliverable as determined by Mobile Network |
8 | 5 | Y | Rejected | Message rejected by Mobile Network |
9 | - | Y | Failed to charge sender | Failed to change MMS message sender |
10 | 7 | N | Submitted | Send request received from the customer but not yet routed and sent to a mobile network. May be temporarily unroutable due |
to inactive outbound bind. | |||
11 | 8 | N | Sent |
The message has been sent to the mobile network - delivery notification has not yet been received. | ||||
12 | 3 | Y | Not deliverable | There's no Routing defined for the destination address to send the message to the mobile network. |
13 | 4 | Y | OA Whitelist | Origin Address whitelist validation failed |
14 | 4 | Y | Content filter block |
The message has been blocked by the content filter | ||||
15 | 4 | Y | Invalid content | Message content does not include the originator's name |
16 | - | N | Submitted to outbound | MMS message |
sent from worker to MMS |
outbound |
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
Validation failure status codes
Status code | Final | Meaning | When? | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
-101 | Y | No username | No username was provided in the request | ||||||||
-102 | Y | No password | No password was provided in the request | ||||||||
-103 | Y | No document id | |||||||||
-104 | Y | Invalid recipient | Recipient number invalid - validation rules - numeric length: 8-16 inclusive | ||||||||
-105 | Y | Invalid source | Sender number invalid - did not meet validation rules - in the system - hardcoded So for example alpha <2, 11>, digit < 3, 16> | ||||||||
-106 | Y | Empty text | The SMS text was empty | ||||||||
-107 | YMissing reply to or sender | Text is too long | The SMS text is too long | ||||||||
-108 | YBoth reply to and sender provided | Empty request | The MMS request empty | ||||||||
-109 | Y | Invalid rotation algorithm provided | Available algorithms are: max_rotation, conversation | ||||||||
-110 | Y | Invalid encoding name | Available encodings are e.g. "utf-16", "gsm", "iso-8859-1" etc. (see Send Single Message) | ||||||||
-111 | Y | Text is too long | SMS text is too long | -113 | Y | Empty request | MMS request empty | -114 | Y | Past scheduled data | Scheduled The scheduled date of the MMS message is in the past |
-116112 | Y | Max delay exceeded | Scheduled The scheduled date of MMS exceeds the availability period of the attachment | ||||||||
-200 | Y | Invalid username/password | Last event: "invalid Invalid username/pass" | ||||||||
-201 | Y | User disabled | Last event: "user User disabled" | ||||||||
-202 | Y | User blocked | Last event: "user User blocked" | ||||||||
-203 | Y | Password expired | User The user tried to login log in with expired an password | ||||||||
-210 | Y | Insufficient credits | Last event: "no No credits" | ||||||||
-230 | Y | Document ID not matched | User The user does not have the rights to check the message status | ||||||||
-240 | Y | Invalid (not supported) replyTo value |
Auth (JWT)
Status code | Final | Meaning | When? |
---|---|---|---|
-400 | Y | Invalid Request | |
-401 | Y | Invalid Payload |
Attachments
Status code | Final | Meaning | When? |
---|---|---|---|
-500 | Y | Not accessible | Attachment manger The attachment manager cannot be reached |
-501 | Y | Invalid attachments | Either the attachment is not available or there was the an upload problem |
-502 | Y | Missing attachments | Attachment not found |
-503 | Y | Too many attachments | Attempt to send more attachments in a single request then than allowed |
-504 | Y | Unknown Error | Generic error for anything unexpected |
-800505 | Y | Invalid user id | Invalid user id in attachment manger manager request |
-801506 | Y | Invalid customer id | Invalid customer id in attachment manger manager request |
-802507 | Y | Non existing attachments | Attachment does not exist |
-803508 | Y | Attachment retention period exceeded | Scheduled The scheduled date of MMS exceeds the availability period of the attachment |
-804509 | Y | Attachment processing error | One of several errors occurred while processing the attachment - the response message should have more info |
-805510 | Y | Attachment not available on dateAttachment | The attachment will not be available on a specific date |
Errors
Status code | Final | Meaning | When? |
---|---|---|---|
-910 | Y | SMSC error | Last event: "send failure" Send failure |
-999 | Y | Internal Error |
Incoming Message
Status code | Final | Meaning | When? |
---|
101 | Y | Received | Received incoming SMS |
102
Retrieved
103 | Y | Sent error | Failed to reply SMS |
104 | Y | Forwarded | Successful replay SMS |
105 | Y | Dropped | Dropped processing of |
SMS message |