plivo 4.16.0 → 4.58.0

data/lib/plivo/resources/numbers.rb

@@ -9,10 +9,11 @@ module Plivo
         super
       end
 
-      def buy(app_id = nil, verification_info = nil)
+      def buy(app_id = nil, verification_info = nil, cnam_lookup = nil)
         params = {}
         params[:app_id] = app_id unless app_id.nil?
         params[:verification_info] = verification_info unless verification_info.nil?
+        params[:cnam_lookup] = cnam_lookup unless cnam_lookup.nil?
         perform_action(nil, 'POST', params, true)
       end
 
@@ -33,7 +34,12 @@ module Plivo
           sms_enabled: @sms_enabled,
           sms_rate: @sms_rate,
           voice_enabled: @voice_enabled,
-          voice_rate: @voice_rate
+          voice_rate: @voice_rate,
+          tendlc_campaign_id: @tendlc_campaign_id,
+          tendlc_registration_status: @tendlc_registration_status,
+          toll_free_sms_verification: @toll_free_sms_verification,
+          toll_free_sms_verification_id: @toll_free_sms_verification_id,
+          toll_free_sms_verification_order_status: @toll_free_sms_verification_order_status
         }.to_s
       end
     end
@@ -115,10 +121,10 @@ module Plivo
         end
       end
 
-      def buy(number, app_id = nil, verification_info = nil)
+      def buy(number, app_id = nil, verification_info = nil, cnam_lookup = nil)
         valid_param?(:number, number, [Integer, String, Symbol], true)
         PhoneNumber.new(@_client,
-                        resource_id: number).buy(app_id, verification_info)
+                        resource_id: number).buy(app_id, verification_info, cnam_lookup)
       end
     end
 
@@ -139,7 +145,7 @@ module Plivo
           params[:subaccount] = options[:subaccount]
         end
 
-        %i[alias app_id].each do |param|
+        %i[alias app_id cnam_lookup].each do |param|
           if options.key?(param) &&
              valid_param?(param, options[param], [String, Symbol], true)
             params[param] = options[param]
@@ -176,7 +182,14 @@ module Plivo
           sms_rate: @sms_rate,
           sub_account: @sub_account,
           voice_enabled: @voice_enabled,
-          voice_rate: @voice_rate
+          voice_rate: @voice_rate,
+          tendlc_campaign_id: @tendlc_campaign_id,
+          tendlc_registration_status: @tendlc_registration_status,
+          toll_free_sms_verification: @toll_free_sms_verification,
+          renewal_date: @renewal_date,
+          cnam_lookup: @cnam_lookup,
+          toll_free_sms_verification_id: @toll_free_sms_verification_id,
+          toll_free_sms_verification_order_status: @toll_free_sms_verification_order_status
         }.to_s
       end
     end
@@ -205,6 +218,25 @@ module Plivo
       #                                    - sms - Returns a list of numbers that provide only 'sms' services.
       # @option options [Int] :limit Used to display the number of results per page. The maximum number of results that can be fetched is 20.
       # @option options [Int] :offset Denotes the number of value items by which the results should be offset. Eg:- If the result contains a 1000 values and limit is set to 10 and offset is set to 705, then values 706 through 715 are displayed in the results. This parameter is also used for pagination of the results.
+      # @option options [String] :tendlc_campaign_id The 10DLC campaign that the number is currently linked with. You can filter US/CA local numbers linked to a specific campaign.
+      # @option options [String] :tendlc_registration_status Indicates the 10DLC registration status of a US/CA local number. The following values are valid:
+      #                                     - unregistered - Returns a list of numbers that are not linked to any campaign
+      #                                     - processing - Returns a list of numbers that are currently in the process of being linked to respective campaigns.
+      #                                     - completed - Returns a list of numbers that are successfully linked to respective campaigns.
+      # @option options [String] :toll_free_sms_verification Indicates the toll-free SMS verification status of SMS-enabled US/CA toll-free number. The following values are valid:
+      #                                     - unverified - Returns a list of SMS-enabled US/CA toll-free numbers that are not verified.
+      #                                     - pending_verification - Returns a list of SMS-enabled US/CA toll-free numbers that are pending verification
+      #                                     - verified - Returns a list of SMS-enabled US/CA toll-free numbers that are verified for enhanced outbound SMS limits.
+      # @option options [String] :renewal_date Returns phone numbers that will be renewed on the specified date. Format: YYYY-MM-DD
+      # @option options [String] :renewal_date__lt Returns phone numbers that will be renewed before the specified date. Format: YYYY-MM-DD
+      # @option options [String] :renewal_date__lte Returns phone numbers that will be renewed on or before the specified date. Format: YYYY-MM-DD
+      # @option options [String] :renewal_date__gt Returns phone numbers that will be renewed after the specified date. Format: YYYY-MM-DD
+      # @option options [String] :renewal_date__gte Returns phone numbers that will be renewed on or after the specified date. Format: YYYY-MM-DD
+      # @option options [String] :cnam_lookup The Cnam Lookup Configuration associated with that number. The following values are valid:
+      #                                     - enabled - Returns the list of numbers for which Cnam Lookup configuration is enabled
+      #                                     - disabled - Returns the list of numbers for which Cnam Lookup configuration is disabled
+      # @option options [String] :toll_free_sms_verification_id The id of tollfree verification that the number is currently linked with.
+      # @option options [String] :toll_free_sms_verification_order_status Indicates the tollfree verification status of a number.
       def list(options = nil)
         return perform_list if options.nil?
 
