telnyx 5.65.0 → 5.66.1

data/lib/telnyx/resources/enterprises/reputation/numbers.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      class Reputation
+        # Associate phone numbers with an enterprise for reputation monitoring and
+        # retrieve reputation scores
+        class Numbers
+          # Associate one or more phone numbers with an enterprise for Number Reputation
+          # monitoring.
+          #
+          # **Validations:**
+          #
+          # - Phone numbers must be in E.164 format (e.g., `+16035551234`)
+          # - Phone numbers must be in-service and belong to your account (verified via
+          #   Warehouse)
+          # - Phone numbers must be US local numbers
+          # - Phone numbers cannot already be associated with any enterprise
+          #
+          # **Note:** This operation is atomic — if any number fails validation, the entire
+          # request fails.
+          #
+          # **Maximum:** 100 phone numbers per request.
+          #
+          # @overload create(enterprise_id, phone_numbers:, request_options: {})
+          #
+          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          #
+          # @param phone_numbers [Array<String>] List of phone numbers to associate for reputation monitoring (max 100)
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::NumberCreateResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberCreateParams
+          def create(enterprise_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["enterprises/%1$s/reputation/numbers", enterprise_id],
+              body: parsed,
+              model: Telnyx::Models::Enterprises::Reputation::NumberCreateResponse,
+              options: options
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberRetrieveParams} for more
+          # details.
+          #
+          # Get detailed reputation data for a specific phone number associated with an
+          # enterprise.
+          #
+          # **Query Parameters:**
+          #
+          # - `fresh` (default: `false`): When `true`, fetches fresh reputation data (incurs
+          #   API cost). When `false`, returns cached data. If no cached data exists, fresh
+          #   data is automatically fetched.
+          #
+          # **Returns:**
+          #
+          # - `spam_risk`: Overall spam risk level (`low`, `medium`, `high`)
+          # - `spam_category`: Spam category classification
+          # - `maturity_score`: Maturity metric (0–100)
+          # - `connection_score`: Connection quality metric (0–100)
+          # - `engagement_score`: Engagement metric (0–100)
+          # - `sentiment_score`: Sentiment metric (0–100)
+          # - `last_refreshed_at`: Timestamp of last data refresh
+          #
+          # @overload retrieve(phone_number, enterprise_id:, fresh: nil, request_options: {})
+          #
+          # @param phone_number [String] Path param: Phone number in E.164 format
+          #
+          # @param enterprise_id [String] Path param: Unique identifier of the enterprise (UUID)
+          #
+          # @param fresh [Boolean] Query param: When true, fetches fresh reputation data (incurs API cost). When fa
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::NumberRetrieveResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberRetrieveParams
+          def retrieve(phone_number, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberRetrieveParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            enterprise_id =
+              parsed.delete(:enterprise_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["enterprises/%1$s/reputation/numbers/%2$s", enterprise_id, phone_number],
+              query: query,
+              model: Telnyx::Models::Enterprises::Reputation::NumberRetrieveResponse,
+              options: options
+            )
+          end
+
+          # List all phone numbers associated with an enterprise for Number Reputation
+          # monitoring.
+          #
+          # Returns phone numbers with their cached reputation data (if available). Supports
+          # pagination and filtering by phone number.
+          #
+          # @overload list(enterprise_id, page_number: nil, page_size: nil, phone_number: nil, request_options: {})
+          #
+          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          #
+          # @param page_number [Integer] Page number (1-indexed)
+          #
+          # @param page_size [Integer] Number of items per page
+          #
+          # @param phone_number [String] Filter by specific phone number (E.164 format)
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Enterprises::Reputation::NumberListResponse>]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberListParams
+          def list(enterprise_id, params = {})
+            parsed, options = Telnyx::Enterprises::Reputation::NumberListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["enterprises/%1$s/reputation/numbers", enterprise_id],
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              page: Telnyx::Internal::DefaultFlatPagination,
+              model: Telnyx::Models::Enterprises::Reputation::NumberListResponse,
+              options: options
+            )
+          end
+
+          # Remove a phone number from Number Reputation monitoring for an enterprise.
+          #
+          # The number will no longer be tracked and reputation data will no longer be
+          # refreshed.
+          #
+          # @overload delete(phone_number, enterprise_id:, request_options: {})
+          #
+          # @param phone_number [String] Phone number in E.164 format
+          #
+          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberDeleteParams
+          def delete(phone_number, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberDeleteParams.dump_request(params)
+            enterprise_id =
+              parsed.delete(:enterprise_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :delete,
+              path: ["enterprises/%1$s/reputation/numbers/%2$s", enterprise_id, phone_number],
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/enterprises/reputation.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      # Manage Number Reputation enrollment and check frequency settings for an
+      # enterprise
+      class Reputation
+        # Associate phone numbers with an enterprise for reputation monitoring and
+        # retrieve reputation scores
+        # @return [Telnyx::Resources::Enterprises::Reputation::Numbers]
+        attr_reader :numbers
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Enterprises::ReputationCreateParams} for more details.
+        #
+        # Enable Number Reputation service for an enterprise.
+        #
+        # **Requirements:**
+        #
+        # - Signed LOA (Letter of Authorization) document ID
+        # - Reputation check frequency (defaults to `business_daily`)
+        # - Number Reputation Terms of Service must be accepted
+        #
+        # **Flow:**
+        #
+        # 1. Registers the enterprise for reputation monitoring
+        # 2. Creates reputation settings with `pending` status
+        # 3. Awaits admin approval before monitoring begins
+        #
+        # **Resubmission After Rejection:** If a previously rejected record exists, this
+        # endpoint will delete it and create a new `pending` record.
+        #
+        # **Available Frequencies:**
+        #
+        # - `business_daily` — Monday–Friday
+        # - `daily` — Every day
+        # - `weekly` — Once per week
+        # - `biweekly` — Once every two weeks
+        # - `monthly` — Once per month
+        # - `never` — Manual refresh only
+        #
+        # @overload create(enterprise_id, loa_document_id:, check_frequency: nil, request_options: {})
+        #
+        # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+        #
+        # @param loa_document_id [String] ID of the signed Letter of Authorization (LOA) document uploaded to the document
+        #
+        # @param check_frequency [Symbol, Telnyx::Models::Enterprises::ReputationCreateParams::CheckFrequency] Frequency for automatically refreshing reputation data
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Enterprises::ReputationCreateResponse]
+        #
+        # @see Telnyx::Models::Enterprises::ReputationCreateParams
+        def create(enterprise_id, params)
+          parsed, options = Telnyx::Enterprises::ReputationCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["enterprises/%1$s/reputation", enterprise_id],
+            body: parsed,
+            model: Telnyx::Models::Enterprises::ReputationCreateResponse,
+            options: options
+          )
+        end
+
+        # Retrieve the current Number Reputation settings for an enterprise.
+        #
+        # Returns the enrollment status (`pending`, `approved`, `rejected`, `deleted`),
+        # check frequency, and any rejection reasons.
+        #
+        # Returns `404` if reputation has not been enabled for this enterprise.
+        #
+        # @overload list(enterprise_id, request_options: {})
+        #
+        # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Enterprises::ReputationListResponse]
+        #
+        # @see Telnyx::Models::Enterprises::ReputationListParams
+        def list(enterprise_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["enterprises/%1$s/reputation", enterprise_id],
+            model: Telnyx::Models::Enterprises::ReputationListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Disable Number Reputation for an enterprise.
+        #
+        # This will:
+        #
+        # - Delete the reputation settings record
+        # - Log the deletion for audit purposes
+        # - Stop all future automated reputation checks
+        #
+        # **Note:** Can only be performed on `approved` reputation settings.
+        #
+        # @overload delete_all(enterprise_id, request_options: {})
+        #
+        # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::Enterprises::ReputationDeleteAllParams
+        def delete_all(enterprise_id, params = {})
+          @client.request(
+            method: :delete,
+            path: ["enterprises/%1$s/reputation", enterprise_id],
+            model: NilClass,
+            options: params[:request_options]
+          )
+        end
+
+        # Update how often reputation data is automatically refreshed.
+        #
+        # **Note:** The enterprise must have `approved` reputation settings. Updating
+        # frequency on `pending` or `rejected` settings will return an error.
+        #
+        # **Available Frequencies:**
+        #
+        # - `business_daily` — Monday–Friday
+        # - `daily` — Every day including weekends
+        # - `weekly` — Once per week
+        # - `biweekly` — Once every two weeks
+        # - `monthly` — Once per month
+        # - `never` — Manual refresh only (no automatic checks)
+        #
+        # @overload update_frequency(enterprise_id, check_frequency:, request_options: {})
+        #
+        # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+        #
+        # @param check_frequency [Symbol, Telnyx::Models::Enterprises::ReputationUpdateFrequencyParams::CheckFrequency] New frequency for refreshing reputation data
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Enterprises::ReputationUpdateFrequencyResponse]
+        #
+        # @see Telnyx::Models::Enterprises::ReputationUpdateFrequencyParams
+        def update_frequency(enterprise_id, params)
+          parsed, options = Telnyx::Enterprises::ReputationUpdateFrequencyParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["enterprises/%1$s/reputation/frequency", enterprise_id],
+            body: parsed,
+            model: Telnyx::Models::Enterprises::ReputationUpdateFrequencyResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @numbers = Telnyx::Resources::Enterprises::Reputation::Numbers.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/enterprises.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Enterprise management for Branded Calling and Number Reputation services
+    class Enterprises
+      # Manage Number Reputation enrollment and check frequency settings for an
+      # enterprise
+      # @return [Telnyx::Resources::Enterprises::Reputation]
+      attr_reader :reputation
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EnterpriseCreateParams} for more details.
+      #
+      # Create a new enterprise for Branded Calling / Number Reputation services.
+      #
+      # Registers the enterprise in the Branded Calling / Number Reputation services,
+      # enabling it to create Display Identity Records (DIRs) or enroll in Number
+      # Reputation monitoring.
+      #
+      # **Required Fields:** `legal_name`, `doing_business_as`, `organization_type`,
+      # `country_code`, `website`, `fein`, `industry`, `number_of_employees`,
+      # `organization_legal_type`, `organization_contact`, `billing_contact`,
+      # `organization_physical_address`, `billing_address`
+      #
+      # @overload create(billing_address:, billing_contact:, country_code:, doing_business_as:, fein:, industry:, legal_name:, number_of_employees:, organization_contact:, organization_legal_type:, organization_physical_address:, organization_type:, website:, corporate_registration_number: nil, customer_reference: nil, dun_bradstreet_number: nil, primary_business_domain_sic_code: nil, professional_license_number: nil, role_type: nil, request_options: {})
+      #
+      # @param billing_address [Telnyx::Models::EnterpriseCreateParams::BillingAddress]
+      #
+      # @param billing_contact [Telnyx::Models::EnterpriseCreateParams::BillingContact]
+      #
+      # @param country_code [String] Country code. Currently only 'US' is accepted.
+      #
+      # @param doing_business_as [String] Primary business name / DBA name
+      #
+      # @param fein [String] Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (mi
+      #
+      # @param industry [String] Industry classification. Case-insensitive. Accepted values: accounting, finance,
+      #
+      # @param legal_name [String] Legal name of the enterprise
+      #
+      # @param number_of_employees [Symbol, Telnyx::Models::EnterpriseCreateParams::NumberOfEmployees] Employee count range
+      #
+      # @param organization_contact [Telnyx::Models::EnterpriseCreateParams::OrganizationContact] Organization contact information. Note: the response returns this object with th
+      #
+      # @param organization_legal_type [Symbol, Telnyx::Models::EnterpriseCreateParams::OrganizationLegalType] Legal structure type
+      #
+      # @param organization_physical_address [Telnyx::Models::EnterpriseCreateParams::OrganizationPhysicalAddress]
+      #
+      # @param organization_type [Symbol, Telnyx::Models::EnterpriseCreateParams::OrganizationType] Type of organization
+      #
+      # @param website [String] Enterprise website URL. Accepts any string — no URL format validation enforced.
+      #
+      # @param corporate_registration_number [String] Corporate registration number (optional)
+      #
+      # @param customer_reference [String] Optional customer reference identifier for your own tracking
+      #
+      # @param dun_bradstreet_number [String] D-U-N-S Number (optional)
+      #
+      # @param primary_business_domain_sic_code [String] SIC Code (optional)
+      #
+      # @param professional_license_number [String] Professional license number (optional)
+      #
+      # @param role_type [Symbol, Telnyx::Models::EnterpriseCreateParams::RoleType] Role type in Branded Calling / Number Reputation services
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EnterpriseCreateResponse]
+      #
+      # @see Telnyx::Models::EnterpriseCreateParams
+      def create(params)
+        parsed, options = Telnyx::EnterpriseCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "enterprises",
+          body: parsed,
+          model: Telnyx::Models::EnterpriseCreateResponse,
+          options: options
+        )
+      end
+
+      # Retrieve details of a specific enterprise by ID.
+      #
+      # @overload retrieve(enterprise_id, request_options: {})
+      #
+      # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EnterpriseRetrieveResponse]
+      #
+      # @see Telnyx::Models::EnterpriseRetrieveParams
+      def retrieve(enterprise_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["enterprises/%1$s", enterprise_id],
+          model: Telnyx::Models::EnterpriseRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::EnterpriseUpdateParams} for more details.
+      #
+      # Update enterprise information. All fields are optional — only the provided
+      # fields will be updated.
+      #
+      # @overload update(enterprise_id, billing_address: nil, billing_contact: nil, corporate_registration_number: nil, customer_reference: nil, doing_business_as: nil, dun_bradstreet_number: nil, fein: nil, industry: nil, legal_name: nil, number_of_employees: nil, organization_contact: nil, organization_legal_type: nil, organization_physical_address: nil, primary_business_domain_sic_code: nil, professional_license_number: nil, website: nil, request_options: {})
+      #
+      # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+      #
+      # @param billing_address [Telnyx::Models::EnterpriseUpdateParams::BillingAddress]
+      #
+      # @param billing_contact [Telnyx::Models::EnterpriseUpdateParams::BillingContact]
+      #
+      # @param corporate_registration_number [String] Corporate registration number
+      #
+      # @param customer_reference [String] Customer reference identifier
+      #
+      # @param doing_business_as [String] DBA name
+      #
+      # @param dun_bradstreet_number [String] D-U-N-S Number
+      #
+      # @param fein [String] Federal Employer Identification Number. Format: XX-XXXXXXX or XXXXXXXXX
+      #
+      # @param industry [String] Industry classification
+      #
+      # @param legal_name [String] Legal name of the enterprise
+      #
+      # @param number_of_employees [Symbol, Telnyx::Models::EnterpriseUpdateParams::NumberOfEmployees] Employee count range
+      #
+      # @param organization_contact [Telnyx::Models::EnterpriseUpdateParams::OrganizationContact] Organization contact information. Note: the response returns this object with th
+      #
+      # @param organization_legal_type [Symbol, Telnyx::Models::EnterpriseUpdateParams::OrganizationLegalType] Legal structure type
+      #
+      # @param organization_physical_address [Telnyx::Models::EnterpriseUpdateParams::OrganizationPhysicalAddress]
+      #
+      # @param primary_business_domain_sic_code [String] SIC Code
+      #
+      # @param professional_license_number [String] Professional license number
+      #
+      # @param website [String] Company website URL
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EnterpriseUpdateResponse]
+      #
+      # @see Telnyx::Models::EnterpriseUpdateParams
+      def update(enterprise_id, params = {})
+        parsed, options = Telnyx::EnterpriseUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["enterprises/%1$s", enterprise_id],
+          body: parsed,
+          model: Telnyx::Models::EnterpriseUpdateResponse,
+          options: options
+        )
+      end
+
+      # Retrieve a paginated list of enterprises associated with your account.
+      #
+      # @overload list(legal_name: nil, page_number: nil, page_size: nil, request_options: {})
+      #
+      # @param legal_name [String] Filter by legal name (partial match)
+      #
+      # @param page_number [Integer] Page number (1-indexed)
+      #
+      # @param page_size [Integer] Number of items per page
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::EnterpriseListResponse>]
+      #
+      # @see Telnyx::Models::EnterpriseListParams
+      def list(params = {})
+        parsed, options = Telnyx::EnterpriseListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "enterprises",
+          query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
+          model: Telnyx::Models::EnterpriseListResponse,
+          options: options
+        )
+      end
+
+      # Delete an enterprise and all associated resources. This action is irreversible.
+      #
+      # @overload delete(enterprise_id, request_options: {})
+      #
+      # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Telnyx::Models::EnterpriseDeleteParams
+      def delete(enterprise_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["enterprises/%1$s", enterprise_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @reputation = Telnyx::Resources::Enterprises::Reputation.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/reputation/numbers.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Reputation
+      # Associate phone numbers with an enterprise for reputation monitoring and
+      # retrieve reputation scores
+      class Numbers
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Reputation::NumberRetrieveParams} for more details.
+        #
+        # Get reputation data for a specific phone number without requiring an
+        # `enterprise_id`.
+        #
+        # Same response as the enterprise-scoped endpoint. Uses cached data by default.
+        #
+        # @overload retrieve(phone_number, fresh: nil, request_options: {})
+        #
+        # @param phone_number [String] Phone number in E.164 format
+        #
+        # @param fresh [Boolean] When true, fetches fresh reputation data (incurs API cost). When false, returns
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Reputation::NumberRetrieveResponse]
+        #
+        # @see Telnyx::Models::Reputation::NumberRetrieveParams
+        def retrieve(phone_number, params = {})
+          parsed, options = Telnyx::Reputation::NumberRetrieveParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["reputation/numbers/%1$s", phone_number],
+            query: query,
+            model: Telnyx::Models::Reputation::NumberRetrieveResponse,
+            options: options
+          )
+        end
+
+        # List all phone numbers enrolled in Number Reputation monitoring for your
+        # account. This is a simplified endpoint that does not require an `enterprise_id`
+        # — it returns numbers across all your enterprises.
+        #
+        # Supports pagination and filtering by phone number.
+        #
+        # @overload list(page_number: nil, page_size: nil, phone_number: nil, request_options: {})
+        #
+        # @param page_number [Integer] Page number (1-indexed)
+        #
+        # @param page_size [Integer] Number of items per page
+        #
+        # @param phone_number [String] Filter by specific phone number (E.164 format)
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Reputation::NumberListResponse>]
+        #
+        # @see Telnyx::Models::Reputation::NumberListParams
+        def list(params = {})
+          parsed, options = Telnyx::Reputation::NumberListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "reputation/numbers",
+            query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Models::Reputation::NumberListResponse,
+            options: options
+          )
+        end
+
+        # Remove a phone number from Number Reputation monitoring without requiring an
+        # `enterprise_id`.
+        #
+        # @overload delete(phone_number, request_options: {})
+        #
+        # @param phone_number [String] Phone number in E.164 format
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::Reputation::NumberDeleteParams
+        def delete(phone_number, params = {})
+          @client.request(
+            method: :delete,
+            path: ["reputation/numbers/%1$s", phone_number],
+            model: NilClass,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/reputation.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Reputation
+      # Associate phone numbers with an enterprise for reputation monitoring and
+      # retrieve reputation scores
+      # @return [Telnyx::Resources::Reputation::Numbers]
+      attr_reader :numbers
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @numbers = Telnyx::Resources::Reputation::Numbers.new(client: client)
+      end
+    end
+  end
+end