telnyx 5.126.0 → 5.128.0

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

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      # A Display Identity Record (DIR) is the verified calling identity (display name,
+      # logo, call reasons) shown to recipients on outbound calls.
+      class Dir
+        # @return [Telnyx::Resources::Enterprises::Dir::Comments]
+        attr_reader :comments
+
+        # @return [Telnyx::Resources::Enterprises::Dir::PhoneNumberBatches]
+        attr_reader :phone_number_batches
+
+        # @return [Telnyx::Resources::Enterprises::Dir::PhoneNumbers]
+        attr_reader :phone_numbers
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Enterprises::DirCreateParams} for more details.
+        #
+        # Create a new DIR under the given enterprise. The DIR starts in `draft` status;
+        # it must be submitted (`POST .../submit`) and approved by Telnyx before any phone
+        # number can be attached.
+        #
+        # **Field rules**
+        #
+        # - `display_name`: 1–35 characters, no emoji or whitespace-only strings; this is
+        #   the name shown to recipients.
+        # - `call_reasons`: 1–10 strings, each ≤64 characters; describe why your business
+        #   calls customers (e.g. 'Appointment reminders', 'Billing inquiries'). Validate
+        #   the wording against `POST /call_reasons/validate`.
+        # - `logo_url`: HTTPS URL (max 128 chars) to a 256×256 BMP (max 1 MB). The image
+        #   is downloaded and hashed at submission time.
+        # - `documents`: up to 20 entries; each `document_id` must be obtained by
+        #   uploading the file via the Telnyx Documents API first. Within one DIR a
+        #   `document_id` may only appear once.
+        # - `certify_brand_is_accurate`, `certify_no_shaft_content`,
+        #   `certify_ip_ownership` MUST all be `true`.
+        #
+        # **Failure modes**
+        #
+        # - `422` - validation error; `errors[].source.pointer` names the offending field.
+        # - `403` - Branded Calling not activated on this enterprise (see
+        #   `POST /enterprises/{id}/branded_calling`).
+        # - `404` - enterprise does not exist or does not belong to your account.
+        #
+        # @overload create(enterprise_id, authorizer_email:, authorizer_name:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, call_reasons: nil, documents: nil, logo_url: nil, reselling: nil, request_options: {})
+        #
+        # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+        #
+        # @param authorizer_email [String] Contact email of the authorizer. Telnyx may send verification or infringement-no
+        #
+        # @param authorizer_name [String] Name of the person at your enterprise who is authorizing this DIR registration.
+        #
+        # @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Must be `true`.
+        #
+        # @param certify_ip_ownership [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyIPOwnership] Must be `true`. Confirms ownership of any logos/trademarks shown.
+        #
+        # @param certify_no_shaft_content [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyNoShaftContent] Must be `true`. Confirms this DIR is not used for SHAFT content (Sex, Hate, Alco
+        #
+        # @param display_name [String] Name shown to call recipients. No emoji; not whitespace-only.
+        #
+        # @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
+        #
+        # @param documents [Array<Telnyx::Models::Enterprises::DirCreateParams::Document>] Supporting documents. Each `document_id` may appear at most once on a DIR.
+        #
+        # @param logo_url [String] Publicly accessible HTTPS URL (max 128 chars) to a 256x256 BMP logo (max 1 MB).
+        #
+        # @param reselling [Boolean] Set to true if your organization places calls on behalf of other enterprises (BP
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Enterprises::DirCreateResponse]
+        #
+        # @see Telnyx::Models::Enterprises::DirCreateParams
+        def create(enterprise_id, params)
+          parsed, options = Telnyx::Enterprises::DirCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["enterprises/%1$s/dir", enterprise_id],
+            body: parsed,
+            model: Telnyx::Models::Enterprises::DirCreateResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Enterprises::DirListParams} for more details.
+        #
+        # Return the DIRs (Display Identity Records) belonging to a single enterprise.
+        # Pagination is JSON:API style (`page[number]`, `page[size]`, max 250). Supports
+        # `filter[]` query params: `filter[status]`, `filter[display_name][contains]`,
+        # `filter[call_reason][contains]`, plus the renewal-window filters
+        # `filter[expiring_at][gte]` / `filter[expiring_at][lte]` and the convenience
+        # `filter[expiring_within_days]` (mutually exclusive with the explicit gte/lte
+        # form). Sortable by `created_at`, `updated_at`, `display_name`, `status`,
+        # `submitted_at`, `verified_at`, `expiring_at` (prefix `-` for descending; default
+        # `-created_at`).
+        #
+        # @overload list(enterprise_id, filter_call_reason_contains: nil, filter_display_name_contains: nil, filter_expiring_at_gte: nil, filter_expiring_at_lte: nil, filter_expiring_within_days: nil, filter_status: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
+        #
+        # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+        #
+        # @param filter_call_reason_contains [String] Case-insensitive partial match on call reason.
+        #
+        # @param filter_display_name_contains [String] Case-insensitive partial match on display name.
+        #
+        # @param filter_expiring_at_gte [Time] Return only DIRs whose `expiring_at` is at or after this ISO-8601 timestamp.
+        #
+        # @param filter_expiring_at_lte [Time] Return only DIRs whose `expiring_at` is at or before this ISO-8601 timestamp.
+        #
+        # @param filter_expiring_within_days [Integer] Convenience: returns DIRs whose `expiring_at` falls within the next N days (1–36
+        #
+        # @param filter_status [Symbol, Telnyx::Models::Enterprises::DirListParams::FilterStatus] Filter by DIR status.
+        #
+        # @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. Maximum 250; values above are clamped to 250.
+        #
+        # @param sort [Symbol, Telnyx::Models::Enterprises::DirListParams::Sort] Sort field. Allowed: `created_at`, `updated_at`, `display_name`, `status`, `subm
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Enterprises::DirListResponse>]
+        #
+        # @see Telnyx::Models::Enterprises::DirListParams
+        def list(enterprise_id, params = {})
+          parsed, options = Telnyx::Enterprises::DirListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["enterprises/%1$s/dir", enterprise_id],
+            query: query.transform_keys(
+              filter_call_reason_contains: "filter[call_reason][contains]",
+              filter_display_name_contains: "filter[display_name][contains]",
+              filter_expiring_at_gte: "filter[expiring_at][gte]",
+              filter_expiring_at_lte: "filter[expiring_at][lte]",
+              filter_expiring_within_days: "filter[expiring_within_days]",
+              filter_status: "filter[status]",
+              page_number: "page[number]",
+              page_size: "page[size]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Models::Enterprises::DirListResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @comments = Telnyx::Resources::Enterprises::Dir::Comments.new(client: client)
+          @phone_number_batches = Telnyx::Resources::Enterprises::Dir::PhoneNumberBatches.new(client: client)
+          @phone_numbers = Telnyx::Resources::Enterprises::Dir::PhoneNumbers.new(client: client)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      class Reputation
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
+        class Loa
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::LoaUpdateParams} for more details.
+          #
+          # Point the enterprise's reputation settings at a new signed LOA document. This
+          # resets LOA approval to `pending`; the new document must be approved before
+          # additional phone numbers can be added.
+          #
+          # @overload update(enterprise_id, loa_document_id:, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param loa_document_id [String] Id of the new signed LOA document (from the Telnyx Documents API). Changing it r
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::LoaUpdateResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::LoaUpdateParams
+          def update(enterprise_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::LoaUpdateParams.dump_request(params)
+            @client.request(
+              method: :patch,
+              path: ["enterprises/%1$s/reputation/loa", enterprise_id],
+              body: parsed,
+              model: Telnyx::Models::Enterprises::Reputation::LoaUpdateResponse,
+              options: options
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::LoaRenderParams} for more details.
+          #
+          # Render the LOA for this enterprise as a PDF. The enterprise identity, address,
+          # and authorized-representative contact are taken from the enterprise record; the
+          # optional `agent` block is supplied only when a third-party partner manages the
+          # numbers. The response is the PDF itself (unsigned unless a `signature` is
+          # provided). Sign it and upload it to the Telnyx Documents API
+          # (`POST /v2/documents`, see https://developers.telnyx.com/api/documents) to
+          # obtain the `loa_document_id` required by `POST .../reputation`.
+          #
+          # @overload render(enterprise_id, agent: nil, signature: nil, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @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}, nil]
+          #
+          # @return [StringIO]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::LoaRenderParams
+          def render(enterprise_id, params = {})
+            parsed, options = Telnyx::Enterprises::Reputation::LoaRenderParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["enterprises/%1$s/reputation/loa", enterprise_id],
+              headers: {"accept" => "application/pdf"},
+              body: parsed,
+              model: StringIO,
+              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/numbers.rb

@@ -4,37 +4,21 @@ module Telnyx
   module Resources
     class Enterprises
       class Reputation
-        # Associate phone numbers with an enterprise for reputation monitoring and
-        # retrieve reputation scores
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
         class Numbers
           # 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
+          # Retrieve one registered number with its latest reputation snapshot. The
+          # `phone_number` path parameter is in E.164 format and must be URL-encoded (e.g.
+          # `%2B19493253498`).
           #
           # @overload retrieve(phone_number, enterprise_id:, fresh: nil, request_options: {})
           #
-          # @param phone_number [String] Path param: Phone number in E.164 format
+          # @param phone_number [String] Path param: Phone number in E.164 format (`+1NPANXXXXXX` for US/CA). The leading
           #
-          # @param enterprise_id [String] Path param: Unique identifier of the enterprise (UUID)
+          # @param enterprise_id [String] Path param: The enterprise id. Lowercase UUID.
           #
           # @param fresh [Boolean] Query param: When true, fetches fresh reputation data (incurs API cost). When fa
           #
@@ -59,25 +43,28 @@ module Telnyx
             )
           end
 