@@ -212,7 +244,7 @@ module Plivo
 
         params = {}
 
-        %i[number_startswith subaccount alias].each do |param|
+        %i[number_startswith subaccount alias tendlc_campaign_id tendlc_registration_status toll_free_sms_verification renewal_date renewal_date__lt renewal_date__lte renewal_date__gt renewal_date__gte cnam_lookup toll_free_sms_verification_order_status].each do |param|
           if options.key?(param) &&
              valid_param?(param, options[param], [String, Symbol], true)
             params[param] = options[param]
@@ -303,6 +335,7 @@ module Plivo
       # @option options [String] :alias The textual name given to the number.
       # @option options [String] :app_id The application id of the application that is to be linked.
       # @option options [String] :subaccount The auth_id of the subaccount to which this number should be added. This can only be performed by a main account holder.
+      # @option options [String] :cnam_lookup The Cnam Lookup configuration to enable/disable Cnam Lookup
       def update(number, options = nil)
         valid_param?(:number, number, [String, Symbol], true)
         Number.new(@_client,

data/lib/plivo/resources/profile.rb

@@ -0,0 +1,93 @@
+module Plivo
+    module Resources
+        include Plivo::Utils
+        class Profile < Base::Resource
+            def initialize(client, options = nil)
+              @_name = 'Profile'
+              @_identifier_string = 'profile_uuid'
+              super
+            end
+        
+            def to_s
+              {
+                api_id: @api_id,
+                profile: @profile
+              }.to_s
+            end
+        end
+        class ProfileInterface < Base::ResourceInterface
+            def initialize(client, resource_list_json = nil)
+                @_name = 'Profile'
+                @_resource_type = Profile
+                @_identifier_string = 'profile_uuid'
+                super
+            end
+        
+              ##
+              # Get an Profile
+              # @param [String] profile_uuid
+              # @return [Profile] Profile
+            def get(profile_uuid)
+                valid_param?(:profile_uuid, profile_uuid, [String, Symbol], true)
+                perform_get(profile_uuid)
+            end
+
+              # List all Profile
+            def list(options = nil)
+              return perform_list_without_object if options.nil?
+              params = {}
+              %i[offset limit].each do |param|
+                if options.key?(param) && valid_param?(param, options[param],
+                                                 [Integer, Integer], true)
+                  params[param] = options[param]
+                end
+              end
+              if options.key?(:limit) && (options[:limit] > 20 || options[:limit] <= 0)
+                  raise_invalid_request('The maximum number of results that can be '\
+                    "fetched is 20. limit can't be more than 20 or less than 1")
+              end
+              if options.key?(:offset) && options[:offset] < 0
+                raise_invalid_request("Offset can't be negative")
+              end
+              perform_list_without_object(params)
+            end
+
+             # Delete an Profile
+             # @param [String] profile_uuid
+            def delete(profile_uuid)
+                valid_param?(:profile_uuid, profile_uuid, [String, Symbol], true)
+                perform_action_with_identifier(profile_uuid, 'DELETE', nil)
+            end
+        
+              ##
+              # Create a new Profile
+            def create(options = nil)
+                valid_param?(:options, options, Hash, true)
+                if not options[:profile_alias]
+                    raise_invalid_request("profile_alias must be provided")
+                end
+                if not options[:customer_type]
+                    raise_invalid_request("customer_type must be provided")
+                end
+                if not options[:entity_type]
+                    raise_invalid_request("entity_type must be provided")
+                end
+                if not options[:company_name]
+                    raise_invalid_request("company_name must be provided")
+                end
+                if not options[:vertical]
+                    raise_invalid_request("vertical must be provided")
+                end
+                perform_create(options)
+            end
+
+            ##
+            # Update a Profile
+            # {'address': {}, 'authorized_contact': {}, 'entity_type':'', 'vertical': '', 'company_name': '', 'website':''} 
+            def update(profile_uuid, options = nil)
+              valid_param?(:options, options, Hash, true)
+              perform_action_with_identifier(profile_uuid, "POST", options)
+            end
+        end
+    end
+end

data/lib/plivo/resources/recordings.rb

@@ -19,6 +19,8 @@ module Plivo
           api_id: @api_id,
           call_uuid: @call_uuid,
           conference_name: @conference_name,
+          monthly_recording_storage_amount: @monthly_recording_storage_amount,
+          recording_storage_duration: @recording_storage_duration,
           recording_duration_ms: @recording_duration_ms,
           recording_end_ms: @recording_end_ms,
           recording_format: @recording_format,
@@ -26,7 +28,14 @@ module Plivo
           recording_start_ms: @recording_start_ms,
           recording_type: @recording_type,
           recording_url: @recording_url,
-          resource_uri: @resource_uri
+          resource_uri: @resource_uri,
+          rounded_recording_duration: @rounded_recording_duration,
+          recording_storage_rate: @recording_storage_rate,
+          from_number: @from_number,
+          to_number: @to_number,
+          mpc_name: @mpc_name,
+          conference_uuid: @conference_uuid,
+          mpc_uuid: @mpc_uuid
         }.to_s
       end
     end
