telnyx 5.170.0 → 5.171.0

data/lib/telnyx/models/enterprise_public.rb

@@ -14,6 +14,24 @@ module Telnyx
       #   @return [Telnyx::Models::BillingContact, nil]
       optional :billing_contact, -> { Telnyx::BillingContact }
 
+      # @!attribute bpo_verification_rejection_reason
+      #   Reason Telnyx rejected the BPO (Business Process Outsourcer) verification, when
+      #   `bpo_verification_status` is `rejected`; `null` otherwise.
+      #
+      #   @return [String, nil]
+      optional :bpo_verification_rejection_reason, String, nil?: true
+
+      # @!attribute bpo_verification_status
+      #   Whether Telnyx has approved this BPO (Business Process Outsourcer) account. Only
+      #   set for accounts created with `role_type` `bpo`; `null` for normal enterprises.
+      #   A BPO enterprise must be `approved` before a DIR can be linked to it through
+      #   `bpo_authorizations`.
+      #
+      #   @return [Symbol, Telnyx::Models::EnterprisePublic::BpoVerificationStatus, nil]
+      optional :bpo_verification_status,
+               enum: -> { Telnyx::EnterprisePublic::BpoVerificationStatus },
+               nil?: true
+
       # @!attribute branded_calling_enabled
       #   True once Branded Calling has been activated on this enterprise (see
       #   `POST /enterprises/{id}/branded_calling`).
@@ -22,7 +40,9 @@ module Telnyx
       optional :branded_calling_enabled, Telnyx::Internal::Type::Boolean
 
       # @!attribute corporate_registration_number
-      #   Optional corporate-registration / company-number identifier.
+      #   The official number your company received when it was legally registered or
+      #   incorporated (for example from your state or national business registry). It is
+      #   on your certificate of incorporation.
       #
       #   @return [String, nil]
       optional :corporate_registration_number, String, nil?: true
@@ -33,42 +53,57 @@ module Telnyx
       optional :country_code, String
 
       # @!attribute customer_reference
+      #   Your own label for this account. Enter any reference that helps you find it in
+      #   your records. Telnyx does not use it during vetting.
       #
       #   @return [String, nil]
       optional :customer_reference, String
 
       # @!attribute doing_business_as
+      #   The trade name your business operates under if it is different from your legal
+      #   name, also called a Doing Business As (DBA) name. Leave blank if you only use
+      #   your legal name.
       #
       #   @return [String, nil]
       optional :doing_business_as, String
 
       # @!attribute dun_bradstreet_number
-      #   Optional D-U-N-S Number issued by Dun & Bradstreet.
+      #   Your optional 9-digit D-U-N-S Number issued by Dun & Bradstreet, a unique
+      #   identifier for your business. Leave blank if you do not have one.
       #
       #   @return [String, nil]
       optional :dun_bradstreet_number, String, nil?: true
 
       # @!attribute fein
+      #   US Federal Employer Identification Number (`NN-NNNNNNN`) or Canadian equivalent.
       #
       #   @return [String, nil]
       optional :fein, String
 
       # @!attribute industry
+      #   The industry your business operates in. Choose the closest match from the list;
+      #   if your value is not accepted, pick the nearest category.
       #
       #   @return [String, nil]
       optional :industry, String
 
       # @!attribute jurisdiction_of_incorporation
+      #   The state, province, or country where your business was legally incorporated,
+      #   for example Delaware.
       #
       #   @return [String, nil]
       optional :jurisdiction_of_incorporation, String
 
       # @!attribute legal_name
+      #   Your business's full registered legal name, exactly as it appears on your
+      #   incorporation or tax documents, 3 to 64 characters.
       #
       #   @return [String, nil]
       optional :legal_name, String
 
       # @!attribute number_of_employees
+      #   Approximate headcount range. Used for vetting heuristics; pick the bucket that
+      #   contains your current employee count.
       #
       #   @return [String, nil]
       optional :number_of_employees, String
