Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

checkSms method

It returns a string — the SMS sending status.

Principle of use

Syntax and URL to call the method
checkSms (int | string sms_id)
https://api.unisender.com/en/api/checkSms?format=json&api_key=KEY&sms_id=ID
Аргументы
api_key *API access key.
sms_id *The field code returned by the sendSms.Example:

      sms_id=2376678.79092020303
	   sms_id=3123
Return value
JSON object with a single string field status, which obtains one of the values described below. In the future, there may be new values, but the following principle will be respected: if the status starts with err_, it means that the delivery failed. If it starts with ok_, the delivery is still in progress or has been successfully completed. The only exception is the ‘not_sent’ status.
not_sentThe message has not been sent yet, and is waiting to be sent. The status will be changed after sending.
ok_sentThe message has been sent, but the delivery status is still unknown. The status is temporary and may change.
ok_deliveredThe message has been delivered. The status is final.
err_src_invalidThe delivery is not possible, the sender is set incorrectly. The status is final.
err_dest_invalidThe delivery is not possible, a wrong number is indicated. The status is final.
err_skip_letterThe delivery is impossible because the status of the phone number was changed in the process of sending, or the phone number has been removed from the list, or the letter has been deleted. The status is final.
err_not_allowedThe delivery is not possible, this communications service provider is not serviced. The status is final.
err_delivery_failedThe delivery failed — usually because of indication of a formally correct, but non-existent number, or because the phone is turned off. The status is final.
err_lostThe message has been lost, and the sender needs to re-send the message on his own, since the original has not been saved. The status is final.
err_internalInternal failure. The message needs to be re-sent. The status is final.
Examples of the return value:

{"result":{"status":"ok_delivered"}}
{"error":"AK100313-05 [invalid sms id]","code":"unspecified","result":""}