Menu

Expand
Rate this page:

Pricing: Trunking Resource

The Pricing Trunking resoure provides a simple API to pull real-time, account-specific pricing for Twilio's Elastic SIP Trunking.

Prices can be retrieved at a country level via the Pricing Trunking Countries resource or for a specific phone number via the Pricing Trunking Numbers resource.

You may also wish to check out our Pricing API resources for Twilio's Voice, Messaging and Phone Number products.

Looking for details on pricing for Twilio products? Check out Twilio's pricing page.

Base URL

All URLs in the reference documentation use the following base URL:

https://pricing.twilio.com/v2/trunking

Authentication

HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation. In short, you will use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.

curl -G https://pricing.twilio.com/v2/Trunking/Countries/US \
    -u '[YOUR ACCOUNT SID]:[YOUR AUTH TOKEN]'

You can find your account SID and auth token on your dashboard.

Pricing Trunking Country List Resource

Resource URL

https://pricing.twilio.com/v2/Trunking/Countries

This resource returns a list of countries where Twilio trunking services are available and the corresponding URL for retrieving the country specific trunking prices. This list includes paging information.

Example

Retrieve a list of countries where Twilio trunking services are available.

Loading Code Sample...
        
        

        Read Country

        Get Prices for Individual Countries

        You can also retrieve pricing information for individual countries.

        Loading Code Sample...
              
              

              Get Trunking Prices for Individual Countries

              Pricing Trunking Country Instance Resource

              Resource URL

              https://pricing.twilio.com/v2/Trunking/Countries/{Country}
              

              where {Country} is the ISO 3166-1 alpha-2 format country code

              This resource represents prices to make trunking calls to phone numbers in a given country, organized by phone number prefix (TerminatingPrefixPriceWithOrigin), and the prices to receive trunking calls on Twilio phone numbers in this country, organized by phone number type (OriginatingCallPrices).

              Resource Properties

              A Pricing Trunking Country resource is represented by the following properties:

              Resource Properties in REST API format
              country
              string Not PII

              The name of the country.

              iso_country
              iso_country_code Not PII

              The ISO country code.

              url
              url Not PII

              The absolute URL of the resource.

              Instance Properties in REST API format
              terminating_prefix_prices
              outbound_prefix_price_with_origin[] Not PII

              The list of TerminatingPrefixPrice records.

              originating_call_prices
              inbound_call_price[] Not PII

              The list of OriginatingCallPrice records.

              price_unit
              currency Not PII

              The currency in which prices are measured, specified in ISO 4127 format (e.g. usd, eur, jpy).

              TerminatingPrefixPrices record

              Property Description
              DestinationPrefixes Set of destination phone number prefixes for the requested country with the same pricing
              OriginationPrefixes Set of origination phone number prefixes for the requested country with the same pricing. Valid set elements include specific prefixes, ALL (representing the entire set of all valid prefixes), or ROW (representing the rest-of-world, which is the set of remaining prefixes that aren't specifically listed)
              FriendlyName Descriptive text for this set of prefixes
              BasePrice In the current version of the API, this value will always be null
              CurrentPrice The current price per minute (which accounts for any volume or custom price discounts) to make a call to numbers matching this prefix list.

              OriginatingCallPrice record

              Property Description
              NumberType The phone number type, either local, mobile, national, or toll free
              BasePrice In the current version of the API, this value will always be null
              CurrentPrice The current price per minute (which accounts for any volume or custom price discounts) to receive a call to this phone number type.

              Pricing Trunking Number Instance Resource

              This resource represents the prices to make trunking calls to a given phone number (TerminatingPrefixPrices) and the prices to receive trunking calls to this Twilio phone number (OriginatingCallPrice).

              Resource URL

              https://pricing.twilio.com/v2/Trunking/Numbers/{Phone Number}
              

              where {Phone Number} is the phone number in E.164 format

              Resource Properties

              Resource Properties in REST API format
              destination_number
              phone_number<e164> Not PII

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

              origination_number
              phone_number<e164> Not PII

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

              country
              string Not PII

              The name of the country.

              iso_country
              iso_country_code Not PII

              The ISO country code

              terminating_prefix_prices
              outbound_prefix_price_with_origin[] Not PII

              originating_call_price
              inbound_call_price Not PII

              The OriginatingCallPrice record.

              price_unit
              currency Not PII

              The currency in which prices are measured, specified in ISO 4127 format (e.g. usd, eur, jpy).

              url
              url Not PII

              The absolute URL of the resource.

              TerminatingCallPrices record

              Property Description
              BasePrice In the current version of the API, this value will always be null
              CurrentPrice The current price per minute (which accounts for any volume or custom price discounts) to make a call to this number
              OriginationPrefixes Set of origination phone number prefixes for the requested country with the same pricing. Valid set elements include specific prefixes, ALL (representing the entire set of all valid prefixes), or ROW (representing the rest-of-world, which is the set of remaining prefixes that aren't specifically listed)

              Example

              Retrieve trunking prices for phone number +15108675310.

              Loading Code Sample...
                    
                    

                    Fetch Number

                    Resource URL by Origination Number

                    https://pricing.twilio.com/v2/Trunking/Numbers/{Destination Number}?OriginationNumber={Origination Number}
                    

                    Filter by Origination Number Example

                    Retrieve trunking prices for phone number +15108675310 where the Origination Number is +18001234567.

                    Loading Code Sample...
                          
                          

                          Get Trunking Prices for Number by Origination Number

                          Rate this page:

                          Need some help?

                          We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

                          Loading Code Sample...
                                
                                
                                

                                Thank you for your feedback!

                                Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                                Sending your feedback...
                                🎉 Thank you for your feedback!
                                Something went wrong. Please try again.

                                Thanks for your feedback!

                                thanks-feedback-gif