Parameters - StatusNotificationUrl

[+] More Parameters

StatusNotificationUrl

Type:String
Minimum Length:Empty
Maximum Length:2048 characters

This parameter sets the web page address that you would like delivery statuses for your outbound messages to be automatically delivered back to.

If a web page URL is given, then any delivery status received from the network operators concerning one of your outbound messages will be posted back to your URL automatically.

If you do not wish to have delivery statuses automatically returned to a nominated web page, then the statusNotificationUrl parameter should be left empty.

For each delivery status change (for messages sent by SendSMS, with statusNotificationUrl set), a string is posted back to your nominated URL in the following format:

    
        URL?destination=+447812234567&messagestatuscode=400&clientmessagereference=YourReference&messagereference=OurReference&partcurrent=1&parttotal=2
    

Where:

URL: Your URL, which must include both the name and extension of the page
destination: The handset whose delivery status has changed
messagestatuscode: The delivery status of the message for the handset in question
clientmessagereference: The reference you gave to the outbound message
messagereference: Our unique reference for your message
partcurrent: The part of the message with the delivery status change, if the message is an extended SMS
parttotal: The total number of parts to the message

Delivery statuses are grouped according to their status type, as follows:

400 - 499: Final delivery statuses, successful
500 - 599: Final delivery statuses, unsuccessful
600 - 699: Intermediate delivery statuses

messagestatuscode

Each delivery status is returned as an Integer.

  • » 400 Delivered to handset
  • » 500 Delivery failure - age verification
  • » 501 Delivery failure - billing issue
  • » 502 Delivery failure - error from operator
  • » 503 Delivery failure - expiration time exceeded
  • » 504 Delivery failure - invalid number
  • » 505 Delivery failure - message content
  • » 506 Delivery failure - message is spam
  • » 507 Delivery failure - no credit on phone
  • » 508 Delivery failure - parental content bar
  • » 509 Delivery failure - problem with handset's operator
  • » 510 Delivery failure - problem with phone
  • » 511 Delivery failure - reason unknown
  • » 512 Delivery failure - temporary problem locating handset
  • » 513 Message rejected by network
  • » 514 No delivery confirmation available
  • » 515 Destination Opted-out
  • » 516 Delivery failure - invalid originator
  • » 599 Delivery failure - reason to be clarified
  • » 600 Delivered to network
  • » 601 Sending
  • » 602 Sent to network
  • » 603 Message in transit and being retried