@@ -43,12 +52,25 @@ module Plivo
       # @param [Hash] options
       # @option options [String] :subaccount auth_id of the subaccount. Lists only those recordings of the main accounts which are tied to the specified subaccount.
       # @option options [String] :call_uuid Used to filter recordings for a specific call.
+      # @option options [String] :from_number Used to filter recordings for a specific from_number.
+      # @option options [String] :to_number Used to filter recordings for a specific to_number.
+      # @option options [String] :conference_name Used to filter recordings for a specific conference_name.
+      # @option options [String] :mpc_name Used to filter recordings for a specific mpc_name.
+      # @option options [String] :conference_uuid Used to filter recordings for a specific conference_uuid.
+      # @option options [String] :mpc_uuid Used to filter recordings for a specific mpc_uuid.
       # @option options [String] :add_time Used to filter out recordings according to the time they were added.The add_time filter is a comparative filter that can be used in the following four forms:
       #                                    - add_time\__gt: gt stands for greater than. The format expected is YYYY-MM-DD HH:MM[:ss[.uuuuuu]]. Eg:- To get all recordings that started after 2012-03-21 11:47, use add_time\__gt=2012-03-21 11:47
       #                                    - add_time\__gte: gte stands for greater than or equal. The format expected is YYYY-MM-DD HH:MM[:ss[.uuuuuu]]. Eg:- To get all recordings that started after or exactly at 2012-03-21 11:47[:30], use add_time\__gte=2012-03-21 11:47[:30]
       #                                    - add_time\__lt: lt stands for lesser than. The format expected is YYYY-MM-DD HH:MM[:ss[.uuuuuu]]. Eg:- To get all recordings that started before 2012-03-21 11:47, use add_time\__lt=2012-03-21 11:47
       #                                    - add_time\__gte: lte stands for lesser than or equal. The format expected is YYYY-MM-DD HH:MM[:ss[.uuuuuu]]. Eg:- To get all recordings that started before or exactly at 2012-03-21 11:47[:30], use add_time\__lte=2012-03-21 11:47[:30]
       #                                    - Note: The above filters can be combined to get recordings that started in a particular time range.
