SMS GET JSON delivery status

GET https://api.bsms.viamobile.sk/get/delivery - Request SMS delivery status


HTTP Basic Authorization

HTTP header Value
Authorization Basic base64(username:password)
GET https://api.bsms.viamobile.sk/get/delivery?id=1 HTTP/1.1 Content-Type: text/xml;charset=UTF-8 Authorization: Basic dGVzdDp0ZXN0 Host: api.bsms.viamobile.sk

JSON Web Token (JWT) Authorization

Request JWT valid for 24 hours.
See jwt.io
GET https://api.bsms.viamobile.sk/token/create?username=test&password=test HTTP/1.1 Content-Type: text/xml;charset=UTF-8 Host: api.bsms.viamobile.sk
Parameter Required Type Description
/response/status Required Int32 Server response (200 in case of success, 4xx in case of error)
/response/jwt Required String JSON Web Token
{ "response": { "status": 200, "jwt" : "xxx.yyy.zzz" } }
1. SMS delivery

SMS delivery - request

Parameter Required Type Description
id
required int64 unique ID of sent MT SMS
jwt
Optional String JSON Web Token
GET https://api.bsms.viamobile.sk/get/delivery?id=123 HTTP/1.1 Content-Type: text/xml;charset=UTF-8 Authorization: Basic dGVzdDp0ZXN0 Host: api.bsms.viamobile.sk
GET https://api.bsms.viamobile.sk/get/delivery?id=123&jwt=xxx.yyy.zzz HTTP/1.1 Content-Type: text/xml;charset=UTF-8 Host: api.bsms.viamobile.sk

Response

Parameter Type Description
id
int64 unique ID of sent MT SMS
received timestamp delivery report timestamp
status string(50) delivered - message delivered, undeliverable - message not delivered, waiting - waiting for status, expired - message not delivered/expired
operator int32 Operator code - 23101 Orange SK, 23102 Telekom SK, 23103 4rka SK, 23106 O2 SK, 23000 CZ, 0 others
price decimal Message price (Message can be divided into several multipart SMSs). null, if price not configured.
parts int32 Count of multipart SMSs.
{ "response": { "status": 200, "delivery": [ { "id": 123, "received": "2014-02-01 22:59:00", "status": "delivered", "operator": 23101, "price": 0.03, "parts": 1 } ] } }