Numverify

Operational

Global phone number validation API · by APILayer

  • Business
  • JSON
  • 232 countries
  • 256-bit HTTPS
Get your API key

Free plan · 100 requests / month · no card

Overview

API info

Numverify gives you accurate phone number validation, carrier, location, and line type data in a single API call. Validate national and international numbers, keep your customer data clean, and reduce undelivered messages with real-time phone intelligence.

Example request

GETShellcurl
curl --request GET \
  --url "https://api.apilayer.net/numverify/validate?access_key=YOUR_ACCESS_KEY&number=14158586273"
Run it in the Playground

Example response

200 - OK
{
    "valid": true,
    "number": "14158586273",
    "local_format": "4158586273",
    "international_format": "+14158586273",
    "country_prefix": "+1",
    "country_code": "US",
    "country_name": "United States of America",
    "location": "Novato",
    "carrier": "AT&T Mobility LLC",
    "line_type": "mobile"
}

Features

  • Easy to integrate

    Ship phone validation quickly with a simple REST API and lightweight JSON responses. Add your API key, pass a phone number to the endpoint, and start receiving structured phone intelligence.

  • Global coverage

    Validate international phone numbers across 232 countries using country-specific international dialing codes and regularly updated numbering plans.

  • Advanced phone intelligence

    Go beyond a simple valid or invalid result. Get country, location, carrier, line type, and standardized local and international formats from a single lookup.

  • Secure & reliable

    Connect through 256-bit HTTPS encryption and integrate Numverify into your applications with a straightforward API built for production use.

Pricing

Flexible plan for every stage of growth

Start free. Upgrade when you go live.

MonthlyYearlySave up to 15%

Free

For testing and side projects

$0forever

No credit card

No overage charges

Get free API key

100 requests / month

Includes:

  • Realtime validation
  • Carrier detection
  • Line type detection
  • Location detection

+ 1 more

See all 8 features

Starter

For your first live product

$14.99/ month

Billed monthly

Then $0.011992 per extra request, up to 10,000 extra a month

Subscribe now

5,000 requests / month

Everything in Free, plus:

  • Commercial use
  • Standard support
See all 8 features
Most popular

Professional

For growing traffic

$59.99/ month

Billed monthly

Then $0.0047992 per extra request, up to 100,000 extra a month

Subscribe now

50,000 requests / month

Everything in Starter, plus:

  • 10× the requests of Starter
  • Lower cost per request
See all 8 features

Enterprise

For high volume

$129.99/ month

Billed monthly

Then $0.00207984 per extra request, up to 500,000 extra a month

Subscribe now

250,000 requests / month

Everything in Professional, plus:

  • 5× the requests of Professional
  • Lower cost per request
See all 8 features

Custom

Need more? Contact sales for custom needs.

Contact us

Compare all features

8 featuresFree$0Get free keyStarter$14.99/moSubscribeProfessional$59.99/moSubscribeEnterprise$129.99/moSubscribe
Realtime validation
Carrier detection
Line type detection
Location detection
HTTPS 256-bit
Commercial use–
Standard support–
Custom solutions––––
Price per extra request after the monthly limitNone$0.011992$0.0047992$0.00207984

Playground

Try the API

Build a request in your browser and see the response it returns.

GET
format Optional

Add your free API key to run it from your code.

curl
200 - OK

      
    

Agents

Agents: start here

Steps for AI coding agents that add Numverify to a project.

  1. 1Get an API key

    A person creates the account: an agent cannot sign up. Sign up at app.apilayer.com and subscribe to Numverify. The Free plan includes 100 requests / month and needs no credit card.

    Copy the API key from the APILayer dashboard and give it to the agent as an environment variable (step 2).

  2. 2Keep the key out of code

    Read the key from an environment variable named APILAYER_ACCESS_KEY. Do not write the key into source code, commit it to git, or paste it into a chat.

    Call Numverify from server code. The key travels in the request URL, so a request sent from a browser shows the key to every visitor.

    .env
    # add .env to .gitignore
    APILAYER_ACCESS_KEY=your_api_key
  3. 3Make the first request

    Base URL
    https://api.apilayer.net/numverify
    Auth
    access_key query parameter
    Formats
    JSON
    Endpoints
    • /validate Validate number
    Shell
    curl "https://api.apilayer.net/numverify/validate?access_key=$APILAYER_ACCESS_KEY&number=14158586273"

    The API info tab shows the response this request returns.

  4. 4Check the plan before you use a feature

    Each plan adds features to the plan before it. Check that the account's plan includes a feature before writing code that uses it.

    PlanRequests / monthAdds
    Free100Realtime validation, Carrier detection, Line type detection, Location detection, HTTPS 256-bit
    Starter5,000Commercial use, Standard support
    Professional50,000Same features as Starter
    Enterprise250,000Same features as Professional

    Prices are in the Pricing tab.

  5. 5Use the machine-readable docs

FAQs

Need clarity?

Here are the answers you might be seeking

Data & features

01.What is Numverify?

Numverify is a global phone number validation and lookup API. It lets applications validate national and international phone numbers and retrieve additional information including country, location, carrier, and line type.

