To get delivery reports, you have two options: The much more efficient and faster method is a callback directly to your server. As soon as a new status is available, your desired URL is automatically called up. The alternative method is to directly query the status of an SMS via a request to the Api. If there is no status yet, you might have to query again later. We recommend to use the callback variant. Both variants can also be combined, e.g. if the callback failed.
Status reports via callback
As an alternative to a manual query, you can set a URL in your login under Account > Developer > Webhooks, to which our server automatically sends an HTTP GET request as soon as a new status is available. In order to conserve resources and to get the current status as fast as possible, this method is preferable to the manual query.
To your URL, which can also be called via SSL, then the Get parameters
timestamp for the Msg ID, the current delivery report and its timestamp are appended.
If we could not reach your Callback URL (Timeout or HTTP Code 500), we will try again up to 6 times every hour. If you have large amounts of delivery reports, a cumulated minute-by-minute transmission of delivery reports is possible. For this please send us a message.
Do you have e.g. the following URL specified as status URL
Then we send the request e.g. so to your server:
Query delivery reports
You can use the following script to manually query the delivery report of an SMS:
|msg_id||The msg ID of the SMS. This you obtain e.g. automatically when you send SMS via the Api.|
If no errors occurs you will get the delivery report followed by a line break and the date in format YYYY-MM-DD and the timestamp with milliseconds as response in mime type text/plain.
Possible delivery reports
||The SMS was successfully delivered.|
||SMS could not be delivered. Please check the recipient number if necessary.|
||SMS was sent successfully, but was cached by the SMSC because the recipient isn’t reachable.|
||SMS was sent by the SMSC and should arrive soon.|
||SMS was accepted by the SMSC.|
||SMS was not received before the end of validity.|
||SMS was rejected by the carrier.|
||Error while sending SMS|
||Unknown status report|