+      # @option options [Int] :recording_storage_duration - Used to filter out recordings according to the number of days they have been stored in the DB.The recording_storage_duration filter can be used in the following five forms:
+      #                                    - recording_storage_duration: Takes an integer input and returns the recordings which are as old as that value.
+      #                                    - recording_storage_duration\__gt: gt stands for greater than. The format expected is an integer value. Eg:- To get all recordings that are older than 100 days, use recording_storage_duration\__gt=100
+      #                                    - recording_storage_duration\__gte: gte stands for greater than or equal. The format expected is an integer value. Eg:- To get all recordings that are older than or equal to 100 days old, use recording_storage_duration\__gte=100
+      #                                    - recording_storage_duration\__lt: lt stands for lesser than. The format expected is an integer value. Eg:- To get all recordings that are newer than 100 days, use recording_storage_duration\__lt=100
+      #                                    - recording_storage_duration\__lte: lte stands for lesser than or equal. The format expected is an integer value. Eg:- To get all recordings that are newer than or equal to 100 days old, use recording_storage_duration\__lte=100
+      #                                    - Note: The above filters can be combined to get recordings that started in a particular time range.
       # @option options [Int] :limit Used to display the number of results per page. The maximum number of results that can be fetched is 20.
       # @option options [Int] :offset Denotes the number of value items by which the results should be offset. Eg:- If the result contains a 1000 values and limit is set to 10 and offset is set to 705, then values 706 through 715 are displayed in the results. This parameter is also used for pagination of the results.
       def list(options = nil)
@@ -59,10 +81,15 @@ module Plivo
         params_expected = %i[
           call_uuid add_time__gt add_time__gte
           add_time__lt add_time__lte
+          from_number to_number conference_uuid
+          conference_name mpc_name mpc_uuid
+          recording_storage_duration
+          recording_storage_duration__gt recording_storage_duration__gte
+          recording_storage_duration__lt recording_storage_duration__lte
         ]
 
         params_expected.each do |param|
-          if options.key?(param) && valid_param?(param, options[param], [String, Symbol], true)
+          if options.key?(param) && valid_param?(param, options[param], [String, Symbol, Integer], true)
             params[param] = options[param]
           end
         end

data/lib/plivo/resources/token.rb

@@ -0,0 +1,66 @@
+module Plivo
+  module Resources
+    include Plivo
+    include Plivo::Utils
+    class Token < Base::Resource
+      def initialize(client, options = nil)
+        @_name = 'JWT/Token'
+        super
+        @_is_voice_request = true
+      end
+      def to_s
+        {
+          api_id: @api_id,
+          token: @token
+        }.to_s
+      end
+    end
+
+    class TokenInterface < Base::ResourceInterface
+      def initialize(client, resource_list_json = nil)
+        @_name = 'JWT/Token'
+        @_resource_type = Token
+        super
+        @_is_voice_request = true
+      end
+
+
+      def create(iss , options = nil)
+        valid_param?(:iss, iss, [String, Symbol, Hash], true)
+        params = {}
+        params[:iss] = iss
+
+        return perform_create(params, false) if options.nil?
+        # return perform_action('Record', 'POST', nil, true) if options.nil?
+        valid_param?(:options, options, [Hash], false)
+
+
+        if options.key?("sub") && valid_param?("sub", options["sub"], [String, Symbol], false )
+          params[:sub] = options["sub"]
+        end
+        if options.key("nbf") && valid_param?("nbf", options["nbf"], [Integer, Symbol], false )
+          params[:nbf] = options["nbf"]
+        end
+        if options.key("exp") && valid_param?("exp", options["exp"], [Integer, Symbol], false )
+          params[:exp] = options["exp"]
+        end
+        if options.key?("incoming_allow") || options.key?("outgoing_allow")
+          params[:per] = {}
+          params[:per][:voice] = {}
+          if options.key?("incoming_allow") && valid_param?("incoming_allow", options["incoming_allow"], [TrueClass, FalseClass, String,Symbol], false)
+            params[:per][:voice][:incoming_allow] = options["incoming_allow"]
+          end
+          if options.key?("outgoing_allow") && valid_param?("outgoing_allow", options["outgoing_allow"], [TrueClass, FalseClass, String, Symbol], false)
+            params[:per][:voice][:outgoing_allow] = options["outgoing_allow"]
+          end
+        end
+        if options.key?("app") && valid_param?("app", options["app"], [String, Symbol], false)
+          params[:app] = options["app"]
+        end
+
+          perform_create(params.merge(options), false)
+      end
+    end
+  end
+end
+

data/lib/plivo/resources/tollfree_verification.rb