-          # List all phone numbers associated with an enterprise for Number Reputation
-          # monitoring.
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberListParams} for more details.
+          #
+          # Paginated list of phone numbers registered for reputation monitoring under this
+          # enterprise. The response includes the latest reputation snapshot per number
+          # where one has been collected.
           #
-          # Returns phone numbers with their cached reputation data (if available). Supports
-          # pagination and filtering by phone number.
+          # @overload list(enterprise_id, filter_phone_number_contains: nil, filter_phone_number_eq: nil, page_number: nil, page_size: nil, request_options: {})
           #
-          # @overload list(enterprise_id, page_number: nil, page_size: nil, phone_number: nil, request_options: {})
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
           #
-          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          # @param filter_phone_number_contains [String] Partial match on phone number. Must contain at least 5 digits.
           #
-          # @param page_number [Integer] Page number (1-indexed)
+          # @param filter_phone_number_eq [String] Exact phone-number match (E.164).
           #
-          # @param page_size [Integer] Number of items per page
+          # @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
           #
-          # @param phone_number [String] Filter by specific phone number (E.164 format)
+          # @param page_size [Integer] Items per page. Default 10. Maximum 250; values above are clamped to 250.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::ReputationPhoneNumberWithReputationData>]
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Enterprises::Reputation::NumberListResponse>]
           #
           # @see Telnyx::Models::Enterprises::Reputation::NumberListParams
           def list(enterprise_id, params = {})
