Check the status of a submitted message

Endpoint URL

The end-point for sending SMS via HTTP (POST) calls is the following:

curl example

curl --location --request POST '' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'apitoken=7ace3e49cae13ae4f5ccb8a6a8a0d6a8fe120aa82ae46ad6ee4c9d8' \
  --data-urlencode 'smsids=20817547,20818326'



a unique hash code for each account that authorizes each web request. That code you can find it on your account’s page


supply the SMS id(s) of the already submitted message(s). You may use one of the following delimiters, between SMS ids, in case you want to provide more than one message: ,.^

Error Response

In case of error, the result could be like the following:

Error: <Error code> - <Error message>


<Error code>

is the request’s error code as shown below

<Error message>

is the error message, describing the problem with the request

Successful Response

and in case of success, for one message, the result would be in the form of:

<SMSId>:<Submtited On>:<Last status datetime>:<Destination number>:<Status number>:<Status text>:<Quantity of SMS>:<Charge amount>

For example:


For the case you want the status for more than one messages, you will be returned with the results delimiter with character |, for example:


Description of result fields



SMSId Integer

the sms id

Submited On (Integer)

the date and time of the message’s submission

Last status datetime (Integer)

the datetime of the last status of message

Destination number (String)

the cell’s number

Status number (Integer)

the numeric status code (*)

Quantity of SMS (Integer)

how many SMS are consumed for the message

Charge amount (Float)

the total charge of the message