Look up numbers in bulk with Node.js

The Number Lookup API lets you look up a phone number to verify it's in service and to check information about the number such as the carrier. In this tutorial you will learn how to look up numbers in bulk using Node.js.

In this guide you will learn how to:

Learn how to:

Set up your Node.js application
Bulk look up your phone numbers

What you need to know before you start

Before you can get started, you need the following already set up:

Set all Number Lookup API configuration settings.
Node.js and a familiarity with how to create a new app.

Set up your Node.js application

First we'll create a Node project using npm.

To create the project, do the following steps:

Create a folder called number-lookup.
Navigate into the folder you created and run the following command.
Copy

Copied
```
npm init
```
This command creates the package.json file. You will be prompted to provide values for the fields. For this tutorial, you can simply accept the default values and press enter at each stage.
Add the fetch and event-stream packages with npm to generate the necessary dependencies.

Copy

Copied

npm install 'cross-fetch'
npm install 'event-stream'

Create your file

Create a new file named index.js in the project and paste the provided "index.js" code into the file.

Note:

This tutorial uses basic authentication for testing purposes. We recommend using a signed request for authentication in a production environment. You can follow the steps in this guide, but use the code samples from here to use request signing authentication instead.

This code contains the logic to read in a list of phone numbers in a text file, look up those numbers, and then write the results of the number lookup calls to a new text file named results.txt in the project folder.

To make this tutorial work, you should have a text file of phone numbers formatted to E.164 standard, with each number on a new line. For example, the text file should look like this:

Copy

Copied

+12345678900
+13334445656
+15556789999

Fill in your parameters

Assign your values to the following parameters:

Parameter	Your value
`APPLICATION_KEY`	The key found on your Sinch dashboard.
`APPLICATION_SECRET`	The secret found on your Sinch dashboard.
`FILE_PATH`	This is the file path to the text file containing the phone numbers you want to look up.

Save the file.

Bulk look up your phone numbers

Now you can execute the code and look up your phone numbers. Run the following command:

Copy

Copied

node index.js

The application should create a text file named results.txt in your project folder, containing the information responses for each of the phone numbers in your original list of numbers.

Troubleshooting tip

If after running your app you receive a 5000 error response, you may have forgotten to save your file after adding your authentication values. This is an easy mistake to make! Try saving the file and running the app again.

Additional resources

API specification