Phone Number Validation and Verification API

Improve your contact rate and clean your lists with Abstract's industry-leading phone number validation API
Get started
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
200 - Success
Fake and invalid
number detection
Carier and line type identification
190 countries
supported
Privacy friendly
(GDPR, CCPA)
Serving billions of calls to 1,000,000+ developers and end users worldwide

Why do 10,000+ developers trust Abstract?

Easy to implement and maintain

We built Abstract because most of the API's we've used aren't great for developers. That's why Abstract has excellent documentation, multiple easy to use libraries, and tutorials to get you started.

Speed and scale built into everything we do

Our APIs are built to power critical business processes and flows, so all our APIs are built for use at scale and at blazing speeds. These aren't just marketing phrases for, but fundamental features of our APIs.

Reliable uptime and great support

Developers trust Abstract because of our reliable uptime and excellent technical support that will help get you live quickly, keep you running smoothly, and resolve any issues you have fast.

Simple, transparent, and cost-effective pricing

FREE

$0

no card
required!

  • 250 requests
  • 1 request / second

PROFESSIONAL

$9

per
month

  • 1,000 requests / month
  • $0.009 / extra request
  • 50 requests / second
  • Commercial use allowed
  • Email support

ENTERPRISE

Get in touch!

  • >100,000 requests / month
  • 500 requests / second
  • Commercial use allowed
  • Premium enriched data
  • Chat support

Abstract's Phone Number Validation and Verification API ensures you have clean and reliable contact lists

Powerful phone validation and verification

Validate and verify phone numbers before you save them to your database and use them to contact users to ensure you have only real, high value users and contract info.

Identify fake and invalid phone numbers

We maintain a large and frequently updated database phone numbers and carriers, including disposable, free, VOIP, and other number types to help screen low quality numbers.

International number and carrier support

Abstract's database covers 190+ countries, allowing you to validate and verify phone numbers from around the world without having to be an expert in the minutiae international phone yourself.

Detect phone carriers and line type

Phone validation and verification includes data like the phone carrier and line type (landline, cell phone, VOIP, etc) where possible, so you can get a full view of a phone number.

Get location and other valuable geo data

Get valuable geographic information about a phone number. This includes not only country, but also region or even city-specific details in many cases.

Protected by bank-level security

Security is also a top concern of ours, especially with your data. So every interaction you have with Abstract's Phone Number Validation and Verification API is secured via 256-bit SSL encryption (HTTPS).

Phone Number Validation and Verification API Documentation

Overview

Abstract's Phone Number Validation and Verification API is a fast, lightweight, modern, and RESTful JSON API for determining the validity and other details of phone numbers from over 190 countries.

It's very simple to use: you only need to submit your API key and a phone number, and the API will respond as assessment of its validity, as well as additional details like the carrier details, line type, region and city details, and more.

Validating and verifying phone numbers is a critical step to reducing the chances of low quality data and fraudulent or risky users in your website or application.

REST

The Phone Number Validation and Verification API, like all of Abstract's APIs, is organized around REST. It is designed to use predictable, resource-oriented URL's and to use HTTP status codes to indicate errors.

HTTPS

The Phone Number Validation and Verification API requires all communications to be secured TLS 1.2 or greater.

API Versions

All of Abstract's API are versioned. The Phone Number Validation and Verification API is currently on Version 1.

Your API Key

Your API key is your unique authentication key to be used to access Abstract's Phone Number Validation and Verification API. Note that each of Abstract's API has a unique API key, so you will need different keys to access the Phone Number Validation and Verification and Email Validation APIs, for example. To authenticate your requests, you will need to append your API key to the base URL.

Base URL

https://phonevalidation.abstractapi.com/v1/

Overview of the Phone Number Validation and Verification API

Abstract's Phone Number Validation and Verification API simply requires your unique API key and the phone number you'd like to check:

https://phonevalidation.abstractapi.com/v1/
    ? api_key = YOUR_UNIQUE_API_KEY
    & number = 14154582468

This was a successful request, so the valid phone number and details associated with it are returned below:

{
    "number": "14154582468",
    "is_valid_number": true,
    "local_format":"4154582468",
    "international_format": "+14154582468",
    "country_name": "United States of America",
    "country_code": "US",
    "country_prefix":"+1",
    "registered_location": "San Francisco, CA",
    "carrier":"Verizon USA",
    "line_type": "Mobile",
}

Phone Number Validation and Verification API - Request Parameters

PARAMETER

TYPE

DETAILS

api_key required

String

Your unique API key. Note that each user has unique API keys for each of Abstract's APIs, so your Phone Validation API key will not work for as your IP Geolocation API key, for example.

number required

String

The phone number to validate and verify.

Phone Number Validation and Verification API - Response

The API response is returned in a universal and lightweight JSON format.

PARAMETER

TYPE

DETAILS

number

String

The phone number submitted for validation and verification.

is_valid_number

Boolean

Is true if the phone number submitted is valid.

local_format

String

The local or national format of the submitted phone number. For example, it removes any international formatting, such as "+1" in the case of the US.

international_format

String

The international format of the submitted phone number. This means appending the phone number's country code and a "+" at the beginning.

country_name

String

The name of the country in which the phone number is registered.

country_code

String

The country's two letter ISO 3166-1 alpha-2 code.

country_prefix

String

The country's calling code prefix.

registered_location

String

As much location details as are available from our data. This can include the region, state / province, and in some cases down to the city.

carrier

String

The carrier that the number is registered with.

line_type

String

The type of phone number. The possible values are: Landline, Mobile, Satellite, Premium, Paging, Special, Toll_Free, and Unknown.

Response and Error Codes

Whenever you make a request that fails for some reason, an error is returned also in the JSON format. The errors include an error code and description, which you can find in detail below.

CODE

TYPE

DETAILS

200

OK

Everything worked as expected.

400

Bad request

Bad request

401

Unauthorized

The request was unacceptable. Typically due to the API key missing or incorrect.

500

Internal Server Error

The request could not be completed due to an error on the server side.

503

Service Unavailable

The server was unavailable.

Frequently Asked Questions
about Abstract's Phone Validation API

What is the phone verification API?

Abstract's Phone Validation API is a simple yet powerful REST API that takes a phone number and returns whether or not it is valid, as well as additional information about the phone number, such as its country and sometimes city / region of origin, as well as information like phone number type and carrier. These checks can be done asynchronously or in real-time. By verifying phone numbers via API, you can help keep your sign up and other such flows clear of fake phone numbers and other data and ensure only correct users or numbers continue.

How often is database for the phone number verification API updated?

We utilize several databases of numbers to ensure that that we have expansive coverage of not only every country, but also every type of telephone number, such as landlines, cellular phones, toll free numbers, and more. Our systems regularly ingest this data and cross reference it to ensure it's correct. Various updates to the data are made on a daily basis, and substantive updates to the phone data set are also made on a weekly and monthly basis.

In which countries does the phone number verification work?

The Phone Number Validation API supports phone numbers from 195+ countries. The countries and territories covered by the API include: Afghanistan, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antarctica, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Bouvet Island, Brazil, British Indian Ocean Territory, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros, Congo, Cook Islands, Costa Rica, Cote D'Ivoire (Ivory Coast), Croatia, Cuba, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands (Malvinas), Faroe Islands, Fiji, Finland, France, France, Metropolitan, French Guiana, French Polynesia, French Southern Territories, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Heard and McDonald Islands, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea (North), Korea (South), Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Micronesia, Moldova, Monaco, Mongolia, Montserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norfolk Island, Northern Mariana Islands, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn, Poland, Portugal, Puerto Rico, Qatar, Reunion, Romania, Russian Federation, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and The Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Singapore, Slovak Republic, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, St. Helena, St. Pierre and Miquelon, Sudan, Suriname, Svalbard and Jan Mayen Islands, Swaziland, Sweden, Switzerland, Syria, Taiwan, Tajikistan, Tanzania, Thailand, Togo, Tokelau, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom (Britain / UK), United States of America (USA), US Minor Outlying Islands, Uruguay, Uzbekistan, Vanuatu, Vatican City State (Holy See), Venezuela, Viet Nam, Virgin Islands (British), Virgin Islands (US), Wallis and Futuna Islands, Western Sahara, Yemen, Yugoslavia, Zaire, Zambia, and Zimbabwe. Note that this is the same list of countries supported by our Public Holidays API.