@@ -86,6 +121,15 @@ module Telnyx
       optional :organization_contact, -> { Telnyx::OrganizationContact }
 
       # @!attribute organization_legal_type
+      #   Legal-entity form. Pick the form that matches your incorporation documents:
+      #
+      #   - `corporation` - C-corp or S-corp.
+      #   - `llc` - limited liability company.
+      #   - `partnership` - general/limited partnership.
+      #   - `nonprofit` - non-profit corporation, charitable trust, or
+      #     501(c)(3)/equivalent.
+      #   - `other` - anything else (sole proprietorships, government bodies, DBAs, etc.).
+      #     You may be asked for additional documents during vetting.
       #
       #   @return [String, nil]
       optional :organization_legal_type, String
@@ -101,23 +145,29 @@ module Telnyx
       optional :organization_type, String
 
       # @!attribute primary_business_domain_sic_code
-      #   Optional SIC code for the primary line of business.
+      #   The 4-digit Standard Industrial Classification code for your main line of
+      #   business, which tells us what industry you operate in. Look it up in the SIC
+      #   code directory if you are unsure.
       #
       #   @return [String, nil]
       optional :primary_business_domain_sic_code, String, nil?: true
 
       # @!attribute professional_license_number
-      #   Optional professional-license number for regulated industries.
+      #   If your business operates under a professional license (for example legal,
+      #   medical, or financial services), enter the license number issued by the
+      #   licensing authority. Leave blank if it does not apply.
       #
       #   @return [String, nil]
       optional :professional_license_number, String, nil?: true
 
       # @!attribute role_type
       #
-      #   @return [String, nil]
-      optional :role_type, String
+      #   @return [Symbol, Telnyx::Models::EnterprisePublic::RoleType, nil]
+      optional :role_type, enum: -> { Telnyx::EnterprisePublic::RoleType }
 
       # @!attribute website
+      #   Your business's public website address, including https://. Leave blank if your
+      #   business has no website.
       #
       #   @return [String, nil]
       optional :website, String
@@ -139,7 +189,7 @@ module Telnyx
         optional :updated_at, Time
       end
 
-      # @!method initialize(id: nil, billing_address: nil, billing_contact: nil, branded_calling_enabled: nil, corporate_registration_number: nil, country_code: nil, created_at: nil, customer_reference: nil, doing_business_as: nil, dun_bradstreet_number: nil, fein: nil, industry: nil, jurisdiction_of_incorporation: nil, legal_name: nil, number_of_employees: nil, number_reputation_enabled: nil, organization_contact: nil, organization_legal_type: nil, organization_physical_address: nil, organization_type: nil, primary_business_domain_sic_code: nil, professional_license_number: nil, role_type: nil, updated_at: nil, website: nil)
+      # @!method initialize(id: nil, billing_address: nil, billing_contact: nil, bpo_verification_rejection_reason: nil, bpo_verification_status: nil, branded_calling_enabled: nil, corporate_registration_number: nil, country_code: nil, created_at: nil, customer_reference: nil, doing_business_as: nil, dun_bradstreet_number: nil, fein: nil, industry: nil, jurisdiction_of_incorporation: nil, legal_name: nil, number_of_employees: nil, number_reputation_enabled: nil, organization_contact: nil, organization_legal_type: nil, organization_physical_address: nil, organization_type: nil, primary_business_domain_sic_code: nil, professional_license_number: nil, role_type: nil, updated_at: nil, website: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::EnterprisePublic} for more details.
       #
@@ -149,49 +199,81 @@ module Telnyx
       #
       #   @param billing_contact [Telnyx::Models::BillingContact]
       #
+      #   @param bpo_verification_rejection_reason [String, nil] Reason Telnyx rejected the BPO (Business Process Outsourcer) verification, when
+      #
+      #   @param bpo_verification_status [Symbol, Telnyx::Models::EnterprisePublic::BpoVerificationStatus, nil] Whether Telnyx has approved this BPO (Business Process Outsourcer) account. Only
+      #
       #   @param branded_calling_enabled [Boolean] True once Branded Calling has been activated on this enterprise (see `POST /ente
       #
