twilio-ruby 7.4.4 → 7.10.4

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

@@ -25,6 +25,7 @@ module Twilio
                     # @return [PhoneNumberList] PhoneNumberList
                     def initialize(version)
                         super(version)
+                        
                         # Path Solution
                         @solution = {  }
                         
@@ -48,6 +49,7 @@ module Twilio
                     # @return [PhoneNumberContext] PhoneNumberContext
                     def initialize(version, phone_number)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = { phone_number: phone_number,  }
@@ -122,6 +124,79 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Fetch the PhoneNumberInstanceMetadata
+                    # @param [String] fields A comma-separated list of fields to return. Possible values are validation, caller_name, sim_swap, call_forwarding, line_status, line_type_intelligence, identity_match, reassigned_number, sms_pumping_risk, phone_number_quality_score, pre_fill.
+                    # @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.
+                    # @param [String] first_name User’s first name. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] last_name User’s last name. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] address_line1 User’s first address line. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] address_line2 User’s second address line. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] city User’s city. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] state User’s country subdivision, such as state, province, or locality. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] postal_code User’s postal zip code. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] address_country_code User’s country, up to two characters. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] national_id User’s national ID, such as SSN or Passport ID. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] date_of_birth User’s date of birth, in YYYYMMDD format. This query parameter is only used (optionally) for identity_match package requests.
+                    # @param [String] last_verified_date The date you obtained consent to call or text the end-user of the phone number or a date on which you are reasonably certain that the end-user could still be reached at that number. This query parameter is only used (optionally) for reassigned_number package requests.
+                    # @param [String] verification_sid The unique identifier associated with a verification process through verify API. This query parameter is only used (optionally) for pre_fill package requests.
+                    # @param [String] partner_sub_id The optional partnerSubId parameter to provide context for your sub-accounts, tenantIDs, sender IDs or other segmentation, enhancing the accuracy of the risk analysis.
+                    # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
+                    def fetch_with_metadata(
+                      fields: :unset, 
+                      country_code: :unset, 
+                      first_name: :unset, 
+                      last_name: :unset, 
+                      address_line1: :unset, 
+                      address_line2: :unset, 
+                      city: :unset, 
+                      state: :unset, 
+                      postal_code: :unset, 
+                      address_country_code: :unset, 
+                      national_id: :unset, 
+                      date_of_birth: :unset, 
+                      last_verified_date: :unset, 
+                      verification_sid: :unset, 
+                      partner_sub_id: :unset
+                    )
+
+                        params = Twilio::Values.of({
+                            'Fields' => fields,
+                            'CountryCode' => country_code,
+                            'FirstName' => first_name,
+                            'LastName' => last_name,
+                            'AddressLine1' => address_line1,
+                            'AddressLine2' => address_line2,
+                            'City' => city,
+                            'State' => state,
+                            'PostalCode' => postal_code,
+                            'AddressCountryCode' => address_country_code,
+                            'NationalId' => national_id,
+                            'DateOfBirth' => date_of_birth,
+                            'LastVerifiedDate' => last_verified_date,
+                            'VerificationSid' => verification_sid,
+                            'PartnerSubId' => partner_sub_id,
+                        })
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.fetch_with_metadata('GET', @uri, params: params, headers: headers)
+                        phone_number_instance = PhoneNumberInstance.new(
+                            @version,
+                            response.body,
+                            phone_number: @solution[:phone_number],
+                        )
+                        PhoneNumberInstanceMetadata.new(
+                            @version,
+                            phone_number_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -138,6 +213,53 @@ module Twilio
                     end
                 end
 
+                class PhoneNumberInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new PhoneNumberInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}PhoneNumberInstance] phone_number_instance The instance associated with the metadata.
+                    # @param [Hash] headers Header object with response headers.
+                    # @param [Integer] status_code The HTTP status code of the response.
+                    # @return [PhoneNumberInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, phone_number_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @phone_number_instance = phone_number_instance
+                    end
+
+                    def phone_number
+                        @phone_number_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.PhoneNumberInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class PhoneNumberListResponse < InstanceListResource
+                    # @param [Array<PhoneNumberInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @phone_number_instance = payload.body[key].map do |data|
+                        PhoneNumberInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def phone_number_instance
+                          @instance
+                      end
+                  end
+
                 class PhoneNumberPage < Page
                     ##
                     # Initialize the PhoneNumberPage
