telnyx 5.169.0 → 5.171.0

data/lib/telnyx/models/enterprises/reputation/external_verification_wrapped.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # @see Telnyx::Resources::Enterprises::Reputation::ExternalVerification#create
+        class ExternalVerificationWrapped < Telnyx::Internal::Type::BaseModel
+          # @!attribute data
+          #
+          #   @return [Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped::Data]
+          required :data, -> { Telnyx::Enterprises::Reputation::ExternalVerificationWrapped::Data }
+
+          # @!method initialize(data:)
+          #   @param data [Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped::Data]
+
+          # @see Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped#data
+          class Data < Telnyx::Internal::Type::BaseModel
+            # @!attribute document_ids
+            #   The ownership-proof documents on file.
+            #
+            #   @return [Array<String>, nil]
+            optional :document_ids, Telnyx::Internal::Type::ArrayOf[String]
+
+            # @!attribute enterprise_id
+            #
+            #   @return [String, nil]
+            optional :enterprise_id, String
+
+            # @!attribute phone_numbers
+            #   The phone numbers you listed with the documents.
+            #
+            #   @return [Array<String>, nil]
+            optional :phone_numbers, Telnyx::Internal::Type::ArrayOf[String]
+
+            # @!attribute rejection_reason
+            #   Why the proof was rejected. Set only when `status` is `rejected`.
+            #
+            #   @return [String, nil]
+            optional :rejection_reason, String, nil?: true
+
+            # @!attribute status
+            #   Review state of the ownership proof that allows adding phone numbers hosted with
+            #   another provider.
+            #
+            #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ExternalVerificationStatus, nil]
+            optional :status, enum: -> { Telnyx::Enterprises::Reputation::ExternalVerificationStatus }
+
+            response_only do
+              # @!attribute reviewed_at
+              #
+              #   @return [Time, nil]
+              optional :reviewed_at, Time, nil?: true
+
+              # @!attribute submitted_at
+              #
+              #   @return [Time, nil]
+              optional :submitted_at, Time, nil?: true
+            end
+
+            # @!method initialize(document_ids: nil, enterprise_id: nil, phone_numbers: nil, rejection_reason: nil, reviewed_at: nil, status: nil, submitted_at: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::Enterprises::Reputation::ExternalVerificationWrapped::Data} for
+            #   more details.
+            #
+            #   @param document_ids [Array<String>] The ownership-proof documents on file.
+            #
+            #   @param enterprise_id [String]
+            #
+            #   @param phone_numbers [Array<String>] The phone numbers you listed with the documents.
+            #
+            #   @param rejection_reason [String, nil] Why the proof was rejected. Set only when `status` is `rejected`.
+            #
+            #   @param reviewed_at [Time, nil]
+            #
+            #   @param status [Symbol, Telnyx::Models::Enterprises::Reputation::ExternalVerificationStatus] Review state of the ownership proof that allows adding phone numbers hosted with
+            #
+            #   @param submitted_at [Time, nil]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/loa_render_params.rb

@@ -18,8 +18,8 @@ module Telnyx
           #   Third-party reseller / partner managing the enterprise's phone numbers. Omit
           #   when the enterprise works directly with Telnyx.
           #
-          #   @return [Telnyx::Models::Enterprises::Reputation::AgentInput, nil]
-          optional :agent, -> { Telnyx::Enterprises::Reputation::AgentInput }
+          #   @return [Telnyx::Models::Enterprises::Reputation::LoaRenderParams::Agent, nil]
+          optional :agent, -> { Telnyx::Enterprises::Reputation::LoaRenderParams::Agent }
 
           # @!attribute signature
           #   Optional signature embedded in the rendered PDF. When omitted the PDF is
@@ -34,12 +34,91 @@ module Telnyx
           #
           #   @param enterprise_id [String]
           #
