Fetch messaging country

GET /v1/Messaging/Countries/{IsoCountry}

Messaging pricing by country

Path parameters

  • IsoCountry string(iso-country-code) Required

    The ISO country code of the pricing information to fetch.

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
    • country string | null

      The name of the country.

    • iso_country string(iso-country-code) | null
    • outbound_sms_prices array[object(outbound-sms-price)] | null

      The list of OutboundSMSPrice records that represent the price to send a message for each MCC/MNC applicable in this country.

      Hide outbound_sms_prices attributes Show outbound_sms_prices attributes object(outbound-sms-price)
      • carrier string
      • mcc string
      • mnc string
      • prices array[object]
        Hide prices attributes Show prices attributes object
        • base_price number
        • current_price number
        • number_type string
    • inbound_sms_prices array[object(inbound-sms-price)] | null

      The list of InboundPrice records that describe the price to receive an inbound SMS to the different Twilio phone number types supported in this country

      Hide inbound_sms_prices attributes Show inbound_sms_prices attributes object(inbound-sms-price)
      • 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 /v1/Messaging/Countries/{IsoCountry}
curl \
 --request GET 'https://pricing.twilio.com/v1/Messaging/Countries/{IsoCountry}' \
 --user "username:password"
Response examples (200)
{
  "url": "https://pricing.twilio.com/v1/Messaging/Countries/US",
  "country": "country",
  "price_unit": "USD",
  "iso_country": "US",
  "inbound_sms_prices": [
    {
      "base_price": "0.05",
      "number_type": "mobile",
      "current_price": "0.05"
    }
  ],
  "outbound_sms_prices": [
    {
      "mcc": "foo",
      "mnc": "bar",
      "prices": [
        {
          "base_price": "0.05",
          "number_type": "mobile",
          "current_price": "0.05"
        }
      ],
      "carrier": "att"
    }
  ]
}