twilio-ruby 5.67.0 → 5.67.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7701af5fb4015c43f3cb33005487afe3b041e183
-  data.tar.gz: ecdf6d5493148b024f336215e37d63b7f81e8bcd
+  metadata.gz: 8d37fa716f009ccbc9d5ee9811fc3189a03e7bcb
+  data.tar.gz: 6b6131fc2557ddc198144eb055c7fad105e53d8f
 SHA512:
-  metadata.gz: 9bcaa3d09a723a6093c8f108c6b3104c66751ca3ccc6c159f88fcd34311b77a6695ea2c7a01ea58136569daae4984cb9f607e34db53b094a8e5b339f5630e9ff
-  data.tar.gz: 7ca90f7c1ef070172105178679e1f05ed6f05570b4f8f12437788f8eaa1c333499444aee475f69033fe1411977d5573a1d03c32fae22eb67cacc3d2f6273749a
+  metadata.gz: 1bcc67be6b13ac0862a1940c6efaeb8d4ce9a16d6f087d52c07e936ab041ca2557a35b2373358e2788a96c6d80f8fb70f313d09fb8eaffb50e809c5c68367cd8
+  data.tar.gz: 30b767d5f2657da4388f0f1dfee239d4badf1c516c0e4736094507c017c9a58603f75750c558730d5ab74604141c175ef4474b1bd726555a8c423d5157499487

data/CHANGES.md

@@ -1,6 +1,35 @@
 twilio-ruby changelog
 =====================
 
