Thumbnail
Number Verification | Get Started

Number Verification offers additional features comparing to our Portability Check service. This gives you the opportunity to instantly check whether a user’s transaction is genuine or potentially at risk, optimizing your conversion rate and allowing you to cut unnecessary costs. Getting Started is easy, follow the instructions below and learn more.

1. What is Number Verification?

Number Verification offers extended capabilities in comparison with our Portability Check service, allowing you to check number validity, live status, reachability of a phone number, as well as the roaming status of a number.

This gives you the opportunity to instantly check whether a user’s transaction is genuine or potentially at risk. For example, a user’s transaction can be identified to be coming from a different country than the user’s phone is currently active in, in which case an elevated authentication method can be triggered.

Number Verification also allows you to optimize your conversion rate, as you know whether a phone is reachable or not.

2. How to Set Up Number Verification

Login to your tyntec first and navigate to the Number Information section. Open the menu and open the page for 'Number Verification'.

Click ‘Add a new account’ near the top left of your screen. You will be able to select an API / protocol.

To finalize the setup of your account, you need to choose at least:

  • API / Protocol
  • Source IP Address #1

You can also add a second ‘Source IP Address.’ For the RESTful API you can also add a ‘Respond back URL.’

After adding the Number Verification account, you will receive an email with your personal account credentials. Go ahead and check your email.

The email with your credentials looks like the image below

3. Your first number query

For this part, you'll probably need some developer's expertise.

Let’s query your first number. You’ll need to use your Linux command line.

Using the snippet below, replace “username” and “password” with the credentials we sent to you via email:

curl
-u username:password
-X GET 
-H "Accept: application/json"
https://rest.tyntec.com/nis/v1/gnv?msisdn=+491622943176

Here you can see an example of a response to a query containing the requested number information.

{
"requestId":"12-86cfafba-8677-f42b-5050-ece6af6abf01",
"msisdn":"+491622943176",
 "nrhMCC":"262",
 "nrhMNC":"02",
 "nrhTtId“:15,
 "nrhOperator":"Vodafone",
 "nrhCountry":"DEU",
 "nrhTimezone":"+0100",
 "nrhTechnology":"GSM",
 "imsiMCC":"262",
 "imsiMNC":"02",
 "imsiTtId":15,
 "imsiOperator":"Vodafone",
 "imsiCountry":"DEU",
 "imsiTimezone":"+0100",
 "imsiTechnology":"GSM",
 "hlrCC":"49",
 "hlrNDC":"162",
 "hlrMCC":"262",
 "hlrMNC":"02",
 "hlrTtId":"15,
 "hlrOperator":"Vodafone",
 "hlrCountry":"DEU",
 "hlrTimezone":"+0100",
 "hlrTechnology":"GSM", 
 "mscCC":"49",
 "mscNDC":"162",
 "mscMCC":"262",
 "mscMNC":"02",
 "mscTtId":15,
 "mscOperator":"Vodafone",
 "mscCountry":"DEU",
 "mscTimezone":"+0100",
 "mscTechnology":"GSM",
 "ported":"false",
 "roaming":"false",
 "presence":"true ",
 "price":0.001,
 "currency":"EUR",
 "priceEffective":"2010-11-01T00:00:00+0000",
 "errorCode":"0",
}

If you’re using Windows, you can try sending an SMS from a REST client that you’re currently using or with Postman, Advanced Rest Client, etc.