メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

REST API: 利用可能電話番号

The subresources of the AvailablePhoneNumbers resource let you search for local, toll-free and mobile phone numbers that are available for you to purchase. You can search for phone numbers that match a pattern, are in a certain country, are in certain area code (NPA) or exchange (NXX) or are in a specific geography.

購入したい番号が見つかったら、HTTP POST リクエストを IncomingPhoneNumbers リスト リソース に発行し、番号を PhoneNumber パラメーターとして渡します。

Twilio は、豊富な種類の番号をストックしています。 国別の購入可能な番号については、 料金ページ を参照してください。

AvailablePhoneNumber 国内番号 インスタンス リソース

リソースURI

AvailablePhoneNumber はURLをもちません。AvailablePhoneNumber インスタンスリソースに直接リクエストを送信することはできません。その代わりに、ローカルリストサブリソースへリクエストをう送信し、リストから電話番号を選択してください。

リソースのプロパティ

The following properties are available for all available phone number resources:

Names in PHP format
friendlyName
phone_number Not PII

A formatted version of the phone number.

phoneNumber
phone_number Not PII

The phone number in E.164 format, which consists of a + followed by the country code and subscriber number.

lata
文字列 Not PII

The LATA of this phone number. Available for only phone numbers from the US and Canada.

locality
文字列 Not PII

The locality or city of this phone number's location.

rateCenter
文字列 Not PII

The rate center of this phone number. Available for only phone numbers from the US and Canada.

latitude
decimal Not PII

The latitude of this phone number's location. Available for only phone numbers from the US and Canada.

longitude
decimal Not PII

The longitude of this phone number's location. Available for only phone numbers from the US and Canada.

region
文字列 Not PII

The two-letter state or province abbreviation of this phone number's location. Available for only phone numbers from the US and Canada.

postalCode
文字列 Not PII

The postal or ZIP code of this phone number's location. Available for only phone numbers from the US and Canada.

isoCountry
iso_country_code Not PII

この電話番号の ISO 国コード です。

addressRequirements
文字列 Not PII

The type of Address resource the phone number requires. Can be: none, any, local, or foreign. none means no address is required. any means an address is required, but it can be anywhere in the world. local means an address in the phone number's country is required. foreign means an address outside of the phone number's country is required.

beta
boolean Not PII

Whether the phone number is new to the Twilio platform. Can be: true or false.

capabilities
phone_number_capabilities Not PII

The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are: Voice, SMS, and MMS and each capability can be: true or false.

Address Requirements Values

下記は address_requirements プロパティ として取りうる値です。

Status 概要
none このアドレスは電話番号に必要ではありません。
any このアカウントは住所を必要としています。しかし、世界中のどこでもご利用いただけます。
local このアカウントは電話番号の国の住所が必要です。
foreign あなたのアカウントは電話番号の国ではない住所が必要です。

AvailablePhoneNumber 無料電話番号インスタンス リソース

Twilio has a range of available toll-free numbers across different countries that you can purchase.

リソースURI

An AvailablePhoneNumber Toll-Free instance resource has no URI. You cannot make requests directly to AvailablePhoneNumber instance resources. Instead, make a request to the toll-free list subresource and then choose a number from the list.

リソースのプロパティ

Names in PHP format
friendlyName
phone_number Not PII

A formatted version of the phone number.

phoneNumber
phone_number Not PII

The phone number in E.164 format, which consists of a + followed by the country code and subscriber number.

lata
文字列 Not PII

The LATA of this phone number. Available for only phone numbers from the US and Canada.

locality
文字列 Not PII

The locality or city of this phone number's location.

rateCenter
文字列 Not PII

The rate center of this phone number. Available for only phone numbers from the US and Canada.

latitude
decimal Not PII

The latitude of this phone number's location. Available for only phone numbers from the US and Canada.

longitude
decimal Not PII

The longitude of this phone number's location. Available for only phone numbers from the US and Canada.

region
文字列 Not PII

The two-letter state or province abbreviation of this phone number's location. Available for only phone numbers from the US and Canada.

postalCode
文字列 Not PII

The postal or ZIP code of this phone number's location. Available for only phone numbers from the US and Canada.

isoCountry
iso_country_code Not PII

この電話番号の ISO 国コード です。

addressRequirements
文字列 Not PII

The type of Address resource the phone number requires. Can be: none, any, local, or foreign. none means no address is required. any means an address is required, but it can be anywhere in the world. local means an address in the phone number's country is required. foreign means an address outside of the phone number's country is required.

beta
boolean Not PII

Whether the phone number is new to the Twilio platform. Can be: true or false.

capabilities
phone_number_capabilities Not PII

