components: securitySchemes: accountSid_authToken: scheme: basic type: http schemas: pricing.v1.messaging: type: object properties: name: type: string nullable: true url: type: string format: uri nullable: true links: type: object format: uri-map nullable: true pricing.v1.messaging.messaging_country: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.messaging.messaging_country-instance: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). outbound_sms_prices: type: array items: type: object format: outbound-sms-price properties: carrier: type: string mcc: type: string mnc: type: string prices: type: array items: type: object properties: base_price: type: number current_price: type: number number_type: type: string nullable: true description: The list of [OutboundSMSPrice](https://www.twilio.com/docs/sms/api/pricing#outbound-sms-price) records that represent the price to send a message for each MCC/MNC applicable in this country. inbound_sms_prices: type: array items: type: object format: inbound-sms-price properties: base_price: type: number current_price: type: number number_type: type: string nullable: true description: The list of [InboundPrice](https://www.twilio.com/docs/sms/api/pricing#inbound-price) records that describe the price to receive an inbound SMS to the different Twilio phone number types supported in this country price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.phone_number: type: object properties: name: type: string nullable: true url: type: string format: uri nullable: true links: type: object format: uri-map nullable: true pricing.v1.phone_number.phone_number_country: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.phone_number.phone_number_country-instance: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). phone_number_prices: type: array items: type: object format: phone-number-price properties: base_price: type: number current_price: type: number number_type: type: string nullable: true description: The list of [PhoneNumberPrice](https://www.twilio.com/docs/phone-numbers/pricing#phone-number-price) records. price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.voice: type: object properties: name: type: string nullable: true url: type: string format: uri nullable: true links: type: object format: uri-map nullable: true pricing.v1.voice.voice_country: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.voice.voice_country-instance: type: object properties: country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). outbound_prefix_prices: type: array items: type: object format: outbound-prefix-price properties: prefixes: type: array items: type: string base_price: type: number current_price: type: number friendly_name: type: string nullable: true description: The list of OutboundPrefixPrice records, which include a list of the `prefixes`, the `friendly_name`, `base_price`, and the `current_price` for those prefixes. inbound_call_prices: type: array items: type: object format: inbound-call-price properties: base_price: type: number current_price: type: number number_type: type: string nullable: true description: The list of [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) records. price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v1.voice.voice_number: type: object properties: number: type: string format: phone-number nullable: true description: The phone number. country: type: string nullable: true description: The name of the country. iso_country: type: string format: iso-country-code nullable: true description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). outbound_call_price: type: object format: outbound-call-price properties: base_price: type: number current_price: type: number nullable: true description: The OutboundCallPrice record, which includes a list of `origination_prefixes` and the `base_price` and `current_price` for those prefixes. inbound_call_price: type: object format: inbound-call-price properties: base_price: type: number current_price: type: number number_type: type: string nullable: true description: The [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) record. If `null`, the Phone Number is not a Twilio number owned by this account. price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). url: type: string format: uri nullable: true description: The absolute URL of the resource. info: title: Twilio - Pricing description: This is the public Twilio REST API. termsOfService: https://www.twilio.com/legal/tos contact: name: Twilio Support url: https://support.twilio.com email: support@twilio.com license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.0 openapi: 3.0.1 paths: /v1/Messaging: servers: - url: https://pricing.twilio.com description: '' x-twilio: defaultOutputProperties: - name pathType: instance /v1/Messaging/Countries: servers: - url: https://pricing.twilio.com description: Messaging pricing by country x-twilio: defaultOutputProperties: - country - outbound_sms_prices - inbound_sms_prices - price_unit parent: /Messaging pathType: list get: description: '' tags: - PricingV1Country parameters: - name: PageSize in: query description: How many resources to return in each list page. The default is 50, and the maximum is 1000. schema: type: integer minimum: 1 maximum: 1000 - name: Page in: query description: The page index. This value is simply for client state. schema: type: integer minimum: 0 - name: PageToken in: query description: The page token. This is provided by the API. schema: type: string responses: '200': content: application/json: schema: type: object properties: countries: type: array items: $ref: '#/components/schemas/pricing.v1.messaging.messaging_country' meta: properties: first_page_url: format: uri type: string key: type: string next_page_url: format: uri nullable: true type: string page: type: integer page_size: type: integer previous_page_url: format: uri nullable: true type: string url: format: uri type: string type: object title: ListMessagingCountryResponse examples: readEmpty: value: countries: [] meta: first_page_url: https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0 key: countries next_page_url: null page: 0 page_size: 50 previous_page_url: null url: https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0 readFull: value: countries: - country: country iso_country: US url: https://pricing.twilio.com/v1/Messaging/Countries/US meta: first_page_url: https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0 key: countries next_page_url: null page: 0 page_size: 50 previous_page_url: null url: https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0 headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: ListMessagingCountry /v1/Messaging/Countries/{IsoCountry}: servers: - url: https://pricing.twilio.com description: Messaging pricing by country x-twilio: defaultOutputProperties: - country - outbound_sms_prices - inbound_sms_prices - price_unit parent: /Messaging pathType: instance get: description: '' tags: - PricingV1Country parameters: - name: IsoCountry in: path description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the pricing information to fetch. schema: type: string format: iso-country-code required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v1.messaging.messaging_country-instance' examples: fetch: value: country: country inbound_sms_prices: - base_price: '0.05' current_price: '0.05' number_type: mobile iso_country: US outbound_sms_prices: - carrier: att mcc: foo mnc: bar prices: - base_price: '0.05' current_price: '0.05' number_type: mobile price_unit: USD url: https://pricing.twilio.com/v1/Messaging/Countries/US headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: FetchMessagingCountry /v1/PhoneNumbers: servers: - url: https://pricing.twilio.com description: '' x-twilio: defaultOutputProperties: - name pathType: list /v1/PhoneNumbers/Countries: servers: - url: https://pricing.twilio.com description: Phone number pricing by country x-twilio: defaultOutputProperties: - country - price_unit parent: /PhoneNumbers pathType: list get: description: '' tags: - PricingV1Country parameters: - name: PageSize in: query description: How many resources to return in each list page. The default is 50, and the maximum is 1000. schema: type: integer minimum: 1 maximum: 1000 - name: Page in: query description: The page index. This value is simply for client state. schema: type: integer minimum: 0 - name: PageToken in: query description: The page token. This is provided by the API. schema: type: string responses: '200': content: application/json: schema: type: object properties: countries: type: array items: $ref: '#/components/schemas/pricing.v1.phone_number.phone_number_country' meta: properties: first_page_url: format: uri type: string key: type: string next_page_url: format: uri nullable: true type: string page: type: integer page_size: type: integer previous_page_url: format: uri nullable: true type: string url: format: uri type: string type: object title: ListPhoneNumberCountryResponse examples: readFull: value: countries: - country: Austria iso_country: AT url: https://pricing.twilio.com/v1/PhoneNumbers/Countries/AT meta: page: 0 page_size: 50 first_page_url: https://pricing.twilio.com/v1/PhoneNumbers/Countries?PageSize=50&Page=0 previous_page_url: null url: https://pricing.twilio.com/v1/PhoneNumbers/Countries?PageSize=50&Page=0 next_page_url: null key: countries readEmpty: value: countries: [] meta: first_page_url: https://pricing.twilio.com/v1/PhoneNumbers/Countries?PageSize=50&Page=0 key: countries next_page_url: null page: 0 page_size: 50 previous_page_url: null url: https://pricing.twilio.com/v1/PhoneNumbers/Countries?PageSize=50&Page=0 headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: ListPhoneNumberCountry /v1/PhoneNumbers/Countries/{IsoCountry}: servers: - url: https://pricing.twilio.com description: Phone number pricing by country x-twilio: defaultOutputProperties: - country - price_unit parent: /PhoneNumbers pathType: instance get: description: '' tags: - PricingV1Country parameters: - name: IsoCountry in: path description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the pricing information to fetch. schema: type: string format: iso-country-code required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v1.phone_number.phone_number_country-instance' examples: fetch: value: country: United States iso_country: US phone_number_prices: - number_type: local base_price: '1.00' current_price: '1.00' - number_type: toll free base_price: '2.00' current_price: '2.00' price_unit: USD url: https://pricing.twilio.com/v1/PhoneNumbers/Countries/US headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: FetchPhoneNumberCountry /v1/Voice: servers: - url: https://pricing.twilio.com description: '' x-twilio: defaultOutputProperties: - name pathType: instance /v1/Voice/Countries: servers: - url: https://pricing.twilio.com description: Voice pricing by country x-twilio: defaultOutputProperties: - country - price_unit parent: /Voice pathType: list get: description: '' tags: - PricingV1Country parameters: - name: PageSize in: query description: How many resources to return in each list page. The default is 50, and the maximum is 1000. schema: type: integer minimum: 1 maximum: 1000 - name: Page in: query description: The page index. This value is simply for client state. schema: type: integer minimum: 0 - name: PageToken in: query description: The page token. This is provided by the API. schema: type: string responses: '200': content: application/json: schema: type: object properties: countries: type: array items: $ref: '#/components/schemas/pricing.v1.voice.voice_country' meta: properties: first_page_url: format: uri type: string key: type: string next_page_url: format: uri nullable: true type: string page: type: integer page_size: type: integer previous_page_url: format: uri nullable: true type: string url: format: uri type: string type: object title: ListVoiceCountryResponse examples: readFull: value: countries: - country: Andorra iso_country: AD url: https://pricing.twilio.com/v1/Voice/Countries/AD meta: first_page_url: https://pricing.twilio.com/v1/Voice/Countries?PageSize=50&Page=0 key: countries next_page_url: null page: 0 page_size: 50 previous_page_url: null url: https://pricing.twilio.com/v1/Voice/Countries?PageSize=50&Page=0 readEmpty: value: countries: [] meta: first_page_url: https://pricing.twilio.com/v1/Voice/Countries?PageSize=50&Page=0 key: countries next_page_url: null page: 0 page_size: 50 previous_page_url: null url: https://pricing.twilio.com/v1/Voice/Countries?PageSize=50&Page=0 headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: ListVoiceCountry /v1/Voice/Countries/{IsoCountry}: servers: - url: https://pricing.twilio.com description: Voice pricing by country x-twilio: defaultOutputProperties: - country - price_unit parent: /Voice pathType: instance get: description: '' tags: - PricingV1Country parameters: - name: IsoCountry in: path description: The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the pricing information to fetch. schema: type: string format: iso-country-code required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v1.voice.voice_country-instance' examples: fetch: value: country: United States inbound_call_prices: - current_price: '0.0085' number_type: local base_price: '0.0085' - current_price: '0.022' number_type: toll free base_price: '0.022' iso_country: US outbound_prefix_prices: - prefixes: - '1907' current_price: '0.090' friendly_name: Programmable Outbound Minute - United States - Alaska base_price: '0.090' price_unit: USD url: https://pricing.twilio.com/v1/Voice/Countries/US headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: FetchVoiceCountry /v1/Voice/Numbers/{Number}: servers: - url: https://pricing.twilio.com description: Voice pricing for a specific phone number x-twilio: defaultOutputProperties: - country - outbound_call_price - inbound_call_price - price_unit parent: /Voice pathType: instance get: description: '' tags: - PricingV1Number parameters: - name: Number in: path description: The phone number to fetch. schema: type: string format: phone-number required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v1.voice.voice_number' examples: fetch: value: country: Iran inbound_call_price: base_price: null current_price: null number_type: null iso_country: IR number: '+987654321' outbound_call_price: base_price: '0.255' current_price: '0.255' price_unit: USD url: https://pricing.twilio.com/v1/Voice/Numbers/+987654321 headers: Access-Control-Allow-Origin: description: Specify the origin(s) allowed to access the resource schema: type: string example: '*' Access-Control-Allow-Methods: description: Specify the HTTP methods allowed when accessing the resource schema: type: string example: POST, OPTIONS Access-Control-Allow-Headers: description: Specify the headers allowed when accessing the resource schema: type: string example: Content-Type, Authorization Access-Control-Allow-Credentials: description: Indicates whether the browser should include credentials schema: type: boolean Access-Control-Expose-Headers: description: Headers exposed to the client schema: type: string example: X-Custom-Header1, X-Custom-Header2 description: OK security: - accountSid_authToken: [] operationId: FetchVoiceNumber /v1/Voice/Numbers: servers: - url: https://pricing.twilio.com description: Voice pricing for a specific phone number x-twilio: defaultOutputProperties: - country - outbound_call_price - inbound_call_price - price_unit parent: /Voice pathType: list servers: - url: https://pricing.twilio.com tags: - name: PricingV1Country - name: PricingV1Number security: - accountSid_authToken: []