Developers around the world love Abstract's Phone ValidationAPI

Huge time saver! I wish we set up this type of phone and email verification sooner so we had cleaner data, but thankfully we're protected now going forward with Abstract's APIs.

Chris Stanley, Scope

We service customers in over 100 countries around the world, and a lot of our customer communication happens over phone and SMS. So having reliable phone data was really important to us. The speed and reliability of Abstract's phone verification API has been a huge time saver for us.

David Litwak, Mozio Inc

Our simple regex's weren't cutting it any more and we had a bunch of random and junk sign ups coming in from new users. We tried a few different API's and ultimately went with Abstract for phone number validation. We recommend it to anyone that asks!

Mike Kenyes, Software Engineer

Phone Number Validation and Verification API Changelog

Last Updated on 

October 4, 2020

October 4, 2020

 - 

Update list of carriers and line types of Europe and MENA

June 21, 2020

 - 

Improved handling of international country codes and trimming of special characters in submitted phone numbers

June 10, 2020

 - 

Improved phone number type detection, including for US VOIP numbers

GET STARTED

Get  FREE credits to start today.

Get thousands of API calls for free across all Abstract APIs.
GET YOUR FREE API KEY

Frequently Asked Questions
About Subscription & Pricing

What does the API cost?

Each of our API's has a free plan as well as several paid options, which offer a greater number of requests, a higher level of data quality, and greater speed for higher prices. Please see the page above or sign into your account to view pricing for each API.

Do you have a free trial or free options for your API's?

Absolutely! We want you to try before you buy. Each of our API's has a free tier with a generous usage allowance for you to try the product out and verify that the speed and data quality work for you.

What payment options do you offer?

We use Stripe to accept payment via major debit and credit cards (Visa, Mastercard, American Express). If you cannot use those payment methods, then contact us at team at abstractapi.com to arrange for an alternative payment method.

Can I upgrade or downgrade my subscription?

Yes, you can upgrade or downgrade your subscription at any time by visiting your dashboard. If you upgrade in the middle of a billing cycle, you will be charged a pro-rated amount for your new plan through the end of the billing cycle.

Can I cancel at any time?

Yes, all of our subscriptions are month to month. You can cancel at any time, and you will not be charged again at the end of your billing cycle.

How can I cancel my subscription?

You can cancel your subscription at any time from your dashboard. Once canceled, your subscription will be active until the end your current billing cycle, and then it will be automatically moved to the free plan.

What happens if I go over my monthly quota for requests?

If your API usage exceeds the monthly limit set by your plan, then you will be charged a fee for each call over your limit. At the end of your billing period, your usage will reset again.

What if I need more requests or something else that's not offered in your plans?

We do offer enterprise plans with custom features and pricing in limited circumstances. If our public pricing plans don't work for you, then contact us (team at abstractapi.com) and we'll work something out.

Do you offer any discounts?

While we don't normally offer discounts, we do make exceptions for certain types of users and use cases. If you are a student or are engaged in academic work, or are working on a non-profit or open source project, we're happy to offer you discounts for our API's. Just email us at team at abstractapi.com.

Do you offer discounts for annual or quarterly payments?

All of our plans are currently paid month to month. We will be launching annual plans at a discount soon. If you're interested in an annual plan in the meantime, just contact us and we'll set you up.

What happens if my payment method expires?

We will typically attempt to charge your payment method up to three times after it fails. If we're still unable to collect payment, then your subscription will be automatically canceled and you'll be moved to the free plan.

Can I use the API's for a commercial project?

Yes, a paid tier of our API may be used in conjunction with a commercial project. The free tiers of our API's may not be used in commercial projects.