@@ -0,0 +1,178 @@
+module Plivo
+  module Resources
+    include Plivo::Utils
+
+    class TollfreeVerification < Base::Resource
+      def initialize(client, options = nil)
+        @_name = 'TollfreeVerification'
+        @_identifier_string = 'tollfree_verification'
+        super
+      end
+
+      def update(options = nil)
+        return perform_update({}) if options.nil?
+
+        valid_param?(:options, options, Hash, true)
+
+        params = {}
+        params_expected = %i[ usecase usecase_summary profile_uuid optin_type optin_image_url volume message_sample callback_method callback_url extra_data additional_information ]
+        params_expected.each do |param|
+          if options.key?(param) &&
+             valid_param?(param, options[param], [String, Symbol], false)
+            params[param] = options[param]
+          end
+        end
+
+        perform_update(params)
+      end
+
+      def delete
+        perform_delete
+      end
+
+      def to_s
+        {
+          api_id: @api_id,
+          uuid: @uuid,
+          number: @number,
+          created_at: @created_at,
+          updated_at: @updated_at,
+          callback_method: @callback_url,
+          callback_url: @callback_url,
+          extra_data: @extra_data,
+          additional_information: @additional_information,
+          message_sample: @message_sample,
+          optin_image_url: @optin_image_url,
+          optin_type: @optin_type,
+          profile_uuid: @profile_uuid,
+          rejection_reason: @rejection_reason,
+          status: @status,
+          usecase: @usecase,
+          usecase_summary: @usecase_summary,
+          volume: @volume
+        }.delete_if { |key, value| value.nil? }.to_s
+      end
+    end
+
+    class TollfreeVerificationsInterface < Base::ResourceInterface
+      def initialize(client, resource_list_json = nil)
+        @_name = 'TollfreeVerification'
+        @_resource_type = TollfreeVerification
+        @_identifier_string = 'tollfree_verification'
+        super
+      end
+
+      ##
+      # Get an TollfreeVerification
+      # @param [String] uuid
+      # return [TollfreeVerification]
+      def get(uuid)
+        valid_param?(:uuid, uuid, [String, Symbol], true)
+        perform_get(uuid)
+      end
+
+      ##
+      # List all TollfreeVerification
+      # @param [Hash] options
+      # @option options [Int] :offset
+      # @option options [Int] :limit
+      # @return [Hash]
+      def list(options = nil)
+        return perform_list if options.nil?
+        valid_param?(:options, options, Hash, true)
+
+        params = {}
+        params_expected = %i[ profile_uuid number status created__lt created__gt usecase created__lte created__gte ]
+        params_expected.each do |param|
+          if options.key?(param) &&
+             valid_param?(param, options[param], [String, Symbol], true)
+            params[param] = options[param]
+          end
+        end
+
+        %i[offset limit].each do |param|
+          if options.key?(param) && valid_param?(param, options[param],
+                                                 [Integer], true)
+            params[param] = options[param]
+          end
+        end
+
+        raise_invalid_request("Offset can't be negative") if options.key?(:offset) && options[:offset] < 0
+
+        if options.key?(:limit) && (options[:limit] > 20 || options[:limit] <= 0)
+          raise_invalid_request('The maximum number of results that can be '\
+          "fetched is 20. limit can't be more than 20 or less than 1")
+        end
+
+        perform_list(params)
+      end
+
+      ##
+      # Create an TollfreeVerification
+      # @param [String] number
+      # @param [String] usecase
+      # @param [String] usecase_summary
+      # @param [String] profile_uuid
+      # @param [String] optin_type
+      # @param [String] optin_image_url
+      # @param [String] volume
+      # @param [String] message_sample
+      # @param [String] callback_url
+      # @param [String] callback_method
+      # @param [String] extra_data
+      # @param [String] additional_information
+      # return [TollfreeVerification] TollfreeVerification
+      def create(number, usecase, usecase_summary, profile_uuid, optin_type, optin_image_url, volume, message_sample, callback_url = nil, callback_method = nil, extra_data = nil, additional_information = nil)
+        valid_param?(:number, number, [String, Symbol], true)
+        valid_param?(:usecase, usecase, [String, Symbol], true)
+        valid_param?(:usecase_summary, usecase_summary, [String, Symbol], true)
+        valid_param?(:profile_uuid, profile_uuid, [String, Symbol], true)
+        valid_param?(:optin_type, optin_type, [String, Symbol], true)
+        valid_param?(:optin_image_url, optin_image_url, [String, Symbol], true)
+        valid_param?(:volume, volume, [String, Symbol], true)
+        valid_param?(:message_sample, message_sample, [String, Symbol], true)
+        valid_param?(:callback_url, callback_url, [String, Symbol], false)
+        valid_param?(:callback_method, callback_method, [String, Symbol], false)
+        valid_param?(:extra_data, extra_data, [String, Symbol], false)
+        valid_param?(:additional_information, additional_information, [String, Symbol], false)
+
+        params = {
+        number: number,
+        usecase: usecase,
+        usecase_summary: usecase_summary,
+        profile_uuid: profile_uuid,
+        optin_type: optin_type,
+        optin_image_url: optin_image_url,
+        volume: volume,
+        message_sample: message_sample,
+        callback_url: callback_url,
+        callback_method: callback_method,
+        extra_data: extra_data,
+        additional_information: additional_information
+        }.delete_if { |key, value| value.nil? }
+
+        return perform_create(params)
+      end
+
+      ##
+      # Update an TollfreeVerification
+      # @param [String] uuid
+      # @param [Hash] options
+      # return [TollfreeVerification]
+      def update(uuid, options = nil)
+        valid_param?(:uuid, uuid, [String, Symbol], true)
+        TollfreeVerification.new(@_client,
+                        resource_id: uuid).update(options)
+      end
+
+      ##
+      # Delete an TollfreeVerification.
+      # @param [String] uuid
+      def delete(uuid)
+        valid_param?(:uuid, uuid, [String, Symbol], true)
+        TollfreeVerification.new(@_client,
+                        resource_id: uuid).delete
+      end
+    end
+  end
+end

