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

TMT Authenticate API specs (1.1.2)

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.

Authenticate

Authenticate user with MNO or OTP. These endpoints can be directly called by the users.

This phase is where the Customer requests authorization to perform an authentication for a given device.

This phase is where the Customer requests authorization to perform an authentication for a given device.

The Customer requests permission to make an Authentication query and receives a timebound token for that transaction. The Customer also must request which authentication technology is required for this transaction.

Authorizations:
basic
Request Body schema: application/x-www-form-urlencoded
grant_type
required
string

The value must be “client_credentials”.By passing this value the service will return an access_token for direct access to the services.

scope
required
string

Scope must contain the requested services. It can be authenticate and/or otp concatenated with a “+”.

Responses

Response samples

Content type
application/json
{
  • "access_token": "v4.public.eyJzY29wZSI6ImF1dGgrb3RwIiwidXNlcl9pZ…",
  • "expires_in": "3600",
  • "token_type": "Bearer"
}

The get_config endpoint will return specific instructions on how to begin the session with the relevant MNO and how to send the OTP message.

The get_config endpoint will return specific instructions on how to begin the session with the relevant MNO and how to send the OTP message.

The Customer requests the specific telephone number that requires authentication. In response to this stage TMT ID will return the specific uri that the handset must call for the Silent Authentication (where appropriate).

Authorizations:
paseto_token
Request Body schema: application/x-www-form-urlencoded
client_ip
required
string

The IP of the user needed to be authenticated. This is required by some MNO’s for validation.

correlation_id
string or null

It is used to correlate the transaction across all components(authenticate, validate). It must be unique to the instance of the transaction.

msisdn
required
string

The phone number that needs to be authenticated by our system in E.164 format.

redirect_uri
string or null

Predefined callback url to be used in the session and send the request back to the client

Responses

Response samples

Content type
application/json
{}

The validate endpoint will return whether the phone number was validated successfully or not and the service used in order to achieve the authentication.

The validate endpoint will return whether the phone number was validated successfully or not and the service used in order to achieve the authentication.

Security mechanism that allows the Customer to check with TMT ID that a handset had correctly authenticated.

Authorizations:
paseto_token
Request Body schema: application/json
code
string or null

Code obtained from the authenticate request on redirect_uri

correlation_id
string or null

The correlation_id submitted through the get_config request

id_token
required
string

Provided in the get_config request

otp_code
string or null

Provided only if we need to validate the user using the OTP service

payload
any or null

JSON Response obtained from the authenticate or otp request.

Responses

Request samples

Content type
application/json
{
  • "code": "64a5b19-457a-4d30-a5c4-038c62dcssfg3",
  • "correlation_id": "Noo7siol1Yj763XTRDidILTv96ly9kFS",
  • "id_token": "v4.public.eyJ2ZW5kb3JfdHlwZSI6IkVFIiwianRp…",
  • "otp_code": "123456",
  • "payload": null
}

Response samples

Content type
application/json
{
  • "authenticated": "true",
  • "correlation_id": "Noo7siol1Yj763XTRDidILTv96ly9kFS",
  • "service": "authenticate"
}

Service

Service endpoints

Authenticate with Silent Network Authentication method

Authenticate with Silent Network Authentication method

The authenticate endpoint will execute the Silent Authentication against the Operator wherever this is supported.

query Parameters
id_token
required
string
Example: id_token=v4.public.eyJuZXR3b3JrIjoiVk9EQUZPTkUiLCJ1c2VyX2lkIjoiZDFmYTA2ZDQtOTM1My0xMWVkLTgzZWQtNGY4ZGVjMDc1ZWM4IiwibmJmIjoiMjAyMy0w...

Provided in the get_config request

Responses

Response samples

Content type
application/json
{
  • "session_id": "pYXQiOiIyMDIyLTEyLTEyVDEyOjI4Oj"
}

Authenticate with One-Time Password method

Authenticate with One-Time Password method

This specific endpoint will be triggered by the Customer and in case of success a special form where the user needs to input the OTP code needs to be displayed in the Customer APP.

query Parameters
id_token
required
string
Example: id_token=v4.public.eyJuZXR3b3JrIjoiVk9EQUZPTkUiLCJ1c2VyX2lkIjoiZDFmYTA2ZDQtOTM1My0xMWVkLTgzZWQtNGY4ZGVjMDc1ZWM4IiwibmJmIjoiMjAyMy0w...

Provided in the get_config request

Responses

Response samples

Content type
application/json
{
  • "session_id": "pYXQiOiIyMDIyLTEyLTEyVDEyOjI4Oj"
}
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 >