components: securitySchemes: accountSid_authToken: scheme: basic type: http schemas: pricing.v2.trunking_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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v2.trunking_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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). terminating_prefix_prices: type: array items: type: object format: outbound-prefix-price-with-origin properties: origination_prefixes: type: array items: type: string destination_prefixes: type: array items: type: string base_price: type: number current_price: type: number friendly_name: type: string nullable: true description: The list of [TerminatingPrefixPrice](https://www.twilio.com/docs/voice/pricing#outbound-prefix-price-with-origin) records. originating_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 [OriginatingCallPrice](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](https://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.v2.trunking_number: type: object properties: destination_number: type: string format: phone-number nullable: true description: The destination phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. origination_number: type: string format: phone-number nullable: true description: The origination phone number in [[E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) terminating_prefix_prices: type: array items: type: object format: outbound-prefix-price-with-origin properties: origination_prefixes: type: array items: type: string destination_prefixes: type: array items: type: string base_price: type: number current_price: type: number friendly_name: type: string nullable: true originating_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 [OriginatingCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) record. price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](https://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.v2.voice: type: object properties: name: type: string nullable: true description: The resource name. url: type: string format: uri nullable: true description: The absolute URL of the resource. links: type: object format: uri-map nullable: true description: The URLs of the related Countries and Numbers resources. pricing.v2.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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). url: type: string format: uri nullable: true description: The absolute URL of the resource. pricing.v2.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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). outbound_prefix_prices: type: array items: type: object format: outbound-prefix-price-with-origin properties: origination_prefixes: type: array items: type: string destination_prefixes: type: array items: type: string base_price: type: number current_price: type: number friendly_name: type: string nullable: true description: The list of [OutboundPrefixPriceWithOrigin](https://www.twilio.com/docs/voice/pricing#outbound-prefix-price-with-origin) records. 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](https://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.v2.voice.voice_number: type: object properties: destination_number: type: string format: phone-number nullable: true description: The destination phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. origination_number: type: string format: phone-number nullable: true description: The origination phone number in [[E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) outbound_call_prices: type: array items: type: object format: outbound-call-price-with-origin properties: base_price: type: number current_price: type: number origination_prefixes: type: array items: type: string nullable: true description: The list of [OutboundCallPriceWithOrigin](https://www.twilio.com/docs/voice/pricing#outbound-call-price-with-origin) records. 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. price_unit: type: string format: currency nullable: true description: The currency in which prices are measured, specified in [ISO 4127](https://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: /v2/Trunking/Countries: servers: - url: https://pricing.twilio.com description: Trunking pricing by country x-twilio: defaultOutputProperties: - country - price_unit pathType: list get: description: '' summary: '' tags: - PricingV2Country 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 format: int64 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.v2.trunking_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: ListTrunkingCountryResponse examples: readFull: value: countries: - country: Andorra iso_country: AD url: https://pricing.twilio.com/v2/Trunking/Countries/AD meta: first_page_url: https://pricing.twilio.com/v2/Trunking/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/v2/Trunking/Countries?PageSize=50&Page=0 readEmpty: value: countries: [] meta: first_page_url: https://pricing.twilio.com/v2/Trunking/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/v2/Trunking/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: ListTrunkingCountry /v2/Trunking/Countries/{IsoCountry}: servers: - url: https://pricing.twilio.com description: Trunking pricing by country x-twilio: defaultOutputProperties: - country - price_unit pathType: instance get: description: Fetch a specific Country. summary: Fetch a specific Country. tags: - PricingV2Country parameters: - name: IsoCountry in: path description: The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based voice pricing information to fetch. schema: type: string format: iso-country-code required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v2.trunking_country-instance' examples: fetch: value: country: United States originating_call_prices: - base_price: null current_price: '0.0085' number_type: local - base_price: null current_price: '0.022' number_type: toll free iso_country: US terminating_prefix_prices: - base_price: null current_price: '0.090' destination_prefixes: - '1907' friendly_name: Outbound Trunking Minute - United States - Alaska origination_prefixes: - ALL - base_price: null current_price: '0.013' destination_prefixes: - '1808' friendly_name: Outbound Trunking Minute - United States - Hawaii origination_prefixes: - ALL - base_price: null current_price: '0.013' destination_prefixes: - '1800' - '1844' - '1855' - '1866' - '1877' - '1888' friendly_name: Outbound Trunking Minute - United States & Canada - Toll Free origination_prefixes: - ALL - base_price: null current_price: '0.013' destination_prefixes: - '1' friendly_name: Outbound Trunking Minute - United States & Canada origination_prefixes: - ALL price_unit: USD url: https://pricing.twilio.com/v2/Trunking/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: FetchTrunkingCountry /v2/Trunking/Numbers/{DestinationNumber}: servers: - url: https://pricing.twilio.com description: Trunking pricing for a specific phone number x-twilio: defaultOutputProperties: - country - inbound_call_price - price_unit pathType: instance get: description: Fetch pricing information for a specific destination and, optionally, origination phone number. summary: Fetch pricing information for a specific destination and, optionally, origination phone number. tags: - PricingV2Number parameters: - name: DestinationNumber in: path description: The destination phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) 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. schema: type: string format: phone-number required: true - name: OriginationNumber in: query description: The origination phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) 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. schema: type: string format: phone-number examples: fetchWithOrigination: value: '+15105556789' responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v2.trunking_number' examples: fetch: value: country: United States destination_number: '+18001234567' originating_call_price: base_price: null current_price: null number_type: null iso_country: US origination_number: null terminating_prefix_prices: - base_price: null current_price: '0.013' destination_prefixes: - '1800' friendly_name: Trunking Outbound Minute - United States Zone 1b origination_prefixes: - ALL price_unit: USD url: https://pricing.twilio.com/v2/Trunking/Numbers/+18001234567 fetchWithOrigination: value: country: United States destination_number: '+18001234567' originating_call_price: base_price: null current_price: '0.013' number_type: tollfree iso_country: US origination_number: '+15105556789' terminating_prefix_prices: - base_price: null current_price: '0.001' destination_prefixes: - '1800' friendly_name: Trunking Outbound Minute - United States - Toll Free origination_prefixes: - ALL price_unit: USD url: https://pricing.twilio.com/v2/Trunking/Numbers/+18001234567 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: FetchTrunkingNumber /v2/Trunking/Numbers: servers: - url: https://pricing.twilio.com description: Trunking pricing for a specific phone number x-twilio: defaultOutputProperties: - country - inbound_call_price - price_unit pathType: list /v2/Voice: servers: - url: https://pricing.twilio.com description: Voice pricing x-twilio: defaultOutputProperties: - name pathType: instance /v2/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: '' summary: '' tags: - PricingV2Country 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 format: int64 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.v2.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/v2/Voice/Countries/AD meta: first_page_url: https://pricing.twilio.com/v2/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/v2/Voice/Countries?PageSize=50&Page=0 readEmpty: value: countries: [] meta: first_page_url: https://pricing.twilio.com/v2/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/v2/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 /v2/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: Fetch a specific Country. summary: Fetch a specific Country. tags: - PricingV2Country parameters: - name: IsoCountry in: path description: The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the origin-based voice pricing information to fetch. schema: type: string format: iso-country-code required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v2.voice.voice_country-instance' examples: fetch: value: country: United States inbound_call_prices: - base_price: '0.0085' current_price: '0.0085' number_type: local - base_price: '0.022' current_price: '0.022' number_type: toll free iso_country: US outbound_prefix_prices: - base_price: '0.090' current_price: '0.090' destination_prefixes: - '1907' friendly_name: Programmable Outbound Minute - United States - Alaska origination_prefixes: - ALL - base_price: '0.013' current_price: '0.013' destination_prefixes: - '1808' friendly_name: Programmable Outbound Minute - United States - Hawaii origination_prefixes: - ALL - base_price: '0.013' current_price: '0.013' destination_prefixes: - '1800' - '1844' - '1855' - '1866' - '1877' - '1888' friendly_name: Programmable Outbound Minute - United States & Canada - Toll Free origination_prefixes: - ALL - base_price: '0.013' current_price: '0.013' destination_prefixes: - '1' friendly_name: Programmable Outbound Minute - United States & Canada origination_prefixes: - ALL price_unit: USD url: https://pricing.twilio.com/v2/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 /v2/Voice/Numbers/{DestinationNumber}: servers: - url: https://pricing.twilio.com description: Voice pricing for a specific phone number x-twilio: defaultOutputProperties: - country - inbound_call_price - price_unit parent: /Voice pathType: instance get: description: Fetch pricing information for a specific destination and, optionally, origination phone number. summary: Fetch pricing information for a specific destination and, optionally, origination phone number. tags: - PricingV2Number parameters: - name: DestinationNumber in: path description: The destination phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) 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. schema: type: string format: phone-number required: true - name: OriginationNumber in: query description: The origination phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) 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. schema: type: string format: phone-number examples: fetch: value: '+18001234567' responses: '200': content: application/json: schema: $ref: '#/components/schemas/pricing.v2.voice.voice_number' examples: fetch: value: 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 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 /v2/Voice/Numbers: servers: - url: https://pricing.twilio.com description: Voice pricing for a specific phone number x-twilio: defaultOutputProperties: - country - inbound_call_price - price_unit parent: /Voice pathType: list servers: - url: https://pricing.twilio.com tags: - name: PricingV2Country - name: PricingV2Number - name: PricingV2Version security: - accountSid_authToken: []