data/lib/plivo/resources/verify_caller_id.rb

@@ -0,0 +1,110 @@
+module Plivo
+  module Resources
+    include Plivo::Utils
+    class Verify < Base::Resource
+      def initialize(client, options = nil)
+        @_name = 'Verify'
+        @_identifier_string = 'api_id'
+        super
+      end
+      def to_s
+        {
+          api_id: @api_id,
+          alias: @alias,
+          country: @country,
+          created_at: @created_at,
+          modified_at: @modified_at,
+          phone_number: @phone_number,
+          subaccount: @subaccount,
+          verification_uuid: @verification_uuid
+        }.to_s
+      end
+    end
+
+      class VerifyCallerIdInterface < Base::ResourceInterface
+        def initialize(client, resource_list_json = nil)
+          @_name = 'VerifiedCallerId'
+          @_resource_type = Verify
+          @_identifier_string = 'api_id'
+          super
+        end
+
+        def initiate(phone_number = nil, channel = nil, alias_ = nil, subaccount = nil)
+          valid_param?(:phone_number, phone_number, [String], true)
+          valid_param?(:channel, channel, [String], false)
+          valid_param?(:alias, alias_, [String], false)
+          valid_param?(:subaccount, subaccount, [String], false)
+
+          params = {
+            phone_number: phone_number,
+            channel: channel,
+            alias: alias_,
+            subaccount: subaccount
+          }
+          perform_create(params)
+        end
+
+        def verify(verification_uuid = nil, otp = nil)
+          valid_param?(:verification_uuid, verification_uuid, [String], true)
+          valid_param?(:otp, otp, [String], true)
+          id = 'Verification/' + verification_uuid
+          params = {
+            otp: otp
+          }
+          perform_action_with_identifier(id, 'POST', params)
+        end
+
+        def update(phone_number = nil, subaccount = nil, alias_ = nil)
+          valid_param?(:phone_number, phone_number, [String], true)
+          valid_param?(:subaccount, subaccount, [String], false)
+          valid_param?(:alias, alias_, [String], false)
+          params = {
+            subaccount: subaccount,
+            alias: alias_
+          }
+          perform_action_with_identifier(phone_number, 'POST', params)
+        end
+
+        def get(phone_number = nil)
+          valid_param?(:phone_number, phone_number, [String], true)
+          perform_get(phone_number)
+        end
+
+        def list(options = nil)
+          return perform_list_without_object if options.nil?
+          valid_param?(:options, options, Hash, false)
+
+          params = {}
+          params_expected = %i[subaccount country alias]
+
+          params_expected.each do |param|
+            if options.key?(param) &&
+              valid_param?(param, options[param], [String, Symbol], false)
+              params[param] = options[param]
+            end
+          end
+
+          %i[offset limit].each do |param|
+            if options.key?(param) &&
+              valid_param?(param, options[param], [Integer, Integer], false)
+              params[param] = options[param]
+            end
+          end
+
+          if options.key?(:limit) &&
+            (options[:limit] > 20 || options[:limit] <= 0)
+            raise_invalid_request('The maximum number of results that can be '\
+                                    "fetched is 20. limit can't be more than 20 or less than 1")
+          end
+
+          raise_invalid_request("Offset can't be negative") if options.key?(:offset) && options[:offset] < 0
+
+          perform_list_without_object(params)
+        end
+
+        def delete(phone_number)
+          perform_delete(phone_number, nil)
+        end
+      end
+    end
+end