-      #   @param corporate_registration_number [String, nil] Optional corporate-registration / company-number identifier.
+      #   @param corporate_registration_number [String, nil] The official number your company received when it was legally registered or inco
       #
       #   @param country_code [String]
       #
       #   @param created_at [Time]
       #
-      #   @param customer_reference [String]
+      #   @param customer_reference [String] Your own label for this account. Enter any reference that helps you find it in y
       #
-      #   @param doing_business_as [String]
+      #   @param doing_business_as [String] The trade name your business operates under if it is different from your legal n
       #
-      #   @param dun_bradstreet_number [String, nil] Optional D-U-N-S Number issued by Dun & Bradstreet.
+      #   @param dun_bradstreet_number [String, nil] Your optional 9-digit D-U-N-S Number issued by Dun & Bradstreet, a unique identi
       #
-      #   @param fein [String]
+      #   @param fein [String] US Federal Employer Identification Number (`NN-NNNNNNN`) or Canadian equivalent.
       #
-      #   @param industry [String]
+      #   @param industry [String] The industry your business operates in. Choose the closest match from the list;
       #
-      #   @param jurisdiction_of_incorporation [String]
+      #   @param jurisdiction_of_incorporation [String] The state, province, or country where your business was legally incorporated, fo
       #
-      #   @param legal_name [String]
+      #   @param legal_name [String] Your business's full registered legal name, exactly as it appears on your incorp
       #
-      #   @param number_of_employees [String]
+      #   @param number_of_employees [String] Approximate headcount range. Used for vetting heuristics; pick the bucket that c
       #
       #   @param number_reputation_enabled [Boolean] True once Phone Number Reputation has been enabled on this enterprise (see `POST
       #
       #   @param organization_contact [Telnyx::Models::OrganizationContact]
       #
-      #   @param organization_legal_type [String]
+      #   @param organization_legal_type [String] Legal-entity form. Pick the form that matches your incorporation documents:
       #
       #   @param organization_physical_address [Telnyx::Models::PhysicalAddress]
       #
       #   @param organization_type [String]
       #
-      #   @param primary_business_domain_sic_code [String, nil] Optional SIC code for the primary line of business.
+      #   @param primary_business_domain_sic_code [String, nil] The 4-digit Standard Industrial Classification code for your main line of busine
       #
-      #   @param professional_license_number [String, nil] Optional professional-license number for regulated industries.
+      #   @param professional_license_number [String, nil] If your business operates under a professional license (for example legal, medic
       #
-      #   @param role_type [String]
+      #   @param role_type [Symbol, Telnyx::Models::EnterprisePublic::RoleType]
       #
       #   @param updated_at [Time]
       #
-      #   @param website [String]
+      #   @param website [String] Your business's public website address, including https://. Leave blank if your
+
+      # Whether Telnyx has approved this BPO (Business Process Outsourcer) account. Only
+      # set for accounts created with `role_type` `bpo`; `null` for normal enterprises.
+      # A BPO enterprise must be `approved` before a DIR can be linked to it through
+      # `bpo_authorizations`.
+      #
+      # @see Telnyx::Models::EnterprisePublic#bpo_verification_status
+      module BpoVerificationStatus
+        extend Telnyx::Internal::Type::Enum
+
+        PENDING = :pending
+        APPROVED = :approved
+        REJECTED = :rejected
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Telnyx::Models::EnterprisePublic#role_type
+      module RoleType
+        extend Telnyx::Internal::Type::Enum
+
+        ENTERPRISE = :enterprise
+        BPO = :bpo
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/telnyx/models/enterprise_update_params.rb

@@ -23,48 +23,65 @@ module Telnyx
       optional :billing_contact, -> { Telnyx::BillingContact }
 
       # @!attribute corporate_registration_number
+      #   The official number your company received when it was legally registered or
+      #   incorporated (for example from your state or national business registry). It is
+      #   on your certificate of incorporation.
       #
       #   @return [String, nil]
       optional :corporate_registration_number, String, nil?: true
 
       # @!attribute customer_reference