The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are: Voice, SMS, and MMS and each capability can be: true or false.


AvailablePhoneNumber 携帯電話インスタンスリソース

リソースURI

AvailablePhoneNumber 携帯電話インスタンスリソースはURLを持ちませんAvailablePhoneNumber インスタンスリソースに直接リクエストを送ることはできません。その代わりに、携帯電話リストサブリソースにリクエストを送り、そのリストの中から番号を選択します。

リソースのプロパティ

Names in PHP format
friendlyName
phone_number Not PII

A formatted version of the phone number.

phoneNumber
phone_number Not PII

The phone number in E.164 format, which consists of a + followed by the country code and subscriber number.

lata
文字列 Not PII

The LATA of this phone number. Available for only phone numbers from the US and Canada.

locality
文字列 Not PII

The locality or city of this phone number's location.

rateCenter
文字列 Not PII

The rate center of this phone number. Available for only phone numbers from the US and Canada.

latitude
decimal Not PII

The latitude of this phone number's location. Available for only phone numbers from the US and Canada.

longitude
decimal Not PII

The longitude of this phone number's location. Available for only phone numbers from the US and Canada.

region
文字列 Not PII

The two-letter state or province abbreviation of this phone number's location. Available for only phone numbers from the US and Canada.

postalCode
文字列 Not PII

The postal or ZIP code of this phone number's location. Available for only phone numbers from the US and Canada.

isoCountry
iso_country_code Not PII

この電話番号の ISO 国コード です。

addressRequirements
文字列 Not PII

The type of Address resource the phone number requires. Can be: none, any, local, or foreign. none means no address is required. any means an address is required, but it can be anywhere in the world. local means an address in the phone number's country is required. foreign means an address outside of the phone number's country is required.

beta
boolean Not PII

Whether the phone number is new to the Twilio platform. Can be: true or false.

capabilities
phone_number_capabilities Not PII

The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are: Voice, SMS, and MMS and each capability can be: true or false.

電話番号の検索と購入

Buy combining the AvailablePhoneNumbers lookup (examples below) with an IncomingPhoneNumbers purchase you can purchase any number based on a wide set of criteria. You can search for available numbers that match a specific pattern, are in a specific geographic area,or are near other numbers just to name a few. Once you've found a number you'd like to buy you simply POST the number to the IncomingPhoneNumbers resource.

AvailablePhoneNumbers 国内番号リスト サブリソース

リソースURI

/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountryCode}/Local

{IsoCountryCode} は ISO 3166-1 alpha-2 フォーマットの国コードです。たとえば、カナダの ISO 国コードは CA です。 サポート対象国 の国名と Twilio がサポートする IsoCountryCode の完全なリストを参照してください。

HTTP GET

指定したフィルターに一致する国内番号の AvailablePhoneNumber リソース表現のリストを返します。各項目は、ユーザーのアカウントで現在プロビジョニング可能な電話番号を表現します。

基本的なリスト フィルター

次の基本的な GET クエリ パラメーターを使って、Twilio が返却する番号リストをフィルタリングできます。 パラメーターの大文字と小文字は区別されます。

Names in PHP format
accountSid
必須
GET sid<AC> Not PII

The SID of the Account requesting the AvailablePhoneNumber resources.

countryCode
必須
GET iso_country_code Not PII

The ISO-3166-1 country code of the country from which to read phone numbers.

areaCode
オプション
GET integer Not PII

The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.

contains
オプション
GET 文字列 Not PII

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
オプション
GET boolean Not PII

Whether the phone numbers can receive text messages. Can be: true or false.

mmsEnabled
オプション
GET boolean Not PII

Whether the phone numbers can receive MMS messages. Can be: true or false.

voiceEnabled
オプション
GET boolean Not PII

Whether the phone numbers can receive calls. Can be: true or false.

excludeAllAddressRequired
オプション
GET boolean Not PII

Whether to exclude phone numbers that require an Address. Can be: true or false and the default is false.

excludeLocalAddressRequired
オプション
GET boolean Not PII

Whether to exclude phone numbers that require a local Address. Can be: true or false and the default is false.

excludeForeignAddressRequired
オプション
GET boolean Not PII

Whether to exclude phone numbers that require a foreign Address. Can be: true or false and the default is false.

beta
オプション
GET boolean Not PII

Whether to read phone numbers that are new to the Twilio platform. Can be: true or false and the default is true.

nearNumber
オプション
GET phone_number<e164> Not PII

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
オプション
GET 文字列 Not PII

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
オプション
GET integer Not PII

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
オプション
GET 文字列 Not PII

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
オプション
GET 文字列 Not PII

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
オプション
GET 文字列 Not PII

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
オプション
GET 文字列 Not PII

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
オプション
GET 文字列 Not PII

