List Available Phone Number Toll Free
GET {{twilio_api}}/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/TollFree.json?AreaCode=-88848053&Contains=aliqua dolore &SmsEnabled=true&MmsEnabled=true&VoiceEnabled=true&ExcludeAllAddressRequired=true&ExcludeLocalAddressRequired=true&ExcludeForeignAddressRequired=true&Beta=true&NearNumber=aliqua dolore &NearLatLong=aliqua dolore &Distance=-88848053&InPostalCode=aliqua dolore &InRegion=aliqua dolore &InRateCenter=aliqua dolore &InLata=aliqua dolore &InLocality=aliqua dolore &FaxEnabled=true&PageSize=16
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
AreaCode | number | The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada. | |
Contains | string | The pattern on which to match phone numbers. Valid characters are * , 0-9 , a-z , and A-Z . The * character matches any single digit. For examples, see Example 2 and Example 3. If specified, this value must have at least two characters. | |
SmsEnabled | boolean | Whether the phone numbers can receive text messages. Can be: true or false . | |
MmsEnabled | boolean | Whether the phone numbers can receive MMS messages. Can be: true or false . | |
VoiceEnabled | boolean | Whether the phone numbers can receive calls. Can be: true or false . | |
ExcludeAllAddressRequired | boolean | Whether to exclude phone numbers that require an Address. Can be: true or false and the default is false . | |
ExcludeLocalAddressRequired | boolean | Whether to exclude phone numbers that require a local Address. Can be: true or false and the default is false . | |
ExcludeForeignAddressRequired | boolean | Whether to exclude phone numbers that require a foreign Address. Can be: true or false and the default is false . | |
Beta | boolean | Whether to read phone numbers that are new to the Twilio platform. Can be: true or false and the default is true . | |
NearNumber | string | Given a phone number, find a geographically close number within distance miles. Distance defaults to 25 miles. Applies to only phone numbers in the US and Canada. | |
NearLatLong | string | Given a latitude/longitude pair lat,long find geographically close numbers within distance miles. Applies to only phone numbers in the US and Canada. | |
Distance | number | The search radius, in miles, for a near_ query. Can be up to 500 and the default is 25 . Applies to only phone numbers in the US and Canada. | |
InPostalCode | string | Limit results to a particular postal code. Given a phone number, search within the same postal code as that number. Applies to only phone numbers in the US and Canada. | |
InRegion | string | Limit results to a particular region, state, or province. Given a phone number, search within the same region as that number. Applies to only phone numbers in the US and Canada. | |
InRateCenter | string | Limit results to a specific rate center, or given a phone number search within the same rate center as that number. Requires in_lata to be set as well. Applies to only phone numbers in the US and Canada. | |
InLata | string | Limit results to a specific local access and transport area (LATA). Given a phone number, search within the same LATA as that number. Applies to only phone numbers in the US and Canada. | |
InLocality | string | Limit results to a particular locality or city. Given a phone number, search within the same Locality as that number. | |
FaxEnabled | boolean | Whether the phone numbers can receive faxes. Can be: true or false . | |
PageSize | number | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"available_phone_numbers":[{"friendly_name":"laboris","phone_number":"sint","lata":"ut","locality":"enim pariatur dolore ullamco","rate_center":"nostrud eu aliquip","latitude":37189054.305036336,"longitude":79383102.7228393,"region":"id ut consectetur qui","postal_code":"ut labore consequat sunt Duis","iso_country":"incididunt","address_requirements":"nostrud ullamco velit","beta":true,"capabilities":{"mms":false,"sms":true,"voice":false,"fax":true}},{"friendly_name":"qui","phone_number":"magna tempor eu","lata":"esse","locality":"sint aliquip voluptate","rate_center":"nostrud tempor Excepteur amet","latitude":-88465994.69031751,"longitude":5138047.7003159225,"region":"officia in dolor cillum","postal_code":"magna amet consequat occaecat Duis","iso_country":"commodo enim dolor","address_requirements":"velit","beta":false,"capabilities":{"mms":false,"sms":true,"voice":false,"fax":true}}],"end":95074676,"first_page_uri":"http://JfQcSlhjGDWQiFJvgfEVtFbTAODBeaF.bonhYVgZjEgIivvqoEF3hpQXnACLNFQjQSitGBlmWjQm","next_page_uri":"https://wfiN.phmbSDN2-XBNh2NzNuh4y8y4BhOFwQGMoAif6mUvc.cQF","page":98381129,"page_size":-53356746,"previous_page_uri":"http://OPJ.vaxujJJGSvtpqNkJOi9IFLiY1vZRQuE,X8wpPuqN1.OWc2vzqVlfiHDKg3gjxohtiF","start":-23282783,"uri":"https://tffkBSKqyjVagLhwyahoTprcCMlUzMDP.evcidx6mHgx35eEZ0R3GTc5PWc4nvm0EQR+cFgbaQ3iDF"}