Fetch pricing information for a specific destination and, optionally, origination phone number.

GET /v2/Trunking/Numbers/{DestinationNumber}

Trunking pricing for a specific phone number

Fetch pricing information for a specific destination and, optionally, origination phone number.

Path parameters

  • DestinationNumber string(phone-number) Required

    The destination phone number, in E.164 format, for which to fetch the origin-based voice pricing information. E.164 format consists of a + followed by the country code and subscriber number.

Query parameters

  • OriginationNumber string(phone-number)

    The origination phone number, in E.164 format, for which to fetch the origin-based voice pricing information. E.164 format consists of a + followed by the country code and subscriber number.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • destination_number string(phone-number) | null

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

    • origination_number string(phone-number) | null

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

    • country string | null

      The name of the country.

    • iso_country string(iso-country-code) | null
    • terminating_prefix_prices array[object(outbound-prefix-price-with-origin)] | null
      Hide terminating_prefix_prices attributes Show terminating_prefix_prices attributes object(outbound-prefix-price-with-origin)
      • origination_prefixes array[string]
      • destination_prefixes array[string]
      • base_price number
      • current_price number
      • friendly_name string
    • originating_call_price object(inbound-call-price) | null
      Hide originating_call_price attributes Show originating_call_price attributes object(inbound-call-price) | null
      • base_price number
      • current_price number
      • number_type string
    • price_unit string(currency) | null

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

    • url string(uri) | null

      The absolute URL of the resource.

GET /v2/Trunking/Numbers/{DestinationNumber}
curl \
 --request GET 'https://pricing.twilio.com/v2/Trunking/Numbers/{DestinationNumber}' \
 --user "username:password"
Response examples (200)
{
  "url": "https://pricing.twilio.com/v2/Trunking/Numbers/+18001234567",
  "country": "United States",
  "price_unit": "USD",
  "iso_country": "US",
  "destination_number": "+18001234567",
  "origination_number": null,
  "originating_call_price": {
    "base_price": null,
    "number_type": null,
    "current_price": null
  },
  "terminating_prefix_prices": [
    {
      "base_price": null,
      "current_price": "0.013",
      "friendly_name": "Trunking Outbound Minute - United States Zone 1b",
      "destination_prefixes": [
        "1800"
      ],
      "origination_prefixes": [
        "ALL"
      ]
    }
  ]
}
{
  "url": "https://pricing.twilio.com/v2/Trunking/Numbers/+18001234567",
  "country": "United States",
  "price_unit": "USD",
  "iso_country": "US",
  "destination_number": "+18001234567",
  "origination_number": "+15105556789",
  "originating_call_price": {
    "base_price": null,
    "number_type": "tollfree",
    "current_price": "0.013"
  },
  "terminating_prefix_prices": [
    {
      "base_price": null,
      "current_price": "0.001",
      "friendly_name": "Trunking Outbound Minute - United States - Toll Free",
      "destination_prefixes": [
        "1800"
      ],
      "origination_prefixes": [
        "ALL"
      ]
    }
  ]
}