Fetch pricing information for a specific destination and

GET /v2/Voice/Numbers/{DestinationNumber}

Voice 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

    OK

    Hide response attributes Show response attributes object
    • country string | null

      The name of the country

    • destination_number string(phone-number) | null

      The destination phone number, in E.164 format

    • inbound_call_price object(inbound-call-price) | null

      The InboundCallPrice record

      Hide inbound_call_price attributes Show inbound_call_price attributes object(inbound-call-price) | null
      • base_price number
      • current_price number
      • number_type string
    • iso_country string(iso-country-code) | null

      The ISO country code

    • origination_number string(phone-number) | null

      The origination phone number, in E.164 format

    • outbound_call_prices array[object(outbound-call-price-with-origin)] | null

      The list of OutboundCallPriceWithOrigin records

      Hide outbound_call_prices attributes Show outbound_call_prices attributes array[object(outbound-call-price-with-origin)] | null
      • base_price number
      • current_price number
      • origination_prefixes array[string]
    • price_unit string(currency) | null

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

    • url string(uri) | null

      The absolute URL of the resource

GET /v2/Voice/Numbers/{DestinationNumber}
curl \
 -X GET https://pricing.twilio.com/v2/Voice/Numbers/{DestinationNumber} \
 --user "username:password"
Response examples (200)
{
  "country": "string",
  "destination_number": "string",
  "inbound_call_price": {
    "base_price": 42.0,
    "current_price": 42.0,
    "number_type": "string"
  },
  "iso_country": "string",
  "origination_number": "string",
  "outbound_call_prices": [
    {
      "base_price": 42.0,
      "current_price": 42.0,
      "origination_prefixes": [
        "string"
      ]
    }
  ],
  "price_unit": "string",
  "url": "https://example.com"
}
Response examples (200)
{
  "country": "string",
  "destination_number": "string",
  "inbound_call_price": {
    "base_price": 42.0,
    "current_price": 42.0,
    "number_type": "string"
  },
  "iso_country": "string",
  "origination_number": "string",
  "outbound_call_prices": [
    {
      "base_price": 42.0,
      "current_price": 42.0,
      "origination_prefixes": [
        "string"
      ]
    }
  ],
  "price_unit": "string",
  "url": "https://example.com"
}