-          #   @param agent [Telnyx::Models::Enterprises::Reputation::AgentInput] Third-party reseller / partner managing the enterprise's phone numbers. Omit whe
+          #   @param agent [Telnyx::Models::Enterprises::Reputation::LoaRenderParams::Agent] Third-party reseller / partner managing the enterprise's phone numbers. Omit whe
           #
           #   @param signature [Telnyx::Models::Enterprises::Reputation::LoaRenderParams::Signature] Optional signature embedded in the rendered PDF. When omitted the PDF is returne
           #
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
+          class Agent < Telnyx::Internal::Type::BaseModel
+            # @!attribute administrative_area
+            #
+            #   @return [String]
+            required :administrative_area, String
+
+            # @!attribute city
+            #
+            #   @return [String]
+            required :city, String
+
+            # @!attribute contact_email
+            #
+            #   @return [String]
+            required :contact_email, String
+
+            # @!attribute contact_name
+            #
+            #   @return [String]
+            required :contact_name, String
+
+            # @!attribute contact_phone
+            #
+            #   @return [String]
+            required :contact_phone, String
+
+            # @!attribute contact_title
+            #
+            #   @return [String]
+            required :contact_title, String
+
+            # @!attribute country
+            #
+            #   @return [String]
+            required :country, String
+
+            # @!attribute legal_name
+            #
+            #   @return [String]
+            required :legal_name, String
+
+            # @!attribute postal_code
+            #
+            #   @return [String]
+            required :postal_code, String
+
+            # @!attribute street_address
+            #
+            #   @return [String]
+            required :street_address, String
+
+            # @!attribute dba
+            #
+            #   @return [String, nil]
+            optional :dba, String, nil?: true
+
+            # @!attribute extended_address
+            #
+            #   @return [String, nil]
+            optional :extended_address, String, nil?: true
+
+            # @!method initialize(administrative_area:, city:, contact_email:, contact_name:, contact_phone:, contact_title:, country:, legal_name:, postal_code:, street_address:, dba: nil, extended_address: nil)
+            #   Third-party reseller / partner managing the enterprise's phone numbers. Omit
+            #   when the enterprise works directly with Telnyx.
+            #
+            #   @param administrative_area [String]
+            #   @param city [String]
+            #   @param contact_email [String]
+            #   @param contact_name [String]
+            #   @param contact_phone [String]
+            #   @param contact_title [String]
+            #   @param country [String]
+            #   @param legal_name [String]
+            #   @param postal_code [String]
+            #   @param street_address [String]
+            #   @param dba [String, nil]
+            #   @param extended_address [String, nil]
+          end
+
           class Signature < Telnyx::Internal::Type::BaseModel
             # @!attribute image_base64
             #   Base64-encoded signature image.

data/lib/telnyx/models/enterprises/reputation/number_list_params.rb

@@ -14,6 +14,14 @@ module Telnyx
           #   @return [String]
           required :enterprise_id, String
 
+          # @!attribute filter_ownership_status
+          #   Only numbers with this ownership status. `removed` lists the numbers that were
+          #   removed, each with its `removal_reason` and `removed_at`; removed numbers are
+          #   not returned otherwise.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus, nil]
+          optional :filter_ownership_status, enum: -> { Telnyx::Enterprises::Reputation::ReputationOwnershipStatus }
+
           # @!attribute filter_phone_number_contains
           #   Partial match on phone number. Must contain at least 5 digits.
           #
@@ -26,6 +34,12 @@ module Telnyx
           #   @return [String, nil]
           optional :filter_phone_number_eq, String
 
+          # @!attribute filter_source
+          #   Only numbers with this source.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource, nil]
+          optional :filter_source, enum: -> { Telnyx::Enterprises::Reputation::ReputationNumberSource }
+
           # @!attribute page_number
           #   1-based page number. Out-of-range values return an empty page with correct meta.
           #
@@ -38,16 +52,20 @@ module Telnyx
           #   @return [Integer, nil]
           optional :page_size, Integer
 
-          # @!method initialize(enterprise_id:, filter_phone_number_contains: nil, filter_phone_number_eq: nil, page_number: nil, page_size: nil, request_options: {})
+          # @!method initialize(enterprise_id:, filter_ownership_status: nil, filter_phone_number_contains: nil, filter_phone_number_eq: nil, filter_source: nil, page_number: nil, page_size: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::Enterprises::Reputation::NumberListParams} for more details.
           #
           #   @param enterprise_id [String]
           #
+          #   @param filter_ownership_status [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus] Only numbers with this ownership status. `removed` lists the numbers that were r
+          #
           #   @param filter_phone_number_contains [String] Partial match on phone number. Must contain at least 5 digits.
           #
           #   @param filter_phone_number_eq [String] Exact phone-number match (E.164).
           #
+          #   @param filter_source [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource] Only numbers with this source.
+          #
           #   @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
           #
           #   @param page_size [Integer] Items per page. Default 10. Maximum 250; values above are clamped to 250.

data/lib/telnyx/models/enterprises/reputation/number_ownership_confirm_params.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # @see Telnyx::Resources::Enterprises::Reputation::Numbers#ownership_confirm
+        class NumberOwnershipConfirmParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute enterprise_id
+          #
+          #   @return [String]
+          required :enterprise_id, String
+
+          # @!attribute phone_number
+          #
+          #   @return [String]
+          required :phone_number, String
+
+          # @!attribute still_own
+          #   `true` confirms you still own the number. `false` reports that you no longer own
+          #   it and removes it from Number Reputation.
+          #
+          #   @return [Boolean]
+          required :still_own, Telnyx::Internal::Type::Boolean
+
+          # @!attribute evidence_document_id
+          #   Optional id of an uploaded document supporting the confirmation.
+          #
+          #   @return [String, nil]
+          optional :evidence_document_id, String
+
+          # @!method initialize(enterprise_id:, phone_number:, still_own:, evidence_document_id: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Enterprises::Reputation::NumberOwnershipConfirmParams} for more
+          #   details.
+          #
+          #   @param enterprise_id [String]
+          #
+          #   @param phone_number [String]
+          #
+          #   @param still_own [Boolean] `true` confirms you still own the number. `false` reports that you no longer own
+          #
+          #   @param evidence_document_id [String] Optional id of an uploaded document supporting the confirmation.
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/number_retrieve_ownership_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # @see Telnyx::Resources::Enterprises::Reputation::Numbers#retrieve_ownership
+        class NumberRetrieveOwnershipParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute enterprise_id
+          #
+          #   @return [String]
+          required :enterprise_id, String
+
+          # @!attribute phone_number
+          #
+          #   @return [String]
+          required :phone_number, String
+
+          # @!method initialize(enterprise_id:, phone_number:, request_options: {})
+          #   @param enterprise_id [String]
+          #   @param phone_number [String]
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/number_retrieve_ownership_response.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # @see Telnyx::Resources::Enterprises::Reputation::Numbers#retrieve_ownership
+        class NumberRetrieveOwnershipResponse < Telnyx::Internal::Type::BaseModel
+          # @!attribute data
+          #
+          #   @return [Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data]
+          required :data, -> { Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data }
+
+          # @!method initialize(data:)
+          #   @param data [Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data]
+
+          # @see Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse#data
+          class Data < Telnyx::Internal::Type::BaseModel
+            # @!attribute baseline_carrier
+            #   Service provider ID (SPID) of the carrier that held the number when its
+            #   ownership was last established.
+            #
+            #   @return [String, nil]
+            optional :baseline_carrier, String, nil?: true
+
+            # @!attribute baseline_recorded_at
+            #
+            #   @return [Time, nil]
+            optional :baseline_recorded_at, Time, nil?: true
+
+            # @!attribute confirm_by
+            #
+            #   @return [Time, nil]
+            optional :confirm_by, Time, nil?: true
+
+            # @!attribute flag_reason
+            #
+            #   @return [String, nil]
+            optional :flag_reason, String, nil?: true
+
+            # @!attribute history
+            #   Ownership events, most recent first.
+            #
+            #   @return [Array<Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data::History>, nil]
+            optional :history,
+                     -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data::History] }
+
+            # @!attribute last_checked_at
+            #   When ownership of the number was last checked.
+            #
+            #   @return [Time, nil]
+            optional :last_checked_at, Time, nil?: true
+
+            # @!attribute ownership_status
+            #   Result of ongoing ownership checks. `verified`: the number is with the carrier
+            #   on record. `pending_confirmation`: the number's carrier changed, or a periodic
+            #   ownership re-verification is due; confirm you still own it before `confirm_by`.
+            #   `flagged`: a periodic re-verification went unanswered; the number stays
+            #   monitored and is not removed, but confirm ownership
+            #   (`POST .../ownership_confirm`) to return it to `verified`. `removed`: the number
+            #   is no longer monitored; returned by `POST .../ownership_confirm` with
+            #   `still_own: false`, and when listing numbers with
+            #   `filter[ownership_status]=removed`.
+            #
+            #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus, nil]
+            optional :ownership_status, enum: -> { Telnyx::Enterprises::Reputation::ReputationOwnershipStatus }
+
+            # @!attribute phone_number
+            #
+            #   @return [String, nil]
+            optional :phone_number, String
+
+            # @!attribute source
+            #   Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+            #   `external`: a number you own that is hosted with another provider.
+            #
+            #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource, nil]
+            optional :source, enum: -> { Telnyx::Enterprises::Reputation::ReputationNumberSource }
+
+            # @!method initialize(baseline_carrier: nil, baseline_recorded_at: nil, confirm_by: nil, flag_reason: nil, history: nil, last_checked_at: nil, ownership_status: nil, phone_number: nil, source: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data}
+            #   for more details.
+            #
+            #   @param baseline_carrier [String, nil] Service provider ID (SPID) of the carrier that held the number when its ownershi
+            #
+            #   @param baseline_recorded_at [Time, nil]
+            #
+            #   @param confirm_by [Time, nil]
+            #
+            #   @param flag_reason [String, nil]
+            #
+            #   @param history [Array<Telnyx::Models::Enterprises::Reputation::NumberRetrieveOwnershipResponse::Data::History>] Ownership events, most recent first.
+            #
+            #   @param last_checked_at [Time, nil] When ownership of the number was last checked.
+            #
+            #   @param ownership_status [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus] Result of ongoing ownership checks. `verified`: the number is with the carrier o
+            #
+            #   @param phone_number [String]
+            #
+            #   @param source [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource] Where the phone number is hosted. `telnyx`: in your Telnyx inventory. `external`
+
+            class History < Telnyx::Internal::Type::BaseModel
+              # @!attribute event_type
+              #   `added`, `check`, `flag`, `confirm` or `removed`.
+              #
+              #   @return [String, nil]
+              optional :event_type, String
+
+              # @!attribute occurred_at
+              #
+              #   @return [Time, nil]
+              optional :occurred_at, Time
+
+              # @!attribute outcome
+              #   What the event found or did, for example `unchanged` or `carrier_changed`.
+              #
+              #   @return [String, nil]
+              optional :outcome, String, nil?: true
+
+              # @!method initialize(event_type: nil, occurred_at: nil, outcome: nil)
+              #   @param event_type [String] `added`, `check`, `flag`, `confirm` or `removed`.
+              #
+              #   @param occurred_at [Time]
+              #
+              #   @param outcome [String, nil] What the event found or did, for example `unchanged` or `carrier_changed`.
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/remediation_request.rb

@@ -57,8 +57,9 @@ module Telnyx
           optional :contact_email, String, nil?: true
 
           # @!attribute results
-          #   Per-category buckets. Populated once results are available. Null while the
-          #   request is still pending.
+          #   Per-category buckets of phone numbers, populated once results are available.
+          #   Empty lists are kept (not omitted) so consumers can iterate without
+          #   null-checking each key.
           #
           #   @return [Telnyx::Models::Enterprises::Reputation::RemediationPerNumberResults, nil]
           optional :results, -> { Telnyx::Enterprises::Reputation::RemediationPerNumberResults }, nil?: true
@@ -102,7 +103,7 @@ module Telnyx
           #
           #   @param contact_email [String, nil]
           #
-          #   @param results [Telnyx::Models::Enterprises::Reputation::RemediationPerNumberResults, nil] Per-category buckets. Populated once results are available. Null while the reque
+          #   @param results [Telnyx::Models::Enterprises::Reputation::RemediationPerNumberResults, nil] Per-category buckets of phone numbers, populated once results are available. Emp
           #
           #   @param tier1_completed_at [Time, nil]
           #

data/lib/telnyx/models/enterprises/reputation/reputation_number_source.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+        # `external`: a number you own that is hosted with another provider.
+        module ReputationNumberSource
+          extend Telnyx::Internal::Type::Enum
+
+          TELNYX = :telnyx
+          EXTERNAL = :external
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      ReputationNumberSource = Reputation::ReputationNumberSource
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/reputation_ownership_status.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      module Reputation
+        # Result of ongoing ownership checks. `verified`: the number is with the carrier
+        # on record. `pending_confirmation`: the number's carrier changed, or a periodic
+        # ownership re-verification is due; confirm you still own it before `confirm_by`.
+        # `flagged`: a periodic re-verification went unanswered; the number stays
+        # monitored and is not removed, but confirm ownership
+        # (`POST .../ownership_confirm`) to return it to `verified`. `removed`: the number
+        # is no longer monitored; returned by `POST .../ownership_confirm` with
+        # `still_own: false`, and when listing numbers with
+        # `filter[ownership_status]=removed`.
+        module ReputationOwnershipStatus
+          extend Telnyx::Internal::Type::Enum
+
+          VERIFIED = :verified
+          FLAGGED = :flagged
+          PENDING_CONFIRMATION = :pending_confirmation
+          REMOVED = :removed
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      ReputationOwnershipStatus = Reputation::ReputationOwnershipStatus
+    end
+  end
+end

data/lib/telnyx/models/enterprises/reputation/reputation_phone_number.rb

@@ -6,23 +6,77 @@ module Telnyx
       module Reputation
         # @see Telnyx::Resources::Enterprises::Reputation::Numbers#list
         class ReputationPhoneNumber < Telnyx::Internal::Type::BaseModel
+          # @!attribute confirm_by
+          #   Deadline to confirm you still own the number. Set only while `ownership_status`
+          #   is `pending_confirmation`.
+          #
+          #   @return [Time, nil]
+          optional :confirm_by, Time, nil?: true
+
           # @!attribute enterprise_id
           #
           #   @return [String, nil]
           optional :enterprise_id, String
 
+          # @!attribute flag_reason
+          #   Why the number's ownership was flagged. `carrier_changed` when an ownership
+          #   check found the number with a different carrier.
+          #
+          #   @return [String, nil]
+          optional :flag_reason, String, nil?: true
+
+          # @!attribute ownership_status
+          #   Result of ongoing ownership checks. `verified`: the number is with the carrier
+          #   on record. `pending_confirmation`: the number's carrier changed, or a periodic
+          #   ownership re-verification is due; confirm you still own it before `confirm_by`.
+          #   `flagged`: a periodic re-verification went unanswered; the number stays
+          #   monitored and is not removed, but confirm ownership
+          #   (`POST .../ownership_confirm`) to return it to `verified`. `removed`: the number
+          #   is no longer monitored; returned by `POST .../ownership_confirm` with
+          #   `still_own: false`, and when listing numbers with
+          #   `filter[ownership_status]=removed`.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus, nil]
+          optional :ownership_status, enum: -> { Telnyx::Enterprises::Reputation::ReputationOwnershipStatus }
+
           # @!attribute phone_number
           #   E.164 with leading `+`.
           #
           #   @return [String, nil]
           optional :phone_number, String
 