+      #   Your own label for this account. Enter any reference that helps you find it in
+      #   your records. Telnyx does not use it during vetting.
       #
       #   @return [String, nil]
       optional :customer_reference, String
 
       # @!attribute doing_business_as
+      #   The trade name your business operates under if it is different from your legal
+      #   name, also called a Doing Business As (DBA) name. Leave blank if you only use
+      #   your legal name.
       #
       #   @return [String, nil]
       optional :doing_business_as, String
 
       # @!attribute dun_bradstreet_number
+      #   Your optional 9-digit D-U-N-S Number issued by Dun & Bradstreet, a unique
+      #   identifier for your business. Leave blank if you do not have one.
       #
       #   @return [String, nil]
       optional :dun_bradstreet_number, String, nil?: true
 
       # @!attribute fein
+      #   US Federal Employer Identification Number (`NN-NNNNNNN`) or Canadian equivalent.
       #
       #   @return [String, nil]
       optional :fein, String
 
       # @!attribute industry
+      #   The industry your business operates in. Choose the closest match from the list;
+      #   if your value is not accepted, pick the nearest category.
       #
       #   @return [Symbol, Telnyx::Models::EnterpriseUpdateParams::Industry, nil]
       optional :industry, enum: -> { Telnyx::EnterpriseUpdateParams::Industry }
 
       # @!attribute jurisdiction_of_incorporation
-      #   Updated state/province/country of incorporation. Optional on update.
+      #   The state, province, or country where your business was legally incorporated,
+      #   for example Delaware.
       #
       #   @return [String, nil]
       optional :jurisdiction_of_incorporation, String
 
       # @!attribute legal_name
-      #   Legal name of the enterprise.
+      #   Your business's full registered legal name, exactly as it appears on your
+      #   incorporation or tax documents, 3 to 64 characters.
       #
       #   @return [String, nil]
       optional :legal_name, String
 
       # @!attribute number_of_employees
+      #   Approximate headcount range. Used for vetting heuristics; pick the bucket that
+      #   contains your current employee count.
       #
       #   @return [String, nil]
       optional :number_of_employees, String
@@ -75,6 +92,15 @@ module Telnyx
       optional :organization_contact, -> { Telnyx::OrganizationContact }
 
       # @!attribute organization_legal_type
+      #   Legal-entity form. Pick the form that matches your incorporation documents:
+      #
+      #   - `corporation` - C-corp or S-corp.
+      #   - `llc` - limited liability company.
+      #   - `partnership` - general/limited partnership.
+      #   - `nonprofit` - non-profit corporation, charitable trust, or
+      #     501(c)(3)/equivalent.
+      #   - `other` - anything else (sole proprietorships, government bodies, DBAs, etc.).
+      #     You may be asked for additional documents during vetting.
       #
       #   @return [String, nil]
       optional :organization_legal_type, String
@@ -85,59 +111,72 @@ module Telnyx
       optional :organization_physical_address, -> { Telnyx::PhysicalAddress }
 
       # @!attribute primary_business_domain_sic_code
+      #   The 4-digit Standard Industrial Classification code for your main line of
+      #   business, which tells us what industry you operate in. Look it up in the SIC
+      #   code directory if you are unsure.
       #
       #   @return [String, nil]
       optional :primary_business_domain_sic_code, String, nil?: true
 
       # @!attribute professional_license_number
+      #   If your business operates under a professional license (for example legal,
+      #   medical, or financial services), enter the license number issued by the
+      #   licensing authority. Leave blank if it does not apply.
       #
       #   @return [String, nil]
       optional :professional_license_number, String, nil?: true
 
       # @!attribute website
+      #   Your business's public website address, including https://. Leave blank if your
+      #   business has no website.
       #
       #   @return [String, nil]
       optional :website, String
 
       # @!method initialize(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, jurisdiction_of_incorporation: 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: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::EnterpriseUpdateParams} for more details.
