Verify

Verify and validate customers globally using their phone number.

Velocity

Discover the network provider for every mobile number globally.

Authenticate

Protect customers, accounts, and transactions within your app.

Live

Discover if a mobile number is assigned to a subscriber.

Score

A real time phone number credibility score.

TeleShield™

Identify if a number has the propensity to be used for fraud.

Banks and Financial Services
E-Commerce
Insurance
Mobile Messaging
Gaming & Gambling
Communication and Service Providers
Identity & Verification Providers
eBooks
News
Developers
Viteza
FAQ
About us
Events
Careers
Contact us
TMT Live API specs

TMT Live API specs

Download OpenAPI specification:Download

About TMT

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.

HTTP API

GET method

path Parameters
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)

Responses

Response samples

Content type
application/json
Example
{
  • "40722570240": {
    }
}

ENUM Services

ENUM TEL-URI

Query Format

dig -t naptr @NodeIP Phone_number_in_enum_format.live.tmtvelocity.com

Query Parameter Description

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):
  • Remove all special characters: +40/766610060 becomes 40766610060.
  • Reverse all digits from the number: 40766610060 becomes 06001666704.
  • Add Dots between all digits: 06001666704 becomes 0.6.0.0.1.6.6.6.7.0.4.
Domain live.tmtvelocity.com

Output Data

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

Successful Query & Response

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.

Response example for Invalid Number

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

Error Code 191 Response Example

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!"

Error Code 192 Response Example

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!"

Error Code 193 Response Example

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!"

ENUM SIP-URI

Query Format

dig -t naptr @NodeIP Phone_number_in_enum_format.live.tmtvelocity.com

Query Parameter Description

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):
  • Remove all special characters: +40/766610060 becomes 40766610060.
  • Reverse all digits from the number: 40766610060 becomes 06001666704.
  • Add Dots between all digits: 06001666704 becomes 0.6.0.0.1.6.6.6.7.0.4.
Domain live-sip.tmtvelocity.com

Output Data

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

Successful Query & Response

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.

Response example for Invalid Number

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

Error Code 191 Response Example

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!"

Error Code 192 Response Example

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!"

Error Code 193 Response Example

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!"

Error Codes

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)

Service Coverage

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.

  • network_id – unique across the system (assigned by TMTID). You will find this in the download files as well as in the CIC field of the ENUM response. You should use this field for mapping to our system.
  • ocn – (only for US/Canada files) – Operating Company Name is the carrier’s Company Code. It is assigned by the National Exchange Carrier Association. You should use this field for mapping to our system.
  • full_name – the full name of the operator/carrier.
  • mcc – the mobile country code of the operator/carrier.
  • mnc – mobile network code for the operator/carrier.
  • Live_coverage – indicates if the destination is covered at present time:
    • true (covered)
    • false (not covered)

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
What Our Customers Are Saying

"Phone number verification plays a critical role in helping to detect and prevent online fraud. TMT ID’s TeleShield product provides easy access to global mobile data, enabling us to enhance the actionable results of our MaxMind minFraud® services."

MaxMind

"BTS (Business Telecommunications Services) is successfully using TMT’s Velocity and Live services to check the status of mobile numbers. This way we make sure we optimize the performance of the service offered to our customers and ensure the quality of terminating traffic to all countries.”

Business Telecommunications Services

"Working with TMT’s TeleShield service has expanded our ability to detect fraud and minimise the risk to our business. TeleShield brings peace of mind and the opportunity to stop fraud before it affects our customers’ bottom line or the service."

Six Degrees Labs

"LATRO relies on TMT’s TeleShield to provide the most up to date and reliable numbering qualification information within our fraud reporting tools, enabling us to protect our customer’s revenues and empowering them to defend themselves against fraudulent numbers."

LATRO

"TMT is a valued partner that enables us to manage our routing costs effectively. They proactively and continuously expand their operator and country coverage while delivering exceptional customer service. We can always count on them to achieve high-quality results and look forward to our continued collaboration."

Global Message Service

"TMT provides us with the most comprehensive numbering intelligence data through their fast and reliable Velocity and Live services. TMT is a trusted partner for us, their products ensure that we continue to optimise the best performance and service to our customers."

Global Voice

"TeleShield from TMT gives 42com the power to detect and target telephony fraud scams internationally, thereby protecting our company from the financial and customer experience impacts of telecommunications fraud."

Alberto Grunstein - CEO

"It has been a pleasure to work with the team at TMT. They have become an essential provider of accurate numbering data information and Number Portability services globally."

Luisa Sanchez - VP of SMS and Messaging Solutions, Identidad Technologies

"Deutsche Telekom Global Carrier uses TMT ID as one of their key suppliers for Mobile Number Portability Data services. Deutsche Telekom Global Carrier uses TMT ID’s Velocity MNP solution. This is an ultra-fast query service that optimises the routing of international voice calls and A2P messaging."

Deutsche Telekom Global Carrier

Ready to get started?

We provide the most comprehensive device, network and mobile numbering data available

Contact us > Chat to an expert >