Find All Toll-Free Numbers

Use this endpoint for the AvailablePhoneNumbers method to find available toll-free numbers in the United States.

Parameters

Parameter
None

---

Examples

Request

cURL

curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree.json \
  -X GET \
  -u "YourProjectID:YourAuthToken"

Node.js

const { RestClient } = require('@signalwire/compatibility-api')
const client = RestClient('YourProjectID', 'YourAuthToken', { signalwireSpaceUrl: 'example.signalwire.com' })

client
  .availablePhoneNumbers('US')
  .tollFree.list()
  .then(availablePhoneNumbers => {
    console.log(availablePhoneNumbers);
  });

C#

using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using Twilio.Rest.Api.V2010.Account.AvailablePhoneNumberCountry;

class Program
{
    static void Main(string[] args)
    {
        TwilioClient.Init("YourProjectID", "YourAuthToken", new Dictionary<string, object> { ["signalwireSpaceUrl"] = "{SPACE}.signalwire.com" });

        var tollFreeAvailableNumbers = TollFreeResource.Read("US");

        Console.WriteLine(tollFreeAvailableNumbers);
    }
}

Python

from signalwire.rest import Client as signalwire_client

client = signalwire_client("YourProjectID", "YourAuthToken", signalwire_space_url = 'example.signalwire.com')

numbers = client.available_phone_numbers("US") \
                .toll_free \
                .list()

print(numbers)

Ruby

require 'signalwire/sdk'

@client = Signalwire::REST::Client.new 'YourProjectID', 'YourAuthToken', signalwire_space_url: "example.signalwire.com"

@numbers = @client.api.available_phone_numbers('US').toll_free
                  .list()

puts @numbers

Response

200 OK

{
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/TollFree",
  "available_phone_numbers": [
    {
      "friendly_name": "310-218-6751",
      "phone_number": "+13102186751",
      "iso_country": "US",
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": true
      },
      "beta": false
    },
    {
      "friendly_name": "310-218-6752",
      "phone_number": "+13102186752",
      "iso_country": "US",
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": true
      },
      "beta": false
    }
  ]
}

Request: Find a Toll-Free Number by String

Find all toll-free numbers that contain WIN, or 946. Some examples of this include: 800-338-3946 or 888-946-3456.

cURL

curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree.json \
  -X GET \
  -d "Contains=WIN"
  -u "YourProjectID:YourAuthToken"

Node.js

const { RestClient } = require('@signalwire/compatibility-api')
const client = RestClient('YourProjectID', 'YourAuthToken', { signalwireSpaceUrl: 'example.signalwire.com' })

client
  .availablePhoneNumbers('US')
  .tollFree.list({
    contains: 'WIN',
  })
  .then(availablePhoneNumbers => {
    console.log(availablePhoneNumbers);
  });

C#

using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using Twilio.Rest.Api.V2010.Account.AvailablePhoneNumberCountry;

class Program
{
    static void Main(string[] args)
    {
        TwilioClient.Init("YourProjectID", "YourAuthToken", new Dictionary<string, object> { ["signalwireSpaceUrl"] = "{SPACE}.signalwire.com" });

        var tollFreeAvailableNumbers = TollFreeResource.Read("US", contains: "WIN");

        Console.WriteLine(tollFreeAvailableNumbers);
    }
}

Python

from signalwire.rest import Client as signalwire_client

client = signalwire_client("YourProjectID", "YourAuthToken", signalwire_space_url = 'example.signalwire.com')

numbers = client.available_phone_numbers("US") \
                .toll_free \
                .list(contains="WIN")

print(numbers)

Ruby

require 'signalwire/sdk'

@client = Signalwire::REST::Client.new 'YourProjectID', 'YourAuthToken', signalwire_space_url: "example.signalwire.com"

@numbers = @client.api.available_phone_numbers('US').toll_free
                  .list(contains: 'WIN')

puts @numbers