Description

The Number Lookup section of your Telnyx portal account provides a graphical interface for making number lookups. The lookups provide carrier information as well as other data such as Caller ID name info.

Video Walk-through

Step by Step Guide

The Telnyx Number Lookup API helps you know the details behind every phone number. You can use it to make each call more productive, reduce undelivered messages, and protect from spam and fraud.

Click on this button below and it will directly get you to the Number Lookup page.

You are presented with one field for entering a number and a drop-down menu to select the type of number lookup type. There are 4 options available: Carrier, Caller name, Carrier and Caller name, and None.

  • Carrier: Will return the number information and the carrier info.
  • Caller name: Will return the number information and the Caller ID name info.
  • Carrier and Caller name: Will return the number info, the caller ID name info and the carrier info.
  • None: Will only return the number info.

Example:

Sending this request below:

https://api.telnyx.com/v2/number_lookup/+18665552368
  • Will provide the LRN (local routing number) dip cost only.

Sending this request below:

https://api.telnyx.com/v2/number_lookup/+18665552368?type=carrier
  • Will provide the LRN dip cost and the MMC/MNC (mobile country codes and mobile network codes) dip cost. The MCC/MNC cost only applies if the number dipped is wireless/mobile.

Sending this request below:

https://api.telnyx.com/v2/number_lookup/+18665552368?type=carrier&type=caller-name
  • Will provide the LRN dip cost, the MCC/MNC dip cost (again only if the number dipped is wireless/mobile) and CNAM cost.

The breakdown on price, using our base pricing (subject to change) for Telco Data is as follows:

  • +18665552368 (LRN dip @ $0.0015)
  • ?type=carrier (MCC/MNC dip @ $0.0075, again charged only if dipped number is mobile)
  • &type=caller-name (CNAM dip @ $0.0025)

In the above example, the total cost is $0,0015 + $0.0025 = $0.004. This is because the number dipped is not mobile or wireless, so the MCC/MNC charge is not applicable.

Please double check your telco pricing page for accurate information on your dipping costs: https://portal.telnyx.com/#/app/pricing/telco

In the field where you enter the number, you may choose the country from the drop-down menu on the left, or you can set it to "International" and you can enter any number with the leading "+" and the country code and the portal will automatically perform the lookup in the associated country.

For detailed documentation on Telnyx number lookup please see our API Reference.

As the lookup user interface is used mainly for small scale lookups and testing. Two APIs are currently available - private API and public API.

  • Public API shows part of the data we have available and can be used by everyone free of charge. Additionally, the public API does not support fetching caller name and carrier data and can be used without registration or token.
  • In order to use private API a user has to register and create an API token on Telnyx portal from here.

An example API response below:

NOTE: To review your number lookup usage, you can see the charges in your invoice at the start of each new month for the previous month or you can use your usage report section as seen below. This report is not in real-time, so any dips you've made on the day, will show up on the next day.

Can't find what you're looking for? Click the chat bubble at your lower right-hand corner and talk to the support team!

Did this answer your question?