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 Velocity API specs

TMT Velocity 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 CSV

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
Example
{
  • "number": 40721275636,
  • "current_carrier": {
    },
  • "ocn": null,
  • "original_carrier": {
    },
  • "ported": true,
  • "status": 0,
  • "status_message": "Success",
  • "type": "mobile"
}

POST method

path Parameters
key
required
string

API credentials – delivered to you via email

secret
required
string

API credentials – delivered to you via email

Request Body schema: JSON
format
string

json/csv

number
string

The number in E.164 format.(Only for one query numbers).

numbers
Array of strings

The numbers in E.164 format.(Only for multiple query numbers).

Responses

Request samples

Content type
JSON
{
  • "format": "json",
  • "number": 40721275636,
  • "numbers": [
    ]
}

Response samples

Content type
Example
{
  • "number": 40721275636,
  • "current_carrier": {
    },
  • "original_carrier": {
    },
  • "ported": true,
  • "status": 0,
  • "status_message": "Success",
  • "type": "mobile"
}

ENUM Service

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 e164enum.tmtvelocity.com
Port 53

Output Data

Field Description
tel Queried phone number
npdi Number Portability Dip Indicator (indicates to any downstream systems a portability lookup has been performed)
rn Routing Number (LRN for USA/Canada)
cic Carrier Identification Code (list provided by TMT).
ocn Operating Company Name is the carrier’s Company Code - only for USA / Canada
cc Country Code
cn Carrier short name (list provided by TMT)
nt Number type
Values:
  • mobile
  • fixed.
mcc Mobile Country Code of the carrier
mnc Mobile Network Code of the carrier
np Indicates the portability status. It is a custom field that can be added upon request.
Values:
  • yes = ported
  • no = not ported

ENUM – Successful Query & Response

Command:
$ dig +yaml -t naptr @176.9.67.8 9.8.9.3.5.2.2.2.7.0.4.e164enum.tmtvelocity.com
-
  type: MESSAGE
  message:
  type: AUTH_RESPONSE
  [..]
  response_message_data:
  opcode: QUERY
  status: NOERROR
  [..]
  QUESTION_SECTION:
  - 9.8.9.3.5.2.2.2.7.0.4.e164enum.tmtvelocity.com. IN NAPTR
  ANSWER_SECTION:
  - 9.8.9.3.5.2.2.2.7.0.4.e164enum.tmtvelocity.com. 3600 IN NAPTR 10 100 "u" "E2U+pstn:tel""!^(.*)$!tel:1;npdi;np=no;rn=;cic=4018720;ocn=;cc=ro;cn=VODA;nt=mobile;mcc=226;mnc=01!" .

ENUM – Unsuccessful Query & Response

In the example below an invalid phone number was queried. 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.e164enum.tmtvelocity.com
-
  type: MESSAGE
  message:
  type: AUTH_RESPONSE
  query_time: !!timestamp 2023-03-27T15:34:53.879Z
  response_time: !!timestamp 2023-03-27T15:34:53.879Z
  {..}
  response_address: 176.9.67.8
  response_port: 53
  query_address: 0.0.0.0
  [..]
  opcode: QUERY
  status: NXDOMAIN
  id: 13664
  flags: qr aa rd
  QUESTION: 1
  ANSWER: 0
  AUTHORITY: 0
  ADDITIONAL: 0

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 via Email. 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.
  • network – carriers’ short name. Unique per country. You will find this in the download files as well as in the CN field of the ENUM response. This field is for quickly identifying networks during operator-assisted tests.
  • 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.

Example:

filename SK_operators.csv
  4219920;SKOTW;O2 Slovakia;231;06
  4219910;SKOGE;Orange Slovakia;231;01
  4219900;SKTEL;Slovak Telekom;231;02
  4219903;SKSWA;Swan 4KA Slovakia;231;03
  4219930;SKZSR;ZSR Slovakia;231;99
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 >