API Examples

1. SWEDEN

In the first example we show a request for a MSISDN belonging to a Swedish Mobile Network Operator.

In the second example we show the response for a MSISDN belonging to a Swedish MVNO. Note that no MNC is present in the response, instead the IMSI starts with MCCMNC for the radio access network provider.

1.1 Request

curl -k -i -X ‘GET’ ‘https://get1.spirilookup.spirius.com:54011/v1/lookup/sweden/46731290000’
-u Username:Password -H ‘Accept application/json’

1.2 Response example 1

HTTP/1.1 200 OK
Content-Type: application/json
Content-Type: text/plain;charset=utf-8
Transfer-Encoding: chunked
Date: Fri, 27 May 2016 12:13:45 GMT
Server: 0.0.0.0
{
    "CC": "46",
    "Country": "Sweden",
    "IMSI": "",
    "MCC": "240",
    "MNC": "45",
    "Operator": "Spirius AB",
    "R": 0,
    "SPID": "G74"
}

1.3 Response example 2

HTTP/1.1 200 OK
Content-Type: application/json
Content-Type: text/plain;charset=utf-8
Transfer-Encoding: chunked
Date: Fri, 27 May 2016 12:13:45 GMT
Server: 0.0.0.0
{
    "CC": "46",
    "Country": "Sweden",
    "IMSI": "24001",
    "MCC": "240",
    "MNC": "",
    "Operator": "Svea Billing Systems AB",
    "R": 0,
    "SPID": "D46"
}

2. BASIC

2.1 Request

curl -k -i -X 'GET' 'https://get1.spirilookup.spirius.com:54011/v1/lookup/basic/46733317001'
-u Username:Password -H 'Accept application/json'

2.2 Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Type: text/plain;charset=utf-8
Transfer-Encoding: chunked
Date: Fri, 27 May 2016 12:15:44 GMT
Server: 0.0.0.0
{
    "CC": "46",
    "Country": "Sweden",
    "HLR": "OK",
    "IMSI": "240084600000000",
    "MCC": "",
    "MNC": "",
    "R": 0
}

3. ADVANCED

In the first example we show a request for a MSISDN belonging to TDC Sverige AB. Note that the IMSI start with MCC code for Denmark because this operator uses Danish SIM cards in Sweden.

In the second example we show a request for a MSISDN belonging to a MVNO. Note that no MNC is present in the response, instead the IMSI starts with MCCMNC for the radio access network provider.

3.1 Request

curl -k -i -X 'GET' 'https://get1.spirilookup.spirius.com:54011/v1/lookup/advanced/46684551000'
-u Username:Password -H 'Accept application/json'

3.2 Response example 1

HTTP/1.1 200 OK
Content-Type: application/json
Content-Type: text/plain;charset=utf-8
Transfer-Encoding: chunked
Date: Fri, 27 May 2016 12:15:44 GMT
Server: 0.0.0.0
{
    "CC": "46",
    "Country": "Sweden",
    "HLR": "OK",
    "IMSI": "23801",
    "MCC": "240",
    "MNC": "14",
    "Operator": "TDC Sverige AB",
    "R": 0
}

3.3 Response example 2

HTTP/1.1 200 OK
Content-Type: application/json
Content-Type: text/plain;charset=utf-8
Transfer-Encoding: chunked
Date: Fri, 27 May 2016 12:15:44 GMT
Server: 0.0.0.0
{
    "CC": "46",
    "Country": "Sweden",
    "HLR": "OK",
    "IMSI": "240012000000000",
    "MCC": "240",
    "MNC": "",
    "Operator": "Telavox AB",
    "R": 0,
    "SPID": "C39"
}