Number Lookup Use Cases

This page provides details about available use cases for the Number Lookup HTTP REST API. You can use the examples provided here to build more complex applications. The use cases described include:

Retrieve Details About a Number. – Get carrier information for a phone number.
Look up Multiple Numbers. – Get carrier information for multiple phone numbers.
Find Details About a Roaming Number. – Retrieve carrier information for a roaming number.
Look up an Absent Number. – Find out why a phone number is absent.

All use cases for the HTTP REST API work with Mitto’s authentication method where you send your key in the request header or the URL call. For more information, refer to the Authentication section.

If you want to see the Number Lookup product page, go here: https://www.mitto.ch/products/mobile-intelligence/

NOTE: GET and POST are not available for all use cases that feature CURL.

Retrieve Details About a Number

You can retrieve details about a phone number using its Mobile Station International Subscriber Directory Number (MSISDN).

curl 'https://api.mitto.ch/lookup.json?key=YourApiKey&msisdn=491725551234'

curl -X POST \ 'https://api.mittoapi.ch/lookup.json' \ -H 'Content-Type: application/json'\ -H 'X-Mitto-API-Key: Xdqnjeewea' \ -d '{ "msisdn": "491725551234" }'

Response for HTTP REST API

[ { “msisdn”: “491725551234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:16:42Z”, “response”: 0 } ] [ { “msisdn”: “491725551234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:16:42Z”, “response”: 0 } ]

Look up Multiple Numbers

You can look up multiple phone numbers with a single request.

curl 'https://api.mitto.ch/lookup.json?key=YourApiKey&msisdn=491725551234, 491725561234'

curl -X POST \ 'https://api.mittoapi.ch/lookup.json' \ -H 'Content-Type: application/json'\ -H 'X-Mitto-API-Key: Xdqnjeewea' \ -d '{ "msisdn": ["491725551234", “491725561234”] }'

Response for HTTP REST API

[ { “msisdn”: “491725551234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:54:04Z”, “response”: 0 }, { “msisdn”: “491725561234”, “mcc”: “262”, “mnc”: “03”, “ported”: true, “portedNetwork”: { “networkName”: “E-Plus”, “countryName”: “Germany”, “countryPrefix”: “49” }, “originalMnc”: “02”, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:54:05Z”, “response”: 0 } ] [ { “msisdn”: “491725551234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:54:04Z”, “response”: 0 }, { “msisdn”: “491725561234”, “mcc”: “262”, “mnc”: “03”, “ported”: true, “portedNetwork”: { “networkName”: “E-Plus”, “countryName”: “Germany”, “countryPrefix”: “49” }, “originalMnc”: “02”, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “cost”: 0.0017, “date”: “2016-04-01T10:54:05Z”, “response”: 0 } ]

Find Details About a Roaming Number (GET)

Roaming refers to the ability for a subscriber to use their phone as normal when traveling outside their home network. You may want to retrieve subscriber details for a roaming number.

CURL (GET)

curl 'https://api.mitto.ch/lookup?key=YourApiKey&msisdn=491725571234'

Response for HTTP REST API

[ { “msisdn”: “491725571234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “roaming”: true, “roamingMcc”: “234”, “roamingMnc”: “33”, “roamingNetwork”: { “networkName”: “Orange”, “countryName”: “United Kingdom”, “countryPrefix”: “44” }, “msc”: “44555666777”, “imsi”: “26202040XXXXXXX”, “absent”: false, “cost”: 0.0017, “date”: “2016-04-01T11:45:03Z”, “response”: 0 } ] [ { “msisdn”: “491725571234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “roaming”: true, “roamingMcc”: “234”, “roamingMnc”: “33”, “roamingNetwork”: { “networkName”: “Orange”, “countryName”: “United Kingdom”, “countryPrefix”: “44” }, “msc”: “44555666777”, “imsi”: “26202040XXXXXXX”, “absent”: false, “cost”: 0.0017, “date”: “2016-04-01T11:45:03Z”, “response”: 0 } ]

Look up an Absent Number (GET)

An absent number is unreachable or out of network coverage area. This might be because the phone is off, outside its coverage area, or due to roaming restriction rules.

CURL (GET)

'https://api.mitto.ch/lookup?key=YourApiKey&msisdn=491725581234'

Response for HTTP REST API

[ { “msisdn”: “491725581234”, “mcc”: “262”, “mnc”: “02”, “ported”: false, “originalNetwork”: { “networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49” }, “absent”: true, “cost”: 0.0017, “date”: “2016-04-01T11:36:31Z”, “response”: 0 } ]

[
{
“msisdn”: “491725581234”,
“mcc”: “262”,
“mnc”: “02”,
“ported”: false, “originalNetwork”: {
“networkName”: “Vodafone”, “countryName”: “Germany”, “countryPrefix”: “49”
},
“absent”: true, “cost”: 0.0017,
“date”: “2016-04-01T11:36:31Z”,
“response”: 0
}
]