1. Home
  2. Gateway
  3. HTTP Api
  4. Delivery reports

Delivery reports

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 msg_id, status and 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:


Parameter Description
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.



2020-01-09 15:41:30.656

Possible delivery reports

Delivery report Description
DELIVERED The SMS was successfully delivered.
NOTDELIVERED SMS could not be delivered. Please check the recipient number if necessary.
BUFFERED SMS was sent successfully, but was cached by the SMSC because the recipient isn’t reachable.
TRANSMITTED SMS was sent by the SMSC and should arrive soon.
ACCEPTED SMS was accepted by the SMSC.
EXPIRED SMS was not received before the end of validity.
REJECTED SMS was rejected by the carrier.
FAILED Error while sending SMS
UNKNOWN Unknown status report
Was this article helpful to you? Yes No 1