02.How many countries does Numverify support?

Numverify supports phone number validation across 232 countries.

03.What information does Numverify return?

A lookup can return the validation result, local format, international format, country prefix, country code, country name, location, carrier, and line type.

04.Can Numverify validate international phone numbers?

Yes. Numverify supports international phone numbers across 232 countries using their international dialing codes.

05.Can I validate national phone numbers?

Yes. National numbers can be validated by supplying the appropriate two-letter country code alongside the phone number.

06.How does Numverify validate phone numbers?

Numverify’s format validation system is powered by regularly updated international phone numbering plans, allowing it to validate phone-number formats across countries.

07.What format does the API return?

API results are delivered in lightweight JSON format, making them easy to integrate into web applications, backend services, and other systems.

08.What is Numverify?

NumVerify is a free, powerful REST API that validates national and international phone numbers based on the most recent international numbering plan databases. After passing a phone number into the simple request URL structure, the API returns a universally usable JSON response set containing the validation result, the requested number in its local and international format, and useful country, carrier, and line type information.

We believe that every online business that utilizes its customer's phone numbers should validate them to ensure frictionless communication and reduce undelivered messages. That is why we decided to offer 100 monthly validation requests for free.

09.How are phone numbers validated?

Our phone number format validation system is based on the most up-to-date international numbering plans containing complex syntax rules, carrier data, line type data and location information for all mobile and landline numbers in both national and international formats, for a total of 232 countries around the world. Only this way we are able to ensure the highest level of quality, reliability and accuracy for each validation result returned by the API.

10.What is a phone number verification API, and how does it work?

A phone number verification API is a tool that validates the existence and format of a phone number in real-time. The Numverify API works by checking the submitted number against international numbering plan databases to determine its validity, country, and line type, returning the results in a structured JSON format.

11.What are the benefits of using the Numverify API for phone number verification?

The key benefits include real-time data validation, better internal data quality, and fraud prevention. The API provides essential information like line type (mobile, landline), carrier, and geographical location, which helps businesses cleanse databases, reduce bounce rates for SMS, and verify user information during registration.

12.How does the Numverify API handle data privacy and security?

The Numverify API ensures data privacy and security by supporting 256-bit HTTPS encryption for all API connections. This protects data transmitted between your application and the API from being intercepted.

API access

01.Is the API secure?

Numverify supports connections through industry-standard HTTPS with 256-bit encryption.

02.Can I integrate Numverify into my app or CRM?

Yes, the Numverify API is a standard RESTful JSON API, which makes it easy to integrate into a wide variety of applications and systems, including CRMs, using standard API call methods.

03.Does Numverify provide SDKs or code samples?

While the documentation does not mention specific SDKs, it provides detailed information on how to construct API requests and interpret the JSON responses, which serves as a guide for developers to create their own code samples or integrations.

04.What is an API request?

Pricing is based on the number of monthly API Requests offered for each individual Subscription Plan. Accessing any type of numverify API data using a valid API Access Key counts as one "API Request".

05.What is the API's uptime?

The numverify API's system status is being closely monitored around the clock. Since every effort is made to ensure the highest possible level of consistency, we are happy to announce that our API's uptime is at around 99.9%.

Plans & pricing

01.Is there a free plan?

Yes. Numverify offers a free plan with 100 API requests per month. Paid plans start at $14.99 per month.

02.Can I also pay yearly?

Yes. If you choose annual billing, the total price of your subscription plan will be up to 15% lower than the total amount you would pay with a monthly payment frequency.

03.What if I consistently have more API calls than my plan allows?

If your usage consistently surpasses the set limits each month, you may face additional charges for the excess usage. Nevertheless, as your monthly usage reaches a certain threshold, it becomes more practical to consider upgrading to the next plan. By doing so, you ensure a smoother and more accommodating experience for your growing customer base.

Overages

01.What happens if I exceed my API Request volume?

Users will be automatically notified via e-mail and on their Account Dashboard once at least 75%, 90%, and 100% of their monthly API Request allowance has been reached. After reaching 100% of the allowance, overages fees will apply so we make sure you won’t experience any disruptions and your website/application will keep running smoothly.

02.What is an overage?

An overage occurs when you go over a quota for your API plan. When you reach your API calls limit, we will charge you a small amount for each new API call so we can make sure there will be no disruption in the service we provide to you and your website or application can continue running smoothly.

Prices for additional API calls will vary based on your plan.

03.Why does APILayer have overage fees?

Overage fees allow customers to continue using an API once a quota limit is reached. We want to make sure your website or application continues running at all times, so charges will apply if you go over your monthly quota limit. If you notice you are going over your quota limit each month, look on your dashboard for an upgraded plan to help with larger request limits.

04.How do I know if I will be charged for overages?

When you are close to reaching your API calls limit for the month, you will receive an automatic notification (at 75%, 90%, and 100% of your monthly quota). You can keep track of your quota usage to prevent overages by tracking the number of API calls you make and checking the dashboard for up-to-date usage statistics.

Still have a question?

Contact support