# Find All Toll-Free Numbers Use this endpoint for the [AvailablePhoneNumbers](./index.mdx) method to find available toll-free numbers in the United States. ## Parameters | Parameter | | :- | | None | ## Examples ### Request shell curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree.json \ -X GET \ -u YourProjectID:YourAuthToken javascript 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); }); csharp 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 { [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
json { 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**. shell curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree.json \ -X GET \ -d Contains=WIN -u YourProjectID:YourAuthToken javascript 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); }); csharp 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 { [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