SMS API Documentation

Delivery Receipts

Delivery receipts let you know whether a message has been delivered. We forward them to you by making an HTTP request to a URL of your choice.

To enable delivery receipts on your account

  1. Login to your web control panel and choose the Delivery Receipts menu option.
  2. Enter your server URL
  3. Set the Type to either HTTP Get or Form POST
  4. Click on “Use default” just under the Content box
  5. Save your settings

It takes around 30 minutes for delivery receipt changes to apply to your API account.

Parameters

Msg_ID

The mediaburst Message ID returned when you sent the message.

To

Phone number the message was sent to

Status

Delivery status of the message.

Detail

The detail code provides more information on why a message has failed. Sometimes the mobile network doesn’t provide a reason, in these cases it will be set to unknown (1).

Example

http://www.example.com/sms-dlr?
msg_id=AB_12345&status=DELIVRD&err_code=0&to=441234567890