+      #
       #   @param enterprise_id [String]
       #
       #   @param billing_address [Telnyx::Models::PhysicalAddress]
       #
       #   @param billing_contact [Telnyx::Models::BillingContact]
       #
-      #   @param corporate_registration_number [String, nil]
+      #   @param corporate_registration_number [String, nil] The official number your company received when it was legally registered or inco
       #
-      #   @param customer_reference [String]
+      #   @param customer_reference [String] Your own label for this account. Enter any reference that helps you find it in y
       #
-      #   @param doing_business_as [String]
+      #   @param doing_business_as [String] The trade name your business operates under if it is different from your legal n
       #
-      #   @param dun_bradstreet_number [String, nil]
+      #   @param dun_bradstreet_number [String, nil] Your optional 9-digit D-U-N-S Number issued by Dun & Bradstreet, a unique identi
       #
-      #   @param fein [String]
+      #   @param fein [String] US Federal Employer Identification Number (`NN-NNNNNNN`) or Canadian equivalent.
       #
-      #   @param industry [Symbol, Telnyx::Models::EnterpriseUpdateParams::Industry]
+      #   @param industry [Symbol, Telnyx::Models::EnterpriseUpdateParams::Industry] The industry your business operates in. Choose the closest match from the list;
       #
-      #   @param jurisdiction_of_incorporation [String] Updated state/province/country of incorporation. Optional on update.
+      #   @param jurisdiction_of_incorporation [String] The state, province, or country where your business was legally incorporated, fo
       #
-      #   @param legal_name [String] Legal name of the enterprise.
+      #   @param legal_name [String] Your business's full registered legal name, exactly as it appears on your incorp
       #
-      #   @param number_of_employees [String]
+      #   @param number_of_employees [String] Approximate headcount range. Used for vetting heuristics; pick the bucket that c
       #
       #   @param organization_contact [Telnyx::Models::OrganizationContact]
       #
-      #   @param organization_legal_type [String]
+      #   @param organization_legal_type [String] Legal-entity form. Pick the form that matches your incorporation documents:
       #
       #   @param organization_physical_address [Telnyx::Models::PhysicalAddress]
       #
-      #   @param primary_business_domain_sic_code [String, nil]
+      #   @param primary_business_domain_sic_code [String, nil] The 4-digit Standard Industrial Classification code for your main line of busine
       #
-      #   @param professional_license_number [String, nil]
+      #   @param professional_license_number [String, nil] If your business operates under a professional license (for example legal, medic
       #
-      #   @param website [String]
+      #   @param website [String] Your business's public website address, including https://. Leave blank if your
       #
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
+      # The industry your business operates in. Choose the closest match from the list;
+      # if your value is not accepted, pick the nearest category.
       module Industry
         extend Telnyx::Internal::Type::Enum
 

data/lib/telnyx/models/enterprises/dir_create_params.rb

@@ -35,7 +35,8 @@ module Telnyx
         required :call_reasons, Telnyx::Internal::Type::ArrayOf[String]
 
         # @!attribute certify_brand_is_accurate
-        #   Must be `true`.
+        #   Certification that the DIR information is accurate. Must be `true` for the DIR
+        #   to be submitted for vetting.
         #
         #   @return [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate]
         required :certify_brand_is_accurate,
@@ -61,6 +62,17 @@ module Telnyx
         #   @return [String]
         required :display_name, String
 
+        # @!attribute bpo_authorizations
+        #   Optional. Approved BPO (Business Process Outsourcer) accounts on your
+        #   organization authorized to place branded calls for this DIR, each with the
+        #   signed Letter of Authorization the Brand Owner granted it. Each authorization
+        #   starts `pending` and takes effect only after an admin reviews its Letter of
+        #   Authorization. Omit or send an empty list to authorize no BPO on this DIR.
+        #   Maximum 10.
+        #
+        #   @return [Array<Telnyx::Models::BpoAuthorizationInput>, nil]
+        optional :bpo_authorizations, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::BpoAuthorizationInput] }
+
         # @!attribute documents
         #   Supporting documents. Each `document_id` may appear at most once on a DIR.
         #