@@ -147,6 +269,7 @@ module Twilio
                     # @return [PhoneNumberPage] PhoneNumberPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -166,6 +289,66 @@ module Twilio
                         '<Twilio.Lookups.V2.PhoneNumberPage>'
                     end
                 end
+
+                class PhoneNumberPageMetadata < PageMetadata
+                    attr_reader :phone_number_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @phone_number_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @phone_number_page << PhoneNumberListResponse.new(version, @payload, key, limit - records)
+                            @payload = self.next_page
+                            break unless @payload
+                            records += @payload.body[key].size
+                        end
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    def each
+                        @phone_number_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Lookups::V2PageMetadata>';
+                    end
+                end
+                class PhoneNumberListResponse < InstanceListResource
+
+                    # @param [Array<PhoneNumberInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key, limit = :unset)
+                      data_list = payload.body[key]
+                      if limit != :unset
+                        data_list = data_list[0, limit]
+                      end
+                      @phone_number = data_list.map do |data|
+                        PhoneNumberInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def phone_number
+                        @phone_number
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class PhoneNumberInstance < InstanceResource
                     ##
                     # Initialize the PhoneNumberInstance
@@ -179,6 +362,7 @@ module Twilio
                     def initialize(version, payload , phone_number: nil)
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'calling_country_code' => payload['calling_country_code'],
@@ -190,8 +374,8 @@ module Twilio
                             'caller_name' => payload['caller_name'],
                             'sim_swap' => payload['sim_swap'],
                             'call_forwarding' => payload['call_forwarding'],
-                            'line_status' => payload['line_status'],
                             'line_type_intelligence' => payload['line_type_intelligence'],
+                            'line_status' => payload['line_status'],
                             'identity_match' => payload['identity_match'],
                             'reassigned_number' => payload['reassigned_number'],
                             'sms_pumping_risk' => payload['sms_pumping_risk'],
@@ -253,49 +437,49 @@ module Twilio
                     end
                     
                     ##
-                    # @return [Hash] An object that contains caller name information based on [CNAM](https://support.twilio.com/hc/en-us/articles/360051670533-Getting-Started-with-CNAM-Caller-ID).
+                    # @return [CallerNameInfo] 
                     def caller_name
                         @properties['caller_name']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains information on the last date the subscriber identity module (SIM) was changed for a mobile phone number.
+                    # @return [SimSwapInfo] 
                     def sim_swap
                         @properties['sim_swap']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains information on the unconditional call forwarding status of mobile phone number.
+                    # @return [CallForwardingInfo] 
                     def call_forwarding
                         @properties['call_forwarding']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains line status information for a mobile phone number.
-                    def line_status
-                        @properties['line_status']
+                    # @return [LineTypeIntelligenceInfo] 
+                    def line_type_intelligence
+                        @properties['line_type_intelligence']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains line type information including the carrier name, mobile country code, and mobile network code.
-                    def line_type_intelligence
-                        @properties['line_type_intelligence']
+                    # @return [LineStatusInfo] 
+                    def line_status
+                        @properties['line_status']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains identity match information. The result of comparing user-provided information including name, address, date of birth, national ID, against authoritative phone-based data sources
+                    # @return [IdentityMatchInfo] 
                     def identity_match
                         @properties['identity_match']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains reassigned number information. Reassigned Numbers will return a phone number's reassignment status given a phone number and date
+                    # @return [ReassignedNumberInfo] 
                     def reassigned_number
                         @properties['reassigned_number']
                     end
                     
                     ##
-                    # @return [Hash] An object that contains information on if a phone number has been currently or previously blocked by Verify Fraud Guard for receiving malicious SMS pumping traffic as well as other signals associated with risky carriers and low conversion rates.
+                    # @return [SmsPumpingRiskInfo] 
                     def sms_pumping_risk
                         @properties['sms_pumping_risk']
                     end

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