+          # @!attribute removal_reason
+          #   Why a number was removed. `ported_away`: you confirmed the number left your
+          #   control after a carrier change. `unconfirmed_ownership`: a carrier change was
+          #   not confirmed before the deadline. `reassigned`: the number was reported as
+          #   permanently disconnected. `customer_reported`: you reported that you no longer
+          #   own the number. `customer_removed`: you removed the number.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationPhoneNumber::RemovalReason, nil]
+          optional :removal_reason,
+                   enum: -> { Telnyx::Enterprises::Reputation::ReputationPhoneNumber::RemovalReason },
+                   nil?: true
+
+          # @!attribute removed_at
+          #   When the number was removed. Set only for removed numbers.
+          #
+          #   @return [Time, nil]
+          optional :removed_at, Time, nil?: true
+
           # @!attribute reputation_data
-          #   `null` until the first refresh has been collected for this number.
+          #   Reputation snapshot for a phone number. Each metric is a 0–100 score;
+          #   `spam_risk` is a coarse bucket. Field set may grow over time - read by key.
           #
           #   @return [Telnyx::Models::ReputationData, nil]
           optional :reputation_data, -> { Telnyx::ReputationData }, nil?: true
 
+          # @!attribute source
+          #   Where the phone number is hosted. `telnyx`: in your Telnyx inventory.
+          #   `external`: a number you own that is hosted with another provider.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource, nil]
+          optional :source, enum: -> { Telnyx::Enterprises::Reputation::ReputationNumberSource }
+
           response_only do
             # @!attribute id
             #
@@ -40,18 +94,54 @@ module Telnyx
             optional :updated_at, Time
           end
 
-          # @!method initialize(id: nil, created_at: nil, enterprise_id: nil, phone_number: nil, reputation_data: nil, updated_at: nil)
+          # @!method initialize(id: nil, confirm_by: nil, created_at: nil, enterprise_id: nil, flag_reason: nil, ownership_status: nil, phone_number: nil, removal_reason: nil, removed_at: nil, reputation_data: nil, source: nil, updated_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Enterprises::Reputation::ReputationPhoneNumber} for more
+          #   details.
+          #
           #   @param id [String]
           #
+          #   @param confirm_by [Time, nil] Deadline to confirm you still own the number. Set only while `ownership_status`
+          #
           #   @param created_at [Time]
           #
           #   @param enterprise_id [String]
           #
+          #   @param flag_reason [String, nil] Why the number's ownership was flagged. `carrier_changed` when an ownership chec
+          #
+          #   @param ownership_status [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationOwnershipStatus] Result of ongoing ownership checks. `verified`: the number is with the carrier o
+          #
           #   @param phone_number [String] E.164 with leading `+`.
           #
-          #   @param reputation_data [Telnyx::Models::ReputationData, nil] `null` until the first refresh has been collected for this number.
+          #   @param removal_reason [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationPhoneNumber::RemovalReason, nil] Why a number was removed. `ported_away`: you confirmed the number left your cont
+          #
+          #   @param removed_at [Time, nil] When the number was removed. Set only for removed numbers.
+          #
+          #   @param reputation_data [Telnyx::Models::ReputationData, nil] Reputation snapshot for a phone number. Each metric is a 0–100 score; `spam_risk
+          #
+          #   @param source [Symbol, Telnyx::Models::Enterprises::Reputation::ReputationNumberSource] Where the phone number is hosted. `telnyx`: in your Telnyx inventory. `external`
           #
           #   @param updated_at [Time]
+
+          # Why a number was removed. `ported_away`: you confirmed the number left your
+          # control after a carrier change. `unconfirmed_ownership`: a carrier change was
+          # not confirmed before the deadline. `reassigned`: the number was reported as
+          # permanently disconnected. `customer_reported`: you reported that you no longer
+          # own the number. `customer_removed`: you removed the number.
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::ReputationPhoneNumber#removal_reason
+          module RemovalReason
+            extend Telnyx::Internal::Type::Enum
+
+            PORTED_AWAY = :ported_away
+            UNCONFIRMED_OWNERSHIP = :unconfirmed_ownership
+            REASSIGNED = :reassigned
+            CUSTOMER_REPORTED = :customer_reported
+            CUSTOMER_REMOVED = :customer_removed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end