NumVerify Phone Number Validation API Tutorial [in Google Sheets]

Connecting the NumVerify API to Google Sheets

NumVerify is a powerful REST API offering both national and international phone number validation based on the most recent international numbering plan databases. We can use the NumVerify API and the Apipheny add-on to import data from NumVerify directly into Google Sheets.

In this tutorial, we’ll show you how to connect the NumVerify REST API to Google Sheets in 5 steps:

Install the Apipheny add-on
Obtain an API key
Choose a NumVerify Endpoint
Enter the URL into the Apipheny add-on
Run the API Request in your Google Sheets

Step 1.) Install and open the Apipheny add-on for Google Sheets

Apipheny is an API connector for Google Sheets. You can use Apipheny to connect your Google Sheets to unlimited API data sources, make unlimited API requests, and more. There is a 30 day free trial included.

1.) Install Apipheny by opening the following link on desktop and then clicking the Install button in the Google Marketplace: https://apipheny.io/install

2.) After you’ve installed Apipheny, open a Google Sheet and then click on the Extensions dropdown in the menu at the top.

In the dropdown list you should see Apipheny. Click Apipheny then click Import API to open the Apipheny sidebar in your Google Sheet.

Tip: you can open a new Google Sheet by entering this URL in your browser: sheet.new

Step 2.) Obtain an API key

After signing up for a NumVerify account, a page containing your API Access Key will be displayed:

Numverify dashboard — NumVerify dashboard

Copy and paste your API Access Key to a safe location because you’ll need it to make your API request.

Step 3.) Choose a NumVerify API Endpoint

In this section, I’ll show you how to browse the NumVerify API documentation to find an API URL and endpoint that retrieves the specific information you need from the NumVerify API. An endpoint is the last part of the URL that creates a specific query.

If you already know your API URL, or you want to use the same example URL as us, just skip to Step 4.

First, open the NumVerify API documentation page: https://numverify.com/documentation

The menu on the left contains general information about the NumVerify API and a list of API endpoints:

Numverify documentation page — NumVerify documentation page

An example endpoint group is National (Local) Numbers, which validates a phone number in a local format. The URL for this endpoint is:

http://apilayer.net/api/validate?access_key=YOUR_ACCESS_KEY&number= PHONE_NUMBER&country_code=COUNTRY_CODE

If you use this URL, don’t forget to replace YOUR_ACCESS_KEY with your API access key, PHONE_NUMBER with a phone number, and COUNTRY_CODE with a country code.

When working with national (local) phone numbers, specifying a country code is mandatory.

The documentation for this endpoint contains a description of the endpoint’s purpose, an example request and a number of notes about the accepted parameters:

National (Local) Numbers endpoint documentation

All API calls to the NumVerify API should be made using http://apilayer.net/api/ base domain. All endpoints and parameters should be appended to this base domain.

Step 4.) Enter the NumVerify API request into the Apipheny add-on

Okay, we’re in the home stretch. Now go back to your Google Sheet and make sure that the Apipheny add-on is open on the “Import” tab. With the Import Tab open, enter these details into the add-on:

Method: At the top of the Apipheny sidebar, select the HTTP method (GET or POST) as required by your NumVerify API endpoint. For this example, we are using the GET method.

API URL: In Step 3, we explained how you can find the NumVerify API endpoint that you need. Now copy the complete API URL into the Apipheny add-on, where it says API URL Path, followed by any GET parameters required for your query.

For this example, we are using the Validate phone number endpoint and we will validate a phone number. The corresponding URL for this endpoint is:

http://apilayer.net/api/validate?access_key=YOUR_ACCESS_KEY&number=PHONE_NUMBER

If you use this URL, replace YOUR_ACCESS_KEY with the the API access key you got in step 2, and replace PHONE_NUMBER with a real phone number.

Important: When working with international phone numbers, do not specify a country code parameter.

Headers are not required for this request, you can leave this section blank in Apipheny.

Numverify API request entered into Apipheny — NumVerify API request entered into Apipheny

Step 5.) Run the NumVerify API request in your Google Sheet

The last step is to click the Run button at the bottom of the Apipheny add-on and then your NumVerify data will be imported into your Google Sheet, like so:

Numverify data imported into Google Sheets — NumVerify data imported into Google Sheets

After making a successful request to the NumVerify API, try querying a different NumVerify API endpoint, or try using one of the more advanced features in the Apipheny add-on, such as:

Save and schedule your NumVerify API request
Make a POST request to the NumVerify API (if available)
Use the custom =APIPHENY() function to call the NumVerify API request inside your spreadsheet
Create an API request by referencing the value of a cell in the API URL