@@ -80,7 +92,15 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :reselling, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(enterprise_id:, authorizer_email:, authorizer_name:, call_reasons:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, documents: nil, logo_url: nil, reselling: nil, request_options: {})
+        # @!attribute webhook_url
+        #   Optional `https://` URL that receives webhook notifications when this DIR's
+        #   compliance review completes (rejection outcomes include structured rejection
+        #   reasons). Maximum 2048 characters.
+        #
+        #   @return [String, nil]
+        optional :webhook_url, String, nil?: true
+
+        # @!method initialize(enterprise_id:, authorizer_email:, authorizer_name:, call_reasons:, certify_brand_is_accurate:, certify_ip_ownership:, certify_no_shaft_content:, display_name:, bpo_authorizations: nil, documents: nil, logo_url: nil, reselling: nil, webhook_url: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Enterprises::DirCreateParams} for more details.
         #
@@ -92,7 +112,7 @@ module Telnyx
         #
         #   @param call_reasons [Array<String>] 1–10 reasons your business calls customers. Validate phrasing against `POST /cal
         #
-        #   @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Must be `true`.
+        #   @param certify_brand_is_accurate [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyBrandIsAccurate] Certification that the DIR information is accurate. Must be `true` for the DIR t
         #
         #   @param certify_ip_ownership [Boolean, Telnyx::Models::Enterprises::DirCreateParams::CertifyIPOwnership] Must be `true`. Confirms ownership of any logos/trademarks shown.
         #
@@ -100,15 +120,20 @@ module Telnyx
         #
         #   @param display_name [String] Name shown to call recipients. No emoji; not whitespace-only.
         #
+        #   @param bpo_authorizations [Array<Telnyx::Models::BpoAuthorizationInput>] Optional. Approved BPO (Business Process Outsourcer) accounts on your organizati
+        #
         #   @param documents [Array<Telnyx::Models::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 webhook_url [String, nil] Optional `https://` URL that receives webhook notifications when this DIR's comp
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
-        # Must be `true`.
+        # Certification that the DIR information is accurate. Must be `true` for the DIR
+        # to be submitted for vetting.
         module CertifyBrandIsAccurate
           extend Telnyx::Internal::Type::Enum
 

data/lib/telnyx/models/enterprises/enterprise_email_verification_status_wrapped.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Enterprises
+      # @see Telnyx::Resources::Enterprises::VerifyEmail#create
+      class EnterpriseEmailVerificationStatusWrapped < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   Verification state for an enterprise account's contact email.
+        #
+        #   @return [Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data]
+        required :data, -> { Telnyx::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data }
+
+        # @!method initialize(data:)
+        #   @param data [Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data] Verification state for an enterprise account's contact email.
+
+        # @see Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute email_verified
+          #   Whether the enterprise account's contact email has been confirmed.
+          #
+          #   @return [Boolean]
+          required :email_verified, Telnyx::Internal::Type::Boolean
+
+          # @!attribute status
+          #   `sent` after a code is emailed; `verified` after a successful confirm.
+          #
+          #   @return [Symbol, Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::Status]
+          required :status, enum: -> { Telnyx::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::Status }
+
+          response_only do
+            # @!attribute record_type
+            #   Always `email_verification`.
+            #
+            #   @return [Symbol, Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::RecordType]
+            required :record_type,
+                     enum: -> { Telnyx::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::RecordType }
+
+            # @!attribute expires_at
+            #   When the code just sent stops being accepted. Present on a send response; null
+            #   on a confirm response.
+            #
+            #   @return [Time, nil]
+            optional :expires_at, Time, nil?: true
+
+            # @!attribute sends_remaining_today
+            #   How many more codes may be requested for this enterprise account today. Present
+            #   on a send response; null on a confirm response.
+            #
+            #   @return [Integer, nil]
+            optional :sends_remaining_today, Integer, nil?: true
+          end
+
+          # @!method initialize(email_verified:, record_type:, status:, expires_at: nil, sends_remaining_today: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data}
+          #   for more details.
+          #
+          #   Verification state for an enterprise account's contact email.
+          #
+          #   @param email_verified [Boolean] Whether the enterprise account's contact email has been confirmed.
+          #
+          #   @param record_type [Symbol, Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::RecordType] Always `email_verification`.
+          #
+          #   @param status [Symbol, Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data::Status] `sent` after a code is emailed; `verified` after a successful confirm.
+          #
+          #   @param expires_at [Time, nil] When the code just sent stops being accepted. Present on a send response; null o
+          #
+          #   @param sends_remaining_today [Integer, nil] How many more codes may be requested for this enterprise account today. Present
+
+          # Always `email_verification`.
+          #
+          # @see Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data#record_type
+          module RecordType
+            extend Telnyx::Internal::Type::Enum
+
+            EMAIL_VERIFICATION = :email_verification
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # `sent` after a code is emailed; `verified` after a successful confirm.
+          #
+          # @see Telnyx::Models::Enterprises::EnterpriseEmailVerificationStatusWrapped::Data#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            SENT = :sent
+            VERIFIED = :verified
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+
+    EnterpriseEmailVerificationStatusWrapped = Enterprises::EnterpriseEmailVerificationStatusWrapped
+  end
+end

