Eazita Developers

SMS API: Delivery Reports

Check message delivery status.

Request URL

https://api.eazita.com/sms/delivery

Query Parameter

KeyDescriptionDefault
api
REQUIRED | string
Your API keyNone
pass
REQUIRED | string
Your account passwordNone
messageid
integer
Unique Message-ID to retrive report of a specific message.None
contents
string
Extra contents of the message to retrive with report, seperated by a comma.
Valid parameters are body, gsm, charset and source.
Example: contents=body,gsm,charset,source
None

Example

https://api.eazita.com/sms/delivery?api=YOUR_API_KEY&pass=YOUR_PASSWORD

Response Example

HTTP/1.1 200 OK
Content-Type: application/json
{
    "code": 1,
    "data": [
        {
            "message_id": 569399,
            "status": "SENT",
            "price": "0.003",
            "network": "Zong",
            "country_code": "92",
            "done_date": "2018\/03\/25 19:10:27",
            "sent_date": "2018\/03\/25 19:10:24",
            "error_code": "0",
            "reference": "my-msg-reference"
        },
        {
            "message_id": 569398,
            "status": "SENT",
            "price": "0.003",
            "network": "Zong",
            "country_code": "92",
            "done_date": "2018\/03\/25 19:08:40",
            "sent_date": "2018\/03\/25 19:08:37",
            "error_code": "0",
            "reference": "my-msg-reference"
        },
        {
            "message_id": 564743,
            "status": "FAILED",
            "price": "0.003",
            "network": "Zong",
            "country_code": "9292",
            "done_date": "2018\/03\/06 17:45:48",
            "sent_date": "2018\/03\/06 17:45:34",
            "error_code": "8",
            "reference": null
        },
        {
            "message_id": 564581,
            "status": "DELIVERED",
            "price": "0.004",
            "network": "Zong",
            "country_code": "92",
            "done_date": "2018\/03\/05 17:40:48",
            "sent_date": "2018\/03\/05 17:40:48",
            "error_code": "0",
            "reference": null
        }
    ]
}

Message Status

ValueMeaning
SUBMIT
There is no error, Returns when the message is queued.
PENDING
The message has been sent and waiting to be delivered.
DELIVERED
The message has been delivered.
SENT
The message has been sent, but there is no delivery report.
REJECTED
The message has been rejected.
EXPIRED
The message has been expired, because we did not received the status on time.
NOT_DELIVERED
The message was not delivered.
FAILED
A network failure while sending your message.
NOT_ALLOWED
Carriers often apply restrictions that block messages following different criteria. For example, on SenderID or message content.

Message Error Codes

CodeError
0
There is no error, Mostly returned when the message is queued.
101
The phone number you supplied is invalid.
102
The phone number you have supplied doesn't support messages.
103
A network failure while sending your request.
104
Your account does not have sufficient credit to process this message.
105
There was an error in processing your message.
500
Your message has been failed, no reason has been specified.