Number Insight API Technical Details
Vonage's Number Insight API provides real-time insights into phone numbers, helping you understand who you're connecting with. Instantly verify if a number is mobile or landline, identify the network associated with mobile numbers, check if the number is correctly formatted, and detect potential fraud signals.
Number Insight Features
The features of the Number Insight API are distributed across multiple plans or endpoints, depending on the type of information you need.
Carrier information is available in the Basic, Standard, and Advanced plans, with each endpoint building on the capabilities of the previous one. For example, the Standard endpoint includes all the locale and formatting data from the Basic endpoint, along with additional details such as the type of number, the current carrier (if it’s a mobile number), and the caller's identity (US only). The Advanced endpoint offers the most comprehensive data, including everything from the Basic and Standard endpoints, plus roaming and reachability information.
The Fraud Detection Plan (BETA), on the other hand, combines metrics from the aforementioned plans with additional data sources to assess whether a number is likely fraudulent, such as in cases of recent SIM swaps.
Feature comparison
| Feature | Basic | Standard | Advanced | Fraud Detection |
|---|---|---|---|---|
| Number format and origin | ||||
| Country Information (country code, name, prefix) | ||||
| Current Carrier (network code, name, country, network type) | ||||
| Original Carrier (network code, name, country, network type) | ||||
| Porting Information | ||||
| Validity* | ||||
| Reachability* | ||||
| Real-Time Data (active status, handset status) (To be sunset on October 1st, 2025) | ||||
| Roaming status* | ||||
| Roaming carrier & country* | ||||
| CNAM (add-on) | ||||
| SIM Swap* (To be sunset on November 23, 2025, and will no longer be available after that date. To detect SIM Swap, please migrate to the Identity Insights API.) |
* Only available in certain markets. Please test and/or contact sales for more information.
Check the legislation in your country to ensure that you are allowed to save user roaming information.
Getting Started
This example shows you how to use the Vonage CLI to access the Number Insight Basic API and display information about a number.
For examples of how to use Basic, Standard and Advanced Number Insight with curl and the developer SDKs see the Code Snippets.
Before you begin:
- Sign up for a Vonage API account
- Install Node.JS
Install and set up the Vonage CLI
$ npm install --location=global @vonage/cli
Note: Depending on your user permissions, you might need to prefix the above command with sudo.
Use your VONAGE_API_KEY and VONAGE_API_SECRET from the dashboard getting started page to set up the Vonage CLI with your credentials:
Execute a Number Insight API Basic lookup
Execute the example command shown below, replacing the phone number with one that you want information about: