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

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/pricing_v2/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"pricing_v2 MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/pricing_v2/mcp"
}
Close
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 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
    • 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 object(outbound-call-price-with-origin)
      • base_price number
      • current_price number
      • origination_prefixes array[string]
    • 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
    • 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/Voice/Numbers/{DestinationNumber}
curl \
 --request GET 'https://pricing.twilio.com/v2/Voice/Numbers/{DestinationNumber}' \
 --user "username:password"
Response examples (200)
{
  "country": "United States",
  "destination_number": "+18001234567",
  "inbound_call_price": {
    "base_price": null,
    "current_price": null,
    "number_type": null
  },
  "iso_country": "US",
  "origination_number": "+987654321",
  "outbound_call_prices": [
    {
      "base_price": "0.013",
      "current_price": "0.013",
      "origination_prefixes": [
        "ALL"
      ]
    }
  ],
  "price_unit": "USD",
  "url": "https://pricing.twilio.com/v2/Voice/Numbers/+18001234567"
}