Skip to content
Numbers/Getting started/
/
Search available
Last updated

Search for a virtual number using Node.js SDK

Use this guide to create a Node.js application for use with the Numbers API and search for an available Sinch virtual number.

Note:

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

  • All Numbers API prerequisite steps.

  • NPM and a familiarity with how to install packages.
  • Node.js and a familiarity with how to create a new app.
Steps:
  1. Set up your Node.js application.
  2. Search for an available virtual number for SMS, Voice or both.

Set up your Node.js application

To quickly get started setting up a simple client application using the Node SDK:

  1. If you haven't already, clone the sinch-sdk-node-quickstart repository.

  2. Navigate to the templates/client folder.

  3. Open a command prompt or terminal and run the following command to install the necessary dependencies:

    npm install

  4. Open the .env file. Using the access key credentials from your Sinch Build Dashboard, populate the following fields with your values:

    FieldDescription
    SINCH_PROJECT_IDThe unique ID of your Project.
    SINCH_KEY_IDThe unique ID of your access key.
    SINCH_KEY_SECRETThe secret that goes with your access key.
    Note: For security reasons, this secret is only visible right after access key creation.
    Note

    If you're sending SMS messages, ensure you set your region in the SMS_REGION field.

  5. Save the file.

Modify your application

  1. Navigate to the /templates/client/src/numbers/ folder and open the snippet.js file. Replace the existing content within that file with the snippet.js code provided on this page. That code is also found here if you want to just replace the file.
snippet.js
//This code lists the available numbers for a given set of search criteria. 
// eslint-disable-next-line no-unused-vars
import { Numbers, NumbersService } from '@sinch/sdk-core';

/** @param {NumbersService} numbersService */
export const execute = async (numbersService) => {

  /** @type {Numbers.ListAvailableNumbersRequestData} */
  const requestData = {
    regionCode: 'US',
    type: 'LOCAL',
    capabilities: ['SMS', 'VOICE'],
  };

  const response = await numbersService.availableNumber.list(requestData);

  console.log(`Available numbers to rent:\n${JSON.stringify(response, null, 2)}`);
};
  1. The code provided in snippet.js includes default parameters. If you want, you can replace the following values for these parameters with your own values:
ParameterYour value
regionCodeThe two letter abbreviation of the country for which you'd like a number. For example, the United States is US. Should be in ISO 3166-1 alpha-2 format.
typeThe type of number you would like to rent. Available options are: MOBILE, LOCAL, or TOLL_FREE. Note that 10DLC numbers should be set to LOCAL.
  1. Save the file.

Search for an available number

Now you can execute the code. Run the following command:

node src/app.js

You should receive a response in the console with a list of numbers available to rent.

Next steps

Copy the phoneNumber you would like to use and rent your virtual number using the Numbers API.

Additional resources

Previous page
Next page