TMT ID is a leading provider of data, intelligence and analytics, helping customers find extra value from the information they hold. Our team of technology and telecommunications specialists has a proven track record empowering companies, brands and agencies around the world to better understand their businesses and their customers. TMT ID has a suite of technology and telecommunications data available, for further information, please visit www.tmtid.com or email info@tmtid.com.
format required | string JSON |
key required | string API credentials – delivered to you via email |
secret required | string API credentials – delivered to you via email |
number required | string The number in E.164 format (includes the country code sufix) |
{- "40722570240": {
- "cic": "4018740",
- "error": 0,
- "imsi": "22610XXXXXXXXXX",
- "mcc": "226",
- "mnc": "10",
- "network": "Orange Romania",
- "number": 40722570240,
- "ported": true,
- "present": "yes",
- "status": 0,
- "status_message": "Success",
- "type": "mobile,",
- "trxid": "XoMQ3dF"
}
}
dig -t naptr @NodeIP Phone_number_in_enum_format.live.tmtvelocity.com
Record-Type | NAPTR |
---|---|
Node IPs | x.x.x.x |
Phone Number in enum format | The E.164 number needs to be transformed as follows (eg. for: +40/766610060):
|
Domain | live.tmtvelocity.com |
Field | Description |
---|---|
tel | The original number queried |
npdi | Number Portability Dip Indicator (indicates to any downstream systems a portability lookup has been performed) |
np | Indicates if the number was ported. Values: yes / no / na. |
rn | Routing Number (LRN for USA/Canada) |
cic | Carrier Identification Code (list provided by TMT). |
cc | Country Code |
cn | Carrier short name (list provided by TMT) |
nt | Indicates the type of the Number Type. Values: mobile / fixed. |
ocn | Operating Company Number (only for Canada & USA) |
mcc | Mobile Country Code of the current network (if nt = mobile) |
mnc | Mobile Network Code of the network (if nt = mobile). |
imsi | First 5 digits of the International Mobile Subscriber Identity number |
pres | Indicates if the subscriber is present in the network. Values: yes / no / na |
e | Error indicator – 0 (zero) = ok. Other values than “0” are detailed in ERROR codes section |
roaming, rcic, rocn, rmnc, rmcc | Not provided data |
A successful query will return a NAPTR Record with a tel-uri format.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 9.8.9.3.5.2.2.2.7.0.4.live.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+pstn:tel""!^(.*)$!tel:\\1;npdi;np=no;rn=;cic=4018720;ocn=;cc=ro;cn=Vodafone Romania;nt=mobile;mcc=226;mnc=01;oname=Vodafone Romania;imsi=22601XXXXXXXXXX;pres=yes;roaming=na;rcic=;rocn=;rmcc=;rmnc=;e=0!"
Please note that all parameters, including null or N/A values, are currently provided in the response by default. If you require the removal of null parameters, please contact us at support@tmtid.com. Our team will configure this change for you.
The output status is NXDOMAIN and the answer section is blank.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 4.3.2.1.0.4.live.tmtvelocity.com
-
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NXDOMAIN
id: 13664
flags: qr aa rd
QUESTION: 1
ANSWER: 0
AUTHORITY: 0
ADDITIONAL: 0
191 error Is returned when the queried destination is not covered by the Live service. The service will return MNC, MCC, and the Name for the Current Carrier.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 4.4.0.0.0.0.0.1.0.7.4.3.2.live.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+pstn:tel""!^(.*)$!tel:\\1;np=yes;rn=;cic=234503;ocn=;cc=ng;cn=9Mobile(ETISALAT);nt=mobile;mcc=621;mnc=60;oname=Airtel;imsi=62160XXXXXXXXXX;pres=na;roaming=na;rcic=;rocn=;rmcc=;rmnc=;e=191!"
192 error is returned when the queried destination is not covered by the services. The service will return MNC, MCC, and the Name for the Origin Carrier.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 2.0.3.8.7.0.4.4.0.3.2.9.live.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+pstn:tel" "!^(.*)$!tel:\\1;np=na;rn=;cic=92500;ocn=;cc=pk;cn=Jazz (Mobilink);nt=mobile;mcc=410;mnc=01;oname=Jazz (Mobilink);imsi=41001XXXXXXXXXX;pres=na;roaming=na;rcic=;rocn=;rmcc=;rmnc=;e=192!"
193 error is returned when the queried destination is a fixed line. Indicates that the queried number represents a fixed line (Landline).
Command:
$ dig +short +yaml -t naptr @176.9.67.8 3.3.1.0.4.8.7.8.3.3.3.live.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+pstn:tel" "!^(.*)$!tel:\\1;np=no;rn=;cic=33511;ocn=;cc=fr;cn=Orange;nt=fixed;mcc=;mnc=;oname=Orange;imsi=;pres=na;roaming=na;rcic=;rocn=;rmcc=;rmnc=;e=193!"
dig -t naptr @NodeIP Phone_number_in_enum_format.live.tmtvelocity.com
Record-Type | NAPTR |
---|---|
Node IPs | x.x.x.x |
Phone Number in enum format | The E.164 number needs to be transformed as follows (eg. for: +40/766610060):
|
Domain | live-sip.tmtvelocity.com |
Field | Description |
---|---|
tel | The original number queried |
npdi | Number Portability Dip Indicator (indicates to any downstream systems a portability lookup has been performed) |
np | Indicates if the number was ported. Values: yes / no / na. |
rn | Routing Number (LRN for USA/Canada) |
cic | Carrier Identification Code (list provided by TMT). |
cc | Country Code |
cn | Carrier short name (list provided by TMT) |
nt | Indicates the type of the Number Type. Values: mobile / fixed. |
ocn | Operating Company Number (only for Canada & USA) |
mcc | Mobile Country Code of the current network (if nt = mobile) |
mnc | Mobile Network Code of the network (if nt = mobile). |
imsi | First 5 digits of the International Mobile Subscriber Identity number |
pres | Indicates if the subscriber is present in the network. Values: yes / no / na |
e | Error indicator – 0 (zero) = ok. Other values than “0” are detailed in ERROR codes section |
roaming, rcic, rocn, rmnc, rmcc | Not provided data |
A successful query will return a NAPTR Record with SIP-URI in the format sip:+msisdn@ims.mnc.mcc.3gppnetwork.org.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 9.8.9.3.5.2.2.2.7.0.4.live-sip.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+sip" "!^.*$!sip:+40722253989@ims.mnc01.mcc226.3gppnetwork.org;npdi;np=no;rn=;cic=4018720;ocn=;cc=ro;cn=Vodafone Romania;nt=mobile;mcc=226;mnc=01;oname=Vodafone Romania;imsi=22601XXXXXXXXXX;pres=yes;roaming=na;rcic=;rocn=;rmcc=;rmnc=;e=0!"
Please note that all parameters, including null or N/A values, are currently provided in the response by default. If you require the removal of null parameters, please contact us at support@tmtid.com. Our team will configure this change for you.
The output status is NXDOMAIN and the answer section is blank.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 4.3.2.1.0.4.live-sip.tmtvelocity.com
-
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NXDOMAIN
id: 13664
flags: qr aa rd
QUESTION: 1
ANSWER: 0
AUTHORITY: 0
ADDITIONAL: 0
191 error Is returned when the queried destination is not covered by the Live service. The service will return MNC, MCC, and the Name for the Current Carrier.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 4.4.0.0.0.0.0.1.0.7.4.3.2.live-sip.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+sip" "!^.*$!sip:+2347010000044@ims.mnc60.mcc621.3gppnetwork.org;np=yes;cic=234503;cc=ng;cn=9Mobile(ETISALAT);nt=mobile;mcc=621;mnc=60;oname=Airtel;imsi=62160XXXXXXXXXX;pres=na;roaming=na;e=191!"
192 error is returned when the queried destination is not covered by the service. The service will return MNC, MCC, and the Name for the Origin Carrier.
Command:
$ dig +short +yaml -t naptr @176.9.67.8 2.0.3.8.7.0.4.4.0.3.2.9.live-sip.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+sip" "!^.*$!sip:+923044078302@ims.mnc01.mcc410.3gppnetwork.org;np=na;cic=92500;cc=pk;cn=Jazz (Mobilink);nt=mobile;mcc=410;mnc=01;oname=Jazz (Mobilink);imsi=41001XXXXXXXXXX;pres=na;roaming=na;e=192!"
193 error is returned when the queried destination is a fixed line. Indicates that the queried number represents a fixed line (Landline).
Command:
$ dig +short +yaml -t naptr @176.9.67.8 3.3.1.0.4.8.7.8.3.3.3.live-sip.tmtvelocity.com
type: MESSAGE
message:
type: AUTH_RESPONSE
[..]
response_message_data:
opcode: QUERY
status: NOERROR
[..]
ANSWER: 1
[..]
10 100 "u" "E2U+sip" "!^.*$!sip:+33387840133@ims.mnc.mcc.3gppnetwork.org;np=no;cic=33511;cc=fr;cn=Orange;nt=fixed;oname=Orange;pres=na;roaming=na;e=193!"
Code (dec) | Code (hex) | Presence | Description |
---|---|---|---|
1 | 0x1 | no | Unknown subscriber: The number is not allocated. |
2 | 0x2 | no | The owning network cannot be reached. |
3 | 0x3 | no | The network cannot reach the number. |
4 | 0x4 | no | The location of the number is not known to the network. |
5 | 0x5 | no | The number, as published in HLR, in not known to the MSC. |
6 | 0x6 | no | The number is absent for SM. |
7 | 0x7 | no | Unknown equipment. |
8 | 0x8 | no | Roaming not allowed. |
9 | 0x9 | no | Illegal subscriber. |
10 | 0xA | no | Bearer service not provisioned. |
11 | 0xB | no | Tele-service not provisioned. |
12 | 0xC | no | Illegal equipment. |
13 | 0xD | no | Call barred. |
21 | 0x15 | no | Facility not supported. |
27 | 0x1B | no | Phone switched off. |
28 | 0x1C | no | Incompatible terminal. |
31 | 0x1F | no | The subscriber is busy. |
32 | 0x20 | no | The delivery of the SM has failed. |
33 | 0x21 | n/a | A congestion (a full waiting list) occurred. |
34 | 0x22 | n/a | System failure. |
35 | 0x23 | no | Missing data. |
36 | 0x24 | no | Data error. |
191 | 0xBF | n/a | Unsupported network for which TMT offers portability status. |
192 | 0xC0 | n/a | Unsupported network for which TMT offers the Origin Network. |
193 | 0xC1 | n/a | Landline / Fixed network (not covered) |
Velocity coverage is constantly changing. Each update is uploaded on the Viteza Customer Portal. Users can download all files at once (zip archive) or country by country (CSV file).
For each country, an operators file is provided during the provisioning process. The up-to-date coverage files are updated in the Viteza Customer Portal.
Example:
filename United Arab Emirates_live_operators.csv
971500;Emirates Telecom Corp-ETISALAT;424;02;true
971501;Emirates Integrated Telecommunications Company PJSC (DU);424;03;true
971502;All landline United Arab Emirates;424;;false
We provide the most comprehensive device, network and mobile numbering data available
Contact us > Chat to an expert >