Testing Suite

Overview

A testing service is available for public use in order to allow developers to test integrations without incurring charges.

The testing suite is pre-populated with example responses. When a user submits a telephone number to the testing suite, we will find the closest match to the submitted telephone number and return the closest match. This means in many cases the response returned from the testing suite will be for a different telephone number to the one submitted. See example numbers below of known telephone numbers where you will receive a result for that telephone number.

• The testing suite is not connected to the telephone network

• The testing suite will not perform a real time lookup

• Requests to the testing suite will not be charged

Credentials

https://testing.hlrlookup.com/apiv2/hlr

api_key = speedtest
api_secret = speedtest

Curl example:

curl -s -H "Content-Type: application/json" -X POST -d  '{"api_key":"speedtest","api_secret":"speedtest", "requests":[{"telephone_number": "441133910781"}]}'

https://testing.hlrlookup.com/apiv2/hlr

429 Too Many Requests

If you send more than 200 requests per second we will include random 429 TOO MANY REQUESTS responses. These inform you that we are throttling requests to that telephone network and you should reduce the number of requests per second and also retry the telephone number you requested.

In production we throttle per telephone network depending on network conditions to that telephone network at that time, you can choose to reduce the number of requests overall or only for that network if you know the original network in advance.

Note - Ask your account manager about our e164 validation service if you want to pre-validate a telephone number and detect the original network.

If you would like to trigger 429 errors at less than 200 requests per second, please submit Afghanistan telephone numbers (see latency note below)

Latency

Random latency times are built into the suite. The system will automatically vary response times to try and mimic network response delays.

There is a special rule for Afghanistan (country code 93) where the suite will take longer to respond and we will include some 429 errors even at rates below 200 lookups per second.

Sample telephone numbers

You can submit any telephone number to the testing suite.

The testing suite is pre-populated with some telephone numbers. If you lookup a telephone number which is not in the test data then we will return the nearest match (not the telephone number submitted).

Here is a small sample of telephone numbers known to be in the test data. A longer list is available on request from:

support@hlrlookup.com