@@ -0,0 +1,351 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Lookups
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+
+module Twilio
+    module REST
+        class Lookups < LookupsBase
+            class V2 < Version
+                class QueryList < ListResource
+                
+                    class IdentityMatchParameters
+                            # @param [first_name]: [String] 
+                            # @param [last_name]: [String] 
+                            # @param [address_line1]: [String] 
+                            # @param [address_line2]: [String] 
+                            # @param [city]: [String] 
+                            # @param [state]: [String] 
+                            # @param [postal_code]: [String] 
+                            # @param [address_country_code]: [String] 
+                            # @param [national_id]: [String] 
+                            # @param [date_of_birth]: [String] 
+                        attr_accessor :first_name, :last_name, :address_line1, :address_line2, :city, :state, :postal_code, :address_country_code, :national_id, :date_of_birth
+                        def initialize(payload)
+                                @first_name = payload["first_name"]
+                                @last_name = payload["last_name"]
+                                @address_line1 = payload["address_line1"]
+                                @address_line2 = payload["address_line2"]
+                                @city = payload["city"]
+                                @state = payload["state"]
+                                @postal_code = payload["postal_code"]
+                                @address_country_code = payload["address_country_code"]
+                                @national_id = payload["national_id"]
+                                @date_of_birth = payload["date_of_birth"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "first_name": @first_name,
+                                "last_name": @last_name,
+                                "address_line1": @address_line1,
+                                "address_line2": @address_line2,
+                                "city": @city,
+                                "state": @state,
+                                "postal_code": @postal_code,
+                                "address_country_code": @address_country_code,
+                                "national_id": @national_id,
+                                "date_of_birth": @date_of_birth,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class LastSimSwapInfo
+                            # @param [last_sim_swap_date]: [Time] 
+                            # @param [swapped_period]: [String] 
+                            # @param [swapped_in_period]: [Boolean] 
+                        attr_accessor :last_sim_swap_date, :swapped_period, :swapped_in_period
+                        def initialize(payload)
+                                @last_sim_swap_date = payload["last_sim_swap_date"]
+                                @swapped_period = payload["swapped_period"]
+                                @swapped_in_period = payload["swapped_in_period"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "last_sim_swap_date": @last_sim_swap_date,
+                                "swapped_period": @swapped_period,
+                                "swapped_in_period": @swapped_in_period,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class LookupBatchRequest
+                            # @param [correlation_id]: [String] Unique identifier used to match request with response
+                            # @param [phone_number]: [String] 
+                            # @param [fields]: [Array<String>] 
+                            # @param [country_code]: [String] 
+                            # @param [identity_match]: [QueryList.IdentityMatchParameters] 
+                            # @param [reassigned_number]: [QueryList.ReassignedNumberParameters] 
+                            # @param [sms_pumping_risk]: [QueryList.RiskParameters] 
+                        attr_accessor :correlation_id, :phone_number, :fields, :country_code, :identity_match, :reassigned_number, :sms_pumping_risk
+                        def initialize(payload)
+                                @correlation_id = payload["correlation_id"]
+                                @phone_number = payload["phone_number"]
+                                @fields = payload["fields"]
+                                @country_code = payload["country_code"]
+                                @identity_match = payload["identity_match"]
+                                @reassigned_number = payload["reassigned_number"]
+                                @sms_pumping_risk = payload["sms_pumping_risk"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "correlation_id": @correlation_id,
+                                "phone_number": @phone_number,
+                                "fields": @fields,
+                                "country_code": @country_code,
+                                "identity_match": @identity_match,
+                                "reassigned_number": @reassigned_number,
+                                "sms_pumping_risk": @sms_pumping_risk,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class LookupRequest
+                            # @param [phone_numbers]: [Array<QueryList.LookupBatchRequest>] 
+                        attr_accessor :phone_numbers
+                        def initialize(payload)
+                                @phone_numbers = payload["phone_numbers"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "phone_numbers": @phone_numbers,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class ReassignedNumberParameters
+                            # @param [last_verified_date]: [String] 
+                        attr_accessor :last_verified_date
+                        def initialize(payload)
+                                @last_verified_date = payload["last_verified_date"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "last_verified_date": @last_verified_date,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class RiskParameters
+                            # @param [partner_sub_id]: [String] 
+                        attr_accessor :partner_sub_id
+                        def initialize(payload)
+                                @partner_sub_id = payload["partner_sub_id"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "partner_sub_id": @partner_sub_id,
+                        }.to_json(options)
+                        end
+                    end
+
+
+                    ##
+                    # Initialize the QueryList
+                    # @param [Version] version Version that contains the resource
+                    # @return [QueryList] QueryList
+                    def initialize(version)
+                        super(version)
+                        
+                        # Path Solution
+                        @solution = {  }
+                        @uri = "/batch/query"
+                        
+                    end
+                    ##
+                    # Create the QueryInstance
+                    # @param [LookupRequest] lookup_request 
+                    # @return [QueryInstance] Created QueryInstance
+                    def create(lookup_request: :unset
+                    )
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        headers['Content-Type'] = 'application/json'
+                        
+                        
+                        
+                        
+                        payload = @version.create('POST', @uri, headers: headers, data: lookup_request.to_json)
+                        QueryInstance.new(
+                            @version,
+                            payload,
+                        )
+                    end
+
+                    ##
+                    # Create the QueryInstanceMetadata
+                    # @param [LookupRequest] lookup_request 
+                    # @return [QueryInstance] Created QueryInstance
+                    def create_with_metadata(lookup_request: :unset
+                    )
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        headers['Content-Type'] = 'application/json'
+                        
+                        
+                        
+                        
+                        response = @version.create_with_metadata('POST', @uri, headers: headers, data: lookup_request.to_json)
+                        query_instance = QueryInstance.new(
+                            @version,
+                            response.body,
+                        )
+                        QueryInstanceMetadata.new(
+                            @version,
+                            query_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
+                
+
+
+                    # Provide a user friendly representation
+                    def to_s
+                        '#<Twilio.Lookups.V2.QueryList>'
+                    end
+                end
+
+                class QueryPage < Page
+                    ##
+                    # Initialize the QueryPage
+                    # @param [Version] version Version that contains the resource
+                    # @param [Response] response Response from the API
+                    # @param [Hash] solution Path solution for the resource
+                    # @return [QueryPage] QueryPage
+                    def initialize(version, response, solution)
+                        super(version, response)
+                        
+
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    ##
+                    # Build an instance of QueryInstance
+                    # @param [Hash] payload Payload response from the API
+                    # @return [QueryInstance] QueryInstance
+                    def get_instance(payload)
+                        QueryInstance.new(@version, payload)
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        '<Twilio.Lookups.V2.QueryPage>'
+                    end
+                end
+
+                class QueryPageMetadata < PageMetadata
+                    attr_reader :query_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @query_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @query_page << QueryListResponse.new(version, @payload, key, limit - records)
+                            @payload = self.next_page
+                            break unless @payload
+                            records += @payload.body[key].size
+                        end
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    def each
+                        @query_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Lookups::V2PageMetadata>';
+                    end
+                end
+                class QueryListResponse < InstanceListResource
+
+                    # @param [Array<QueryInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key, limit = :unset)
+                      data_list = payload.body[key]
+                      if limit != :unset
+                        data_list = data_list[0, limit]
+                      end
+                      @query = data_list.map do |data|
+                        QueryInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def query
+                        @query
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
+                class QueryInstance < InstanceResource
+                    ##
+                    # Initialize the QueryInstance
+                    # @param [Version] version Version that contains the resource
+                    # @param [Hash] payload payload that contains response from Twilio
+                    # @param [String] account_sid The SID of the
+                    #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Query
+                    #   resource.
+                    # @param [String] sid The SID of the Call resource to fetch.
+                    # @return [QueryInstance] QueryInstance
+                    def initialize(version, payload )
+                        super(version)
+                        
+                        
+                        # Marshaled Properties
+                        @properties = { 
+                            'phone_numbers' => payload['phone_numbers'],
+                        }
+                    end
+
+                    
+                    ##
+                    # @return [Array<LookupBatchResponse>] 
+                    def phone_numbers
+                        @properties['phone_numbers']
+                    end
+                    
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        "<Twilio.Lookups.V2.QueryInstance>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        "<Twilio.Lookups.V2.QueryInstance>"
+                    end
+                end
+
+            end
+        end
+    end
+end