@@ -86,34 +73,33 @@ module Telnyx
             @client.request(
               method: :get,
               path: ["enterprises/%1$s/reputation/numbers", enterprise_id],
-              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              query: query.transform_keys(
+                filter_phone_number_contains: "filter[phone_number][contains]",
+                filter_phone_number_eq: "filter[phone_number][eq]",
+                page_number: "page[number]",
+                page_size: "page[size]"
+              ),
               page: Telnyx::Internal::DefaultFlatPagination,
-              model: Telnyx::ReputationPhoneNumberWithReputationData,
+              model: Telnyx::Models::Enterprises::Reputation::NumberListResponse,
               options: options
             )
           end
 
-          # Associate one or more phone numbers with an enterprise for Number Reputation
-          # monitoring.
-          #
-          # **Validations:**
+          # Add up to 100 phone numbers to reputation monitoring on this enterprise. Each
+          # must be in E.164 format (`+1NPANXXXXXX` for US/CA) and belong to your Telnyx
+          # phone-number inventory.
           #
-          # - 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
+          # **Prerequisite**: reputation must already be enabled on this enterprise (see
+          # `POST .../reputation`).
           #
-          # **Note:** This operation is atomic — if any number fails validation, the entire
-          # request fails.
-          #
-          # **Maximum:** 100 phone numbers per request.
+          # **Pricing:** This is a billable action. See https://telnyx.com/pricing/numbers
+          # for current pricing.
           #
           # @overload associate(enterprise_id, phone_numbers:, request_options: {})
           #
-          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
           #
-          # @param phone_numbers [Array<String>] List of phone numbers to associate for reputation monitoring (max 100)
+          # @param phone_numbers [Array<String>] 1–100 phone numbers in E.164 format with a leading `+`.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -131,16 +117,18 @@ module Telnyx
             )
           end
 
-          # Remove a phone number from Number Reputation monitoring for an enterprise.
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberDisassociateParams} for more
+          # details.
           #
-          # The number will no longer be tracked and reputation data will no longer be
-          # refreshed.
+          # Stop tracking the reputation of this phone number. The number itself remains in
+          # your inventory; only the reputation registration is removed.
           #
           # @overload disassociate(phone_number, enterprise_id:, request_options: {})
           #
-          # @param phone_number [String] Phone number in E.164 format
+          # @param phone_number [String] Phone number in E.164 format (`+1NPANXXXXXX` for US/CA). The leading `+` MUST be
           #
