Fetching MT Delivery Reports
You may receive a delivery report for an MT that was sent through the Sumotext API. This report indicates if the message corresponding to smsid was successfully delivered, and if it wasn't, gives a reason why.
URL
https://mosms.sumotext.com/secure/sumoReport.aspx?Request Parameters
| Param | Description |
|---|---|
smsid |
Unique smsid returned when sending the MT. |
shortcode |
Short code used. |
Sample Request
https://mosms.sumotext.com/secure/sumoReport.aspx?smsid=ACAEEBE7-DFC3-4837-8E49-AAEB04D6E9E0&shortcode=74700
Response Fields
The response data comes as a string delimited by a ':' (colon).
{smsid}:{sent-status}:{true/false message}| Field | Description |
|---|---|
smsid |
Unique ID for the SMS |
sent-status |
TRUE if sent, FALSE otherwise |
true/false message |
Message describing the sent status |
The first line of the response contains this string. You may ignore the lines that follow (they contain the html markup that would call this method from a browser).
Error Response
If your message didn't send, your response will come in the form
{smsid}:FALSE:{false message}If the smsid is not found, your response will be
{smsid}:NOTFOUND:[single space char]NOTE: There is a single space character after the second colon.
True Messages
- Sent by Sumotext to Aggregator.
- Message successfully delivered to handset.
- Message successfully sent to carrier.
False Messages
- Failed. We are unable to delier this message.
- Not Delivered, Billing failed, Billing.
- Not Delivered, Invalid destination, Destination permanent.
- Not Delivered, Invalid source address, Source.
- Not Delivered, No Information, No information.
- Not Delivered, System failure, System failure.
- EXPIRED: We are unable to deliver this message.
- FAIL: We are unable to deliver this message.
- FAILED: We were unable to send this to aggregator.
- UNDELIV: We are unable to deliver this message.