Limit results to a particular locality or city. Given a phone number, search within the same Locality as that number.

faxEnabled
オプション
GET boolean Not PII

Whether the phone numbers can receive faxes. Can be: true or false.

購入可能な市内電話番号の検索

アメリカ国内の、エリア コード 510 で購入可能な番号を検索します。

        
        
        
        

        番号パターンによる電話番号の検索

        アメリカ国内の、510555 で始まる購入可能な番号を検索します。

              
              
              
              

              パターンによる電話番号の検索

              パターン「STORM」に一致する国内電話番号を検索します。

                    
                    
                    
                    

                    州による購入可能な電話番号の検索

                    アーカンソー州の購入可能な電話番号を検索します。

                          
                          
                          
                          

                          購入可能な市内電話番号の検索

                          SMSが有効なロンドンの電話番号(プレフィックスが+4420)を探してみましょう

                                
                                
                                
                                

                                機能を指定した地域電話番号の検索

                                イギリスの音声、SMSが有効な電話番号を探してみましょう

                                      
                                      
                                      
                                      
                                            
                                            
                                            
                                            
                                                  
                                                  
                                                  
                                                  

                                                  Advanced List Filter Example

                                                  These features are limited to US and Canadian phone numbers. Find local phone numbers within 50 miles of San Francisco, CA (37.840699,-122.461853) that contain the digits '555'.

                                                        
                                                        
                                                        
                                                        

                                                        HTTP POST

                                                        サポートしません。

                                                        HTTP PUT

                                                        サポートしません。

                                                        HTTP DELETE

                                                        サポートしません。

                                                        AvailablePhoneNumbers 無料電話番号リスト サブリソース

                                                        リソースURI

                                                        /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountryCode}/TollFree
                                                        

                                                        {IsoCountryCode} は ISO 3166-1 alpha-2 フォーマット の国コードです (US はアメリカ、CA はカナダ、GB はイギリス)。

                                                        HTTP GET

                                                        指定したフィルターに一致する無料電話番号の AvailablePhoneNumber 要素のリストを返します。各項目は、ユーザーのアカウントで現在プロビジョニング可能な電話番号を表現します。 電話番号をプロビジョニングするには、電話番号を IncomingPhoneNumber リソースに POST します。

                                                        リストフィルター

                                                        下記のGETのクエリー文字列パラメーターを使用すると、返される一覧を制限することができます。 パラメーターは大文字と小文字を区別することに注意してください:

                                                        Names in PHP format
                                                        accountSid
                                                        必須
                                                        GET sid<AC> Not PII

                                                        The SID of the Account requesting the AvailablePhoneNumber resources.

                                                        countryCode
                                                        必須
                                                        GET iso_country_code Not PII

                                                        The ISO-3166-1 country code of the country from which to read phone numbers.

                                                        areaCode
                                                        オプション
                                                        GET integer Not PII

                                                        The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.

                                                        contains
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether the phone numbers can receive text messages. Can be: true or false.

                                                        mmsEnabled
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether the phone numbers can receive MMS messages. Can be: true or false.

                                                        voiceEnabled
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether the phone numbers can receive calls. Can be: true or false.

                                                        excludeAllAddressRequired
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether to exclude phone numbers that require an Address. Can be: true or false and the default is false.

                                                        excludeLocalAddressRequired
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether to exclude phone numbers that require a local Address. Can be: true or false and the default is false.

                                                        excludeForeignAddressRequired
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether to exclude phone numbers that require a foreign Address. Can be: true or false and the default is false.

                                                        beta
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether to read phone numbers that are new to the Twilio platform. Can be: true or false and the default is true.

                                                        nearNumber
                                                        オプション
                                                        GET phone_number<e164> Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET integer Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        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
                                                        オプション
                                                        GET 文字列 Not PII

                                                        Limit results to a particular locality or city. Given a phone number, search within the same Locality as that number.

                                                        faxEnabled
                                                        オプション
                                                        GET boolean Not PII

                                                        Whether the phone numbers can receive faxes. Can be: true or false.

                                                              
                                                              
                                                              
                                                              

                                                              文字列を指定した着課金方式電話番号の検索

                                                              指定した数字列を含む電話番号を検索します。Contains=866 とすると、数字の 866 を含む着課金方式電話番号がマッチします。866-555-3455 や 888-866-0555 などです。Contains=866***EPIC とすると、数字の 866 で始まり、その後に任意の 3 桁の数字、さらに数字の 3742 (「EPIC」) が続く番号がマッチします。 パターン「STORM」にマッチする着課金方式電話番号を検索する場合は、次のリクエストを発行します。