Number Lookup Use Cases

Number Lookup Use Cases – ENUM

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

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).

dig @185.124.68.123-p 5353 IN NAPTR 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa

Response for ENUM API

The Number Lookup reply to the command will be (full response):

; <<>> DiG 9.8.4-rpz2+rl005.12-P1 <<>> @185.124.68.123 -p 5353 IN NAPTR 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 42283
;; flags: rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; QUESTION SECTION:
; 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa. IN NAPTR

;; ANSWER SECTION:
491725551234. 1 IN NAPTR 0 0 “u” “E2U+SIP”
“!^.*$!sip:+491725551234@ims .mnc02.mcc262.3gppnetwork. org\;cost=0.002200000000\;ported=0\;user=phone!” .

;; Query time: 30 msec
;; SERVER: 185.124.68.123#5353(185.124.68.123)
;; WHEN: Thu Mar 31 16:47:51 2016
;; MSG SIZE rcvd: 172
; <<>> DiG 9.8.4-rpz2+rl005.12-P1 <<>> @185.124.68.123 -p 5353 IN NAPTR 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 42283
;; flags: rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
; 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa. IN NAPTR

;; ANSWER SECTION:
491725551234. 1 IN NAPTR 0 0 “u” “E2U+SIP”
“!^.*$!sip:+491725551234@ims .mnc02.mcc262.3gppnetwork. org\;cost=0.002200000000\;ported=0\;user=phone!” .

;; Query time: 30 msec
;; SERVER: 185.124.68.123#5353(185.124.68.123)
;; WHEN: Thu Mar 31 16:47:51 2016
;; MSG SIZE rcvd: 172

Look up Multiple Numbers

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

The Number Lookup service can be retrieved for multiple MSISDN by using the same DIG request with multiple contents:

dig @185.124.68.123 –p 5353 IN NAPTR 4.3.2.1.5.5.5.2.7.1.9.4.e164.arpa 4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa

Response for ENUM API

In this case the answer to the lookup request will have the following format (relevant extract):

;; ANSWER SECTION:
491725551234. 1 IN NAPTR 0 0 “u” “E2U+SIP”
“!^.*$!sip:+491725551234@ims.mnc02.mcc262.3gppnetwork. org\;cost=0.002200000\;ported=0\;user=phone!” .

;; ANSWER SECTION:
491725561234. 1 IN NAPTR 0 0 “u”“E2U+SIP”
“!^.*$!sip:+491725561234@ims.mnc03.mcc262.3gppnetwork. org\;cost=0.002200000000\;ported=1\;omnc=02\;user=phone!” .

Look up a Ported Number

When you take a phone number and transfer it to another carrier, it is a ported number. If someone recently ported a number, it may be more likely to be used for fraudulent activity.

dig @185.124.68.123 -p 5353 IN NAPTR 4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa

Response for ENUM API

The Number Lookup reply to the command will be:
; <<>> DiG 9.8.4-rpz2+rl005.12-P1 <<>> @185.124.68.123 -p 5353 IN NAPTR 4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 25231
;; flags: rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
;4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa. IN NAPTR

;; ANSWER SECTION:
491725561234. 1 IN NAPTR 0 0 “u” “E2U+SIP”
“!^.*$!sip:+491725561234@ims.mnc03.mcc262.3gppnetwork. org\;cost=0.002200000000\;ported=1\;omnc=02\;user=phone!” .

;; Query time: 1032 msec
;; SERVER: 185.124.68.123#5353(185.124.68.123)
;; WHEN: Thu Mar 31 16:42:22 2016
;; MSG SIZE rcvd: 192
; <<>> DiG 9.8.4-rpz2+rl005.12-P1 <<>> @185.124.68.123 -p 5353 IN NAPTR 4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 25231
;; flags: rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
;4.3.2.1.6.5.5.2.7.1.9.4.e164.arpa. IN NAPTR

;; ANSWER SECTION:
491725561234. 1 IN NAPTR 0 0 “u” “E2U+SIP”
“!^.*$!sip:+491725561234@ims.mnc03.mcc262.3gppnetwork. org\;cost=0.002200000000\;ported=1\;omnc=02\;user=phone!” .

;; Query time: 1032 msec
;; SERVER: 185.124.68.123#5353(185.124.68.123)
;; WHEN: Thu Mar 31 16:42:22 2016
;; MSG SIZE rcvd: 192