data/lib/telnyx/models/enterprises/enterprise_reputation_public.rb

@@ -16,6 +16,15 @@ module Telnyx
         #   @return [String, nil]
         optional :enterprise_id, String
 
+        # @!attribute external_verification_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 :external_verification_status,
+                 enum: -> { Telnyx::Enterprises::Reputation::ExternalVerificationStatus },
+                 nil?: true
+
         # @!attribute loa_document_id
         #   Id of the signed LOA document.
         #
@@ -41,6 +50,12 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::Enterprises::EnterpriseReputationPublic::Status, nil]
         optional :status, enum: -> { Telnyx::Enterprises::EnterpriseReputationPublic::Status }
 
+        # @!attribute webhook_url
+        #   HTTPS URL that receives number-ownership webhook events for this enterprise.
+        #
+        #   @return [String, nil]
+        optional :webhook_url, String, nil?: true
+
         response_only do
           # @!attribute created_at
           #
@@ -53,7 +68,7 @@ module Telnyx
           optional :updated_at, Time
         end
 
-        # @!method initialize(check_frequency: nil, created_at: nil, enterprise_id: nil, loa_document_id: nil, loa_status: nil, rejection_reasons: nil, status: nil, updated_at: nil)
+        # @!method initialize(check_frequency: nil, created_at: nil, enterprise_id: nil, external_verification_status: nil, loa_document_id: nil, loa_status: nil, rejection_reasons: nil, status: nil, updated_at: nil, webhook_url: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Enterprises::EnterpriseReputationPublic} for more details.
         #
@@ -63,6 +78,8 @@ module Telnyx
         #
         #   @param enterprise_id [String]
         #
+        #   @param external_verification_status [Symbol, Telnyx::Models::Enterprises::Reputation::ExternalVerificationStatus, nil] Review state of the ownership proof that allows adding phone numbers hosted with
+        #
         #   @param loa_document_id [String, nil] Id of the signed LOA document.
         #
         #   @param loa_status [Symbol, Telnyx::Models::Enterprises::EnterpriseReputationPublic::LoaStatus] Customer-facing Letter-of-Authorization verification state. `approved` is requir
@@ -72,6 +89,8 @@ module Telnyx
         #   @param status [Symbol, Telnyx::Models::Enterprises::EnterpriseReputationPublic::Status] Lifecycle status of the enterprise's Phone Number Reputation activation.
         #
         #   @param updated_at [Time]
+        #
+        #   @param webhook_url [String, nil] HTTPS URL that receives number-ownership webhook events for this enterprise.
 
         # Customer-facing Letter-of-Authorization verification state. `approved` is
         # required (alongside reputation status) before phone numbers can be added.