-          # @param enterprise_id [String] Unique identifier of the enterprise (UUID)
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -161,6 +149,39 @@ module Telnyx
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::NumberRefreshParams} for more details.
+          #
+          # Immediately refresh the stored reputation data for the listed numbers. This is
+          # in addition to the periodic refresh determined by `check_frequency`. Up to 100
+          # numbers per call. The response carries the kicked-off jobs; the actual refresh
+          # runs asynchronously.
+          #
+          # **Pricing:** Forcing a refresh performs live reputation lookups, which are
+          # billable. See https://telnyx.com/pricing/numbers for current pricing.
+          #
+          # @overload refresh(enterprise_id, phone_numbers:, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param phone_numbers [Array<String>] Phone numbers to refresh reputation data for. 1–100 numbers per request, each in
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::NumberRefreshResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::NumberRefreshParams
+          def refresh(enterprise_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::NumberRefreshParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["enterprises/%1$s/reputation/numbers/refresh", enterprise_id],
+              body: parsed,
+              model: Telnyx::Models::Enterprises::Reputation::NumberRefreshResponse,
+              options: options
+            )
+          end
+
           # @api private
           #
           # @param client [Telnyx::Client]

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

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Enterprises
+      class Reputation
+        # Phone-number reputation monitoring (spam-score lookup and tracking).
+        class Remediation
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::RemediationCreateParams} for more
+          # details.
+          #
+          # Submit a batch of phone numbers belonging to this enterprise for reputation
+          # remediation. The request is accepted asynchronously: this endpoint returns `202`
+          # with the persisted request id, then the request transitions through processing
+          # states until completion. Use the GET endpoints to poll status and per-number
+          # results.
+          #
+          # Each phone number must be in E.164 format and belong to this enterprise. A
+          # number that already has an in-flight remediation request is rejected.
+          #
+          # @overload create(enterprise_id, call_purpose:, phone_numbers:, contact_email: nil, webhook_url: nil, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param call_purpose [String] How the numbers are used (free text).
+          #
+          # @param phone_numbers [Array<String>] Phone numbers in E.164 format. Each must belong to this enterprise. Maximum 2,00
+          #
+          # @param contact_email [String] Optional contact email for this remediation request.
+          #
+          # @param webhook_url [String] Optional https:// URL for status notifications.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::RemediationCreateResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::RemediationCreateParams
+          def create(enterprise_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::RemediationCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["enterprises/%1$s/reputation/remediation", enterprise_id],
+              body: parsed,
+              model: Telnyx::Models::Enterprises::Reputation::RemediationCreateResponse,
+              options: options
+            )
+          end
+
+          # Retrieve the full detail of a remediation request, including current status,
+          # per-number results (once available), and submission metadata.
+          #
+          # @overload retrieve(remediation_id, enterprise_id:, request_options: {})
+          #
+          # @param remediation_id [String] The remediation request id. Lowercase UUID.
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Enterprises::Reputation::RemediationRetrieveResponse]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::RemediationRetrieveParams
+          def retrieve(remediation_id, params)
+            parsed, options = Telnyx::Enterprises::Reputation::RemediationRetrieveParams.dump_request(params)
+            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/remediation/%2$s", enterprise_id, remediation_id],
+              model: Telnyx::Models::Enterprises::Reputation::RemediationRetrieveResponse,
+              options: options
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Enterprises::Reputation::RemediationListParams} for more
+          # details.
+          #
+          # Paginated list of remediation requests for this enterprise. List items omit
+          # per-number results and webhook URLs to keep the response small; call GET by id
+          # for full detail. Supports JSON:API pagination and optional filters on status and
+          # created-at range.
+          #
+          # @overload list(enterprise_id, filter_created_at_gte: nil, filter_created_at_lte: nil, filter_status: nil, page_number: nil, page_size: nil, request_options: {})
+          #
+          # @param enterprise_id [String] The enterprise id. Lowercase UUID.
+          #
+          # @param filter_created_at_gte [Time] Only requests created on or after this timestamp (ISO 8601).
+          #
+          # @param filter_created_at_lte [Time] Only requests created on or before this timestamp (ISO 8601).
+          #
+          # @param filter_status [Symbol, Telnyx::Models::Enterprises::Reputation::RemediationListParams::FilterStatus] Filter by customer-facing status.
+          #
+          # @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. Maximum 250; values above are clamped to 250.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Enterprises::Reputation::RemediationListResponse>]
+          #
+          # @see Telnyx::Models::Enterprises::Reputation::RemediationListParams
+          def list(enterprise_id, params = {})
+            parsed, options = Telnyx::Enterprises::Reputation::RemediationListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["enterprises/%1$s/reputation/remediation", enterprise_id],
+              query: query.transform_keys(
+                filter_created_at_gte: "filter[created_at][gte]",
+                filter_created_at_lte: "filter[created_at][lte]",
+                filter_status: "filter[status]",
+                page_number: "page[number]",
+                page_size: "page[size]"
+              ),
+              page: Telnyx::Internal::DefaultFlatPagination,
+              model: Telnyx::Models::Enterprises::Reputation::RemediationListResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end