Number Lookup Application
All the data. Up to date.
Check for invalid or unreachable phone numbers in your database and verify their validity to increase your message delivery rates.
Around the world. Across the board.
Discovery is a fast and easy way to decrease the number of undelivered messages significantly by validating the operational status of any number in your databases before engaging with customers.
Real-time HLR
A Home Location Register (HLR) query reveals real-time number insights, including number validity, number status, ported status, and roaming status (whenever available). It also uses HTTP and DNS to provide live data which you can use to empower your adaptive routing engine.
Number Lookup Desktop Application
Our Number lookup App helps the business to clean there old numbers database and keep it update with the active subscribers. The Application is one of our services you could use to send millions of requests to Cequens Number Discovery APIs. With simple and easy few steps you can clean your number database.

Application Home Screen
Download the Application
Download Number Lookup Application
If the download link does not work please copy the URL into a new tab
Prerequisites
Before using the Application you should have the following prerequisites:
- Active Account on Cequens Platform
- Discovery Service is enabled for the account
- Valid JWT token
Configure the Application
CEQUENS JWT Token
Add your Cequens Token and you are ready to use the application. Have a look at the below configuration page.
Throughput Value
Set the value of the requests throughput for each patch, default value is 8 and the max is 20.
Log Level
Set the value of the application log level. Default is Info.

Number Lookup Configuration
Importing your numbers
You can import your numbers through attaching a .txt file holding all your data.
It is important that the numbers follow the format of "Country Code + Number"
e.g. for KSA "96653xxxxxxx"
Maximum numbers for lookup per transaction is 1 Million
Export your results

Results Screen
You can Export your results by pressing the Export button and selecting a destination.
Export files are divided into 4:
- Reachable Numbers
- Numbers with Temporary Errors
- Numbers with Permanent Errors
- General Errors
Understanding the Error Codes
Permanent Error Codes
Code | Description |
|---|---|
Code | Description |
001 | Unknown Subscriber |
002 | Unknown Subscriber - NR changed |
003 | Unknown MSC |
007 | Unknown Equipment |
009 | Illegal Subscriber |
011 | Teleservice Not Provisioned |
012 | Illegal Equipment |
Temporary Error Codes
Code | Description |
|---|---|
004 | Unknown Location Area |
005 | Unidentified Subscriber |
006 | Absent Subscriber for SM |
008 | Roaming Not Allowed |
010 | Bearer Service Not Provisioned |
013 | Call Barred |
014 | Forwarding Violation |
015 | CUG Reject |
016 | Illegal SS Operation |
017 | SS Error Status |
018 | SS Not Available |
019 | SS Subscription Violation |
020 | SS Incompatibility |
021 | Facility Not Supported |
022 | Ongoing GroupCall |
023 | Invalid Target Base Station |
024 | No Radio Resources Available |
025 | No Handover Number Available |
026 | Subsequent Handover Failure |
027 | Absent Subscriber |
028 | Incompatible MS Terminal Error |
029 | Short-Term Denial |
030 | Long-Term Denial |
031 | Subscriber Busy For MT SMS |
032 | SM Delivery Failure |
033 | Message Waiting List Full |
034 | GSM System Failure |
035 | GSM Data Error - Data Missing |
036 | Unexpected Data Value |
037 | PW Registration Failure |
038 | Negative PW Check |
039 | No Roaming Number Available |
040 | Tracing Buffer Full |
042 | Target Cell Outside GroupCall Area |
043 | Number of PW Attempts Violation |
044 | Number Changed |
045 | Busy Subscriber |
046 | No Subscriber Reply |
047 | Forwarding Failed |
048 | OR Not Allowed |
049 | ATI Not Allowed |
050 | No GroupCall Number Available |
051 | Resource Limitation |
052 | Unauthorized Requesting Network |
053 | Unauthorized LCS Client |
054 | Position Method Failure |
058 | Unknown or Unreachable LCS Client |
059 | MM Event Not Supported |
060 | ATSI Not Allowed |
061 | ATM Not Allowed |
062 | Information Not Available |
071 | Unknown Alphabet |
072 | USSD Busy |
086 | Subscriber Location Report |