HLR JSON

Endpoint: https://api.bsms.viamobile.sk/hlr/json


HTTP Basic Auth

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

Error codes

Kód Popis
1000 Unauthorized Unknown username or password
{ "response": { "status": 401, "code": 1000, "description": "Unauthorized" } }
HLR sync

Request

Parameter Required Type Description
msisdn
Required Int64 Recipient MSISDN in international format without + or 00. E.g. 421903123456
GET https://api.bsms.viamobile.sk/json/hlr?msisdn=421903123456 HTTP/1.1 Content-Type: text/xml;charset=UTF-8 Authorization: Basic dGVzdDp0ZXN0 Host: api.bsms.viamobile.sk

Response

Parameter Required Type Description
/response/status Required Int32 Server response (200 in case of success, 4xx in case of error)
/response/hlr-status Required String VALID
UNKNOWN
INVALID-NUMBER
UNKNOWN-NUMBER
ABSENT-NUMBER
TELESERVICE-UNKNOWN
CALL-BARRED
NOT-SUPPORTED
/response/msisdn Required Int64 MSISDN from request
/response/mccmnc Required Int32 MCC + MNC operator code
{ "response": { "status": "200", "hlr-status": "VALID", "msisdn": 421903123456, "mccmnc": 23102 } }