+[2022-06-15] Version 5.67.3
+---------------------------
+**Lookups**
+- Adding support for Lookup V2 API
+
+**Studio**
+- Corrected PII labels to be 30 days and added context to be PII
+
+**Twiml**
+- Add `statusCallbackMethod` attribute, nested `<Config` and `<Parameter>` elements to `<VirtualAgent>` noun.
+- Add support for new Amazon Polly voices (Q2 2022) for `Say` verb
+- Add support for `<Conversation>` noun
+
+
+[2022-06-01] Version 5.67.2
+---------------------------
+**Library - Chore**
+- [PR #608](https://github.com/twilio/twilio-ruby/pull/608): use Docker 'rc' tag for release candidate images. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+
+[2022-05-18] Version 5.67.1
+---------------------------
+**Api**
+- Add property `media_url` to the recording resources
+
+**Verify**
+- Include `silent` as a channel type in the verifications API.
+
+
 [2022-05-04] Version 5.67.0
 ---------------------------
 **Library - Fix**

data/Makefile

@@ -17,13 +17,14 @@ authors:
 	git log --raw | grep "^Author: " | cut -d ' ' -f2- | cut -d '<' -f1 | sed 's/^/- /' | sort | uniq >> AUTHORS.md
 
 API_DEFINITIONS_SHA=$(shell git log --oneline | grep Regenerated | head -n1 | cut -d ' ' -f 5)
+CURRENT_TAG=$(shell [[ "${GITHUB_TAG}" == *"-rc"* ]] && echo "rc" || echo "latest")
 docker-build:
 	docker build -t twilio/twilio-ruby .
 	docker tag twilio/twilio-ruby twilio/twilio-ruby:${GITHUB_TAG}
 	docker tag twilio/twilio-ruby twilio/twilio-ruby:apidefs-${API_DEFINITIONS_SHA}
-	docker tag twilio/twilio-ruby twilio/twilio-ruby:latest
+	docker tag twilio/twilio-ruby twilio/twilio-ruby:${CURRENT_TAG}
 
 docker-push:
 	docker push twilio/twilio-ruby:${GITHUB_TAG}
 	docker push twilio/twilio-ruby:apidefs-${API_DEFINITIONS_SHA}
-	docker push twilio/twilio-ruby:latest
+	docker push twilio/twilio-ruby:${CURRENT_TAG}

data/README.md

@@ -34,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.67.0'
+gem 'twilio-ruby', '~> 5.67.3'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.67.0
+gem install twilio-ruby -v 5.67.3
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/rest/api/v2010/account/call/payment.rb

@@ -52,7 +52,7 @@ module Twilio
               #   overwritten with `currency` field. Leave blank or set to 0 to tokenize.
               # @param [String] currency The currency of the `charge_amount`, formatted as {ISO
               #   4127}[http://www.iso.org/iso/home/standards/currency_codes.htm] format. The
-              #   default value is `USD` and all values allowed from the <Pay> Connector are
+              #   default value is `USD` and all values allowed from the Pay Connector are
               #   accepted.
               # @param [String] description The description can be used to provide more details
               #   regarding the transaction. This information is submitted along with the payment
@@ -68,9 +68,9 @@ module Twilio
               #   that has to be included here depends on the <Pay> Connector. {Read
               #   more}[https://www.twilio.com/console/voice/pay-connectors].
               # @param [String] payment_connector This is the unique name corresponding to the
-              #   Payment Gateway Connector installed in the Twilio Add-ons. Learn more about
-              #   {<Pay> Connectors}[https://www.twilio.com/console/voice/pay-connectors]. The
-              #   default value is `Default`.
+              #   Pay Connector installed in the Twilio Add-ons. Learn more about {<Pay>
+              #   Connectors}[https://www.twilio.com/console/voice/pay-connectors]. The default
+              #   value is `Default`.
               # @param [payment.PaymentMethod] payment_method Type of payment being captured.
               #   One of `credit-card` or `ach-debit`. The default value is `credit-card`.
               # @param [Boolean] postal_code Indicates whether the credit card postal code (zip
@@ -202,7 +202,7 @@ module Twilio
               # @param [payment.Status] status Indicates whether the current payment session
               #   should be cancelled or completed. When `cancel` the payment session is
               #   cancelled. When `complete`, Twilio sends the payment information to the selected
-              #   <Pay> connector for processing.
+              #   Pay Connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 data = Twilio::Values.of({
@@ -342,7 +342,7 @@ module Twilio
               # @param [payment.Status] status Indicates whether the current payment session
               #   should be cancelled or completed. When `cancel` the payment session is
               #   cancelled. When `complete`, Twilio sends the payment information to the selected
-              #   <Pay> connector for processing.
+              #   Pay Connector for processing.
               # @return [PaymentInstance] Updated PaymentInstance
               def update(idempotency_key: nil, status_callback: nil, capture: :unset, status: :unset)
                 context.update(

data/lib/twilio-ruby/rest/api/v2010/account/recording.rb

@@ -335,6 +335,7 @@ module Twilio
                   'uri' => payload['uri'],
                   'encryption_details' => payload['encryption_details'],
                   'subresource_uris' => payload['subresource_uris'],
+                  'media_url' => payload['media_url'],
               }
 
               # Context
@@ -461,6 +462,12 @@ module Twilio
               @properties['subresource_uris']
             end
 
+            ##
+            # @return [String] The URL of the media file.
+            def media_url
+              @properties['media_url']
+            end
+
             ##
             # Fetch the RecordingInstance
             # @param [Boolean] include_soft_deleted A boolean parameter indicating whether to

data/lib/twilio-ruby/rest/client.rb

@@ -36,7 +36,6 @@ module Twilio
         @chat = nil
         @conversations = nil
         @events = nil
-        @fax = nil
         @flex_api = nil
         @frontline_api = nil
         @insights = nil
@@ -198,12 +197,6 @@ module Twilio
         @events ||= Events.new self
       end
 
-      ##
-      # Access the Fax Twilio Domain
-      def fax
-        @fax ||= Fax.new self
-      end
-
       ##
       # Access the FlexApi Twilio Domain
       def flex_api

data/lib/twilio-ruby/rest/flex_api/v1/interaction/interaction_channel/interaction_channel_invite.rb

@@ -16,8 +16,8 @@ module Twilio
               ##
               # Initialize the InteractionChannelInviteList
               # @param [Version] version Version that contains the resource
-              # @param [String] interaction_sid The interaction_sid
-              # @param [String] channel_sid The channel_sid
+              # @param [String] interaction_sid The Interaction SID for this Channel.
+              # @param [String] channel_sid The Channel SID for this Invite.
               # @return [InteractionChannelInviteList] InteractionChannelInviteList
               def initialize(version, interaction_sid: nil, channel_sid: nil)
                 super(version)
@@ -29,7 +29,7 @@ module Twilio
 
               ##
               # Create the InteractionChannelInviteInstance
-              # @param [Hash] routing The routing
+              # @param [Hash] routing The Interaction's routing logic.
               # @return [InteractionChannelInviteInstance] Created InteractionChannelInviteInstance
               def create(routing: nil)
                 data = Twilio::Values.of({'Routing' => Twilio.serialize_object(routing), })
@@ -170,8 +170,8 @@ module Twilio
               # Initialize the InteractionChannelInviteInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] interaction_sid The interaction_sid
-              # @param [String] channel_sid The channel_sid
+              # @param [String] interaction_sid The Interaction SID for this Channel.
+              # @param [String] channel_sid The Channel SID for this Invite.
               # @return [InteractionChannelInviteInstance] InteractionChannelInviteInstance
               def initialize(version, payload, interaction_sid: nil, channel_sid: nil)
                 super(version)
@@ -187,25 +187,25 @@ module Twilio
               end
 
               ##
-              # @return [String] The sid
+              # @return [String] The unique string that identifies the resource
               def sid
                 @properties['sid']
               end
 
               ##
-              # @return [String] The interaction_sid
+              # @return [String] The Interaction SID for this Channel
               def interaction_sid
                 @properties['interaction_sid']
               end
 
               ##
-              # @return [String] The channel_sid
+              # @return [String] The Channel SID for this Invite
               def channel_sid
                 @properties['channel_sid']
               end
 
               ##
-              # @return [Hash] The routing
+              # @return [Hash] A JSON object representing the routing rules for the Interaction Channel
               def routing
                 @properties['routing']
               end

data/lib/twilio-ruby/rest/flex_api/v1/interaction/interaction_channel.rb

@@ -15,7 +15,8 @@ module Twilio
             ##
             # Initialize the InteractionChannelList
             # @param [Version] version Version that contains the resource
-            # @param [String] interaction_sid The Interaction Sid for this channel.
+            # @param [String] interaction_sid The unique string created by Twilio to identify
+            #   an Interaction resource, prefixed with KD.
             # @return [InteractionChannelList] InteractionChannelList
             def initialize(version, interaction_sid: nil)
               super(version)
@@ -145,8 +146,10 @@ module Twilio
             ##
             # Initialize the InteractionChannelContext
             # @param [Version] version Version that contains the resource
-            # @param [String] interaction_sid The Interaction Sid for this channel.
-            # @param [String] sid The Channel Sid for this Participant.
+            # @param [String] interaction_sid The unique string created by Twilio to identify
+            #   an Interaction resource, prefixed with KD.
+            # @param [String] sid The unique string created by Twilio to identify an
+            #   Interaction Channel resource, prefixed with UO.
             # @return [InteractionChannelContext] InteractionChannelContext
             def initialize(version, interaction_sid, sid)
               super(version)
@@ -176,11 +179,12 @@ module Twilio
 
             ##
             # Update the InteractionChannelInstance
-            # @param [interaction_channel.Status] status The Interaction Channel's status. Can
-            #   be: `closed` or `wrapup`.
-            # @param [Hash] routing The Interaction Channel's routing parameters.  Optional,
-            #   may contain `status` to set the agent's Reservation state to either `closed` or
-            #   `wrapup`.  Default is `wrapup` if unspecified.
+            # @param [interaction_channel.Status] status Required. Indicates the Interaction
+            #   channel's status. When a channel is set to `closed`, all tasks are put in the
+            #   `wrapping` state by default unless the Routing status is set to `closed` in
+            #   which case the tasks will be `completed`. Value: `closed`.
+            # @param [Hash] routing Optional. The state of associated tasks. If not specified,
+            #   all tasks will be set to `wrapping`.
             # @return [InteractionChannelInstance] Updated InteractionChannelInstance
             def update(status: nil, routing: :unset)
               data = Twilio::Values.of({'Status' => status, 'Routing' => Twilio.serialize_object(routing), })
@@ -258,8 +262,10 @@ module Twilio
             # Initialize the InteractionChannelInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] interaction_sid The Interaction Sid for this channel.
-            # @param [String] sid The Channel Sid for this Participant.
+            # @param [String] interaction_sid The unique string created by Twilio to identify
+            #   an Interaction resource, prefixed with KD.
+            # @param [String] sid The unique string created by Twilio to identify an
+            #   Interaction Channel resource, prefixed with UO.
             # @return [InteractionChannelInstance] InteractionChannelInstance
             def initialize(version, payload, interaction_sid: nil, sid: nil)
               super(version)
@@ -300,7 +306,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The Interaction Sid for this channel.
+            # @return [String] The unique string that identifies the resource
             def interaction_sid
               @properties['interaction_sid']
             end
@@ -332,11 +338,12 @@ module Twilio
 
             ##
             # Update the InteractionChannelInstance
-            # @param [interaction_channel.Status] status The Interaction Channel's status. Can
-            #   be: `closed` or `wrapup`.
-            # @param [Hash] routing The Interaction Channel's routing parameters.  Optional,
-            #   may contain `status` to set the agent's Reservation state to either `closed` or
-            #   `wrapup`.  Default is `wrapup` if unspecified.
+            # @param [interaction_channel.Status] status Required. Indicates the Interaction
+            #   channel's status. When a channel is set to `closed`, all tasks are put in the
+            #   `wrapping` state by default unless the Routing status is set to `closed` in
+            #   which case the tasks will be `completed`. Value: `closed`.
+            # @param [Hash] routing Optional. The state of associated tasks. If not specified,
+            #   all tasks will be set to `wrapping`.
             # @return [InteractionChannelInstance] Updated InteractionChannelInstance
             def update(status: nil, routing: :unset)
               context.update(status: status, routing: routing, )

data/lib/twilio-ruby/rest/flex_api/v1/interaction.rb

@@ -182,7 +182,7 @@ module Twilio
           end
 
           ##
-          # @return [Hash] The Interaction's routing logic
+          # @return [Hash] A JSON Object representing the routing rules for the Interaction Channel
           def routing
             @properties['routing']
           end

data/lib/twilio-ruby/rest/flex_api.rb

@@ -54,7 +54,7 @@ module Twilio
 
       ##
       # @param [String] sid The unique string created by Twilio to identify an
-      #   Interaction resource.
+      #   Interaction resource, prefixed with KD.
       # @return [Twilio::REST::Flex_api::V1::InteractionInstance] if sid was passed.
       # @return [Twilio::REST::Flex_api::V1::InteractionList]
       def interaction(sid=:unset)

data/lib/twilio-ruby/rest/lookups/v2/phone_number.rb

@@ -0,0 +1,268 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Lookups < Domain
+      class V2 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class PhoneNumberList < ListResource
+          ##
+          # Initialize the PhoneNumberList
+          # @param [Version] version Version that contains the resource
+          # @return [PhoneNumberList] PhoneNumberList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Lookups.V2.PhoneNumberList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class PhoneNumberPage < Page
+          ##
+          # Initialize the PhoneNumberPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [PhoneNumberPage] PhoneNumberPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of PhoneNumberInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [PhoneNumberInstance] PhoneNumberInstance
+          def get_instance(payload)
+            PhoneNumberInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Lookups.V2.PhoneNumberPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class PhoneNumberContext < InstanceContext
+          ##
+          # Initialize the PhoneNumberContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] phone_number The phone number to lookup in E.164 or national
+          #   format. Default country code is +1 (North America).
+          # @return [PhoneNumberContext] PhoneNumberContext
+          def initialize(version, phone_number)
+            super(version)
+
+            # Path Solution
+            @solution = {phone_number: phone_number, }
+            @uri = "/PhoneNumbers/#{@solution[:phone_number]}"
+          end
+
+          ##
+          # Fetch the PhoneNumberInstance
+          # @param [String] fields A comma-separated list of fields to return. Possible
+          #   values are caller_name, sim_swap, call_forwarding, live_activity,
+          #   enhanced_line_type or line_type_intelligence.
+          # @param [String] country_code The {country
+          #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] used if the phone number
+          #   provided is in national format.
+          # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
+          def fetch(fields: :unset, country_code: :unset)
+            params = Twilio::Values.of({'Fields' => fields, 'CountryCode' => country_code, })
+
+            payload = @version.fetch('GET', @uri, params: params)
+
+            PhoneNumberInstance.new(@version, payload, phone_number: @solution[:phone_number], )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Lookups.V2.PhoneNumberContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Lookups.V2.PhoneNumberContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class PhoneNumberInstance < InstanceResource
+          ##
+          # Initialize the PhoneNumberInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] phone_number The phone number to lookup in E.164 or national
+          #   format. Default country code is +1 (North America).
+          # @return [PhoneNumberInstance] PhoneNumberInstance
+          def initialize(version, payload, phone_number: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'calling_country_code' => payload['calling_country_code'],
+                'country_code' => payload['country_code'],
+                'phone_number' => payload['phone_number'],
+                'national_format' => payload['national_format'],
+                'valid' => payload['valid'],
+                'validation_errors' => payload['validation_errors'],
+                'caller_name' => payload['caller_name'],
+                'sim_swap' => payload['sim_swap'],
+                'call_forwarding' => payload['call_forwarding'],
+                'live_activity' => payload['live_activity'],
+                'enhanced_line_type' => payload['enhanced_line_type'],
+                'line_type_intelligence' => payload['line_type_intelligence'],
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'phone_number' => phone_number || @properties['phone_number'], }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [PhoneNumberContext] PhoneNumberContext for this PhoneNumberInstance
+          def context
+            unless @instance_context
+              @instance_context = PhoneNumberContext.new(@version, @params['phone_number'], )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] International dialing prefix
+          def calling_country_code
+            @properties['calling_country_code']
+          end
+
+          ##
+          # @return [String] Phone number's ISO country code
+          def country_code
+            @properties['country_code']
+          end
+
+          ##
+          # @return [String] Phone number in E.164 format
+          def phone_number
+            @properties['phone_number']
+          end
+
+          ##
+          # @return [String] Phone number in national format
+          def national_format
+            @properties['national_format']
+          end
+
+          ##
+          # @return [Boolean] Boolean which indicates if the phone number is valid
+          def valid
+            @properties['valid']
+          end
+
+          ##
+          # @return [Array[phone_number.ValidationError]] Contains reasons why a phone number is invalid
+          def validation_errors
+            @properties['validation_errors']
+          end
+
+          ##
+          # @return [Hash] An object that contains caller name information
+          def caller_name
+            @properties['caller_name']
+          end
+
+          ##
+          # @return [Hash] An object that contains SIM swap information
+          def sim_swap
+            @properties['sim_swap']
+          end
+
+          ##
+          # @return [Hash] An object that contains call forwarding status information
+          def call_forwarding
+            @properties['call_forwarding']
+          end
+
+          ##
+          # @return [Hash] An object that contains live activity information
+          def live_activity
+            @properties['live_activity']
+          end
+
+          ##
+          # @return [Hash] An object that contains line type information
+          def enhanced_line_type
+            @properties['enhanced_line_type']
+          end
+
+          ##
+          # @return [Hash] An object that contains line type information
+          def line_type_intelligence
+            @properties['line_type_intelligence']
+          end
+
+          ##
+          # @return [String] The absolute URL of the resource
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Fetch the PhoneNumberInstance
+          # @param [String] fields A comma-separated list of fields to return. Possible
+          #   values are caller_name, sim_swap, call_forwarding, live_activity,
+          #   enhanced_line_type or line_type_intelligence.
+          # @param [String] country_code The {country
+          #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] used if the phone number
+          #   provided is in national format.
+          # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
+          def fetch(fields: :unset, country_code: :unset)
+            context.fetch(fields: fields, country_code: country_code, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Lookups.V2.PhoneNumberInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Lookups.V2.PhoneNumberInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/lookups/v2.rb

@@ -0,0 +1,45 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Lookups
+      class V2 < Version
+        ##
+        # Initialize the V2 version of Lookups
+        def initialize(domain)
+          super
+          @version = 'v2'
+          @phone_numbers = nil
+        end
+
+        ##
+        # @param [String] phone_number The phone number to lookup in E.164 or national
+        #   format. Default country code is +1 (North America).
+        # @return [Twilio::REST::Lookups::V2::PhoneNumberContext] if phone_number was passed.
+        # @return [Twilio::REST::Lookups::V2::PhoneNumberList]
+        def phone_numbers(phone_number=:unset)
+          if phone_number.nil?
+              raise ArgumentError, 'phone_number cannot be nil'
+          end
+          if phone_number == :unset
+              @phone_numbers ||= PhoneNumberList.new self
+          else
+              PhoneNumberContext.new(self, phone_number)
+          end
+        end
+
+        ##
+        # Provide a user friendly representation
+        def to_s
+          '<Twilio::REST::Lookups::V2>'
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/lookups.rb

@@ -20,6 +20,7 @@ module Twilio
 
         # Versions
         @v1 = nil
+        @v2 = nil
       end
 
       ##
@@ -28,6 +29,12 @@ module Twilio
         @v1 ||= V1.new self
       end
 
+      ##
+      # Version v2 of lookups
+      def v2
+        @v2 ||= V2.new self
+      end
+
       ##
       # @param [String] phone_number The phone number in
       #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists