telnyx 3.5.0a0__py3-none-any.whl → 3.6.0__py3-none-any.whl

telnyx/resources/messaging_tollfree/verification/requests.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Union, Iterable
+from typing import Union, Iterable, Optional
 from datetime import datetime
 
 import httpx
@@ -22,6 +22,7 @@ from ....types.messaging_tollfree.verification import (
     Volume,
     UseCaseCategories,
     TfVerificationStatus,
+    TollFreeVerificationEntityType,
     request_list_params,
     request_create_params,
     request_update_params,
@@ -34,6 +35,7 @@ from ....types.messaging_tollfree.verification.tf_phone_number_param import TfPh
 from ....types.messaging_tollfree.verification.tf_verification_status import TfVerificationStatus
 from ....types.messaging_tollfree.verification.verification_request_egress import VerificationRequestEgress
 from ....types.messaging_tollfree.verification.verification_request_status import VerificationRequestStatus
+from ....types.messaging_tollfree.verification.toll_free_verification_entity_type import TollFreeVerificationEntityType
 
 __all__ = ["RequestsResource", "AsyncRequestsResource"]
 
@@ -80,7 +82,18 @@ class RequestsResource(SyncAPIResource):
         production_message_content: str,
         use_case: UseCaseCategories,
         use_case_summary: str,
+        age_gated_content: bool | Omit = omit,
         business_addr2: str | Omit = omit,
+        business_registration_country: Optional[str] | Omit = omit,
+        business_registration_number: Optional[str] | Omit = omit,
+        business_registration_type: Optional[str] | Omit = omit,
+        doing_business_as: Optional[str] | Omit = omit,
+        entity_type: Optional[TollFreeVerificationEntityType] | Omit = omit,
+        help_message_response: Optional[str] | Omit = omit,
+        opt_in_confirmation_response: Optional[str] | Omit = omit,
+        opt_in_keywords: Optional[str] | Omit = omit,
+        privacy_policy_url: Optional[str] | Omit = omit,
+        terms_and_condition_url: Optional[str] | Omit = omit,
         webhook_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -135,8 +148,36 @@ class RequestsResource(SyncAPIResource):
 
           use_case_summary: Human-readable summary of the desired use-case
 
+          age_gated_content: Indicates if messaging content requires age gating (e.g., 18+). Defaults to
+              false if not provided.
+
           business_addr2: Line 2 of the business address
 
+          business_registration_country: ISO 3166-1 alpha-2 country code of the issuing business authority. Must be
+              exactly 2 letters. Automatically converted to uppercase. Required from
+              January 2026.
+
+          business_registration_number: Official business registration number (e.g., Employer Identification Number
+              (EIN) in the U.S.). Required from January 2026.
+
+          business_registration_type: Type of business registration being provided. Required from January 2026.
+
+          doing_business_as: Doing Business As (DBA) name if different from legal name
+
+          entity_type: Business entity classification
+
+          help_message_response: The message returned when users text 'HELP'
+
+          opt_in_confirmation_response: Message sent to users confirming their opt-in to receive messages
+
+          opt_in_keywords: Keywords used to collect and process consumer opt-ins
+
+          privacy_policy_url: URL pointing to the business's privacy policy. Plain string, no URL format
+              validation.
+
+          terms_and_condition_url: URL pointing to the business's terms and conditions. Plain string, no URL format
+              validation.
+
           webhook_url: URL that should receive webhooks relating to this verification request
 
           extra_headers: Send extra headers
@@ -170,7 +211,18 @@ class RequestsResource(SyncAPIResource):
                     "production_message_content": production_message_content,
                     "use_case": use_case,
                     "use_case_summary": use_case_summary,
+                    "age_gated_content": age_gated_content,
                     "business_addr2": business_addr2,
+                    "business_registration_country": business_registration_country,
+                    "business_registration_number": business_registration_number,
+                    "business_registration_type": business_registration_type,
+                    "doing_business_as": doing_business_as,
+                    "entity_type": entity_type,
+                    "help_message_response": help_message_response,
+                    "opt_in_confirmation_response": opt_in_confirmation_response,
+                    "opt_in_keywords": opt_in_keywords,
+                    "privacy_policy_url": privacy_policy_url,
+                    "terms_and_condition_url": terms_and_condition_url,
                     "webhook_url": webhook_url,
                 },
                 request_create_params.RequestCreateParams,
@@ -237,7 +289,18 @@ class RequestsResource(SyncAPIResource):
         production_message_content: str,
         use_case: UseCaseCategories,
         use_case_summary: str,
+        age_gated_content: bool | Omit = omit,
         business_addr2: str | Omit = omit,
+        business_registration_country: Optional[str] | Omit = omit,
+        business_registration_number: Optional[str] | Omit = omit,
+        business_registration_type: Optional[str] | Omit = omit,
+        doing_business_as: Optional[str] | Omit = omit,
+        entity_type: Optional[TollFreeVerificationEntityType] | Omit = omit,
+        help_message_response: Optional[str] | Omit = omit,
+        opt_in_confirmation_response: Optional[str] | Omit = omit,
+        opt_in_keywords: Optional[str] | Omit = omit,
+        privacy_policy_url: Optional[str] | Omit = omit,
+        terms_and_condition_url: Optional[str] | Omit = omit,
         webhook_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -294,8 +357,36 @@ class RequestsResource(SyncAPIResource):
 
           use_case_summary: Human-readable summary of the desired use-case
 
+          age_gated_content: Indicates if messaging content requires age gating (e.g., 18+). Defaults to
+              false if not provided.
+
           business_addr2: Line 2 of the business address
 
+          business_registration_country: ISO 3166-1 alpha-2 country code of the issuing business authority. Must be
+              exactly 2 letters. Automatically converted to uppercase. Required from
+              January 2026.
+
+          business_registration_number: Official business registration number (e.g., Employer Identification Number
+              (EIN) in the U.S.). Required from January 2026.
+
+          business_registration_type: Type of business registration being provided. Required from January 2026.
+
+          doing_business_as: Doing Business As (DBA) name if different from legal name
+
+          entity_type: Business entity classification
+
+          help_message_response: The message returned when users text 'HELP'
+
+          opt_in_confirmation_response: Message sent to users confirming their opt-in to receive messages
+
+          opt_in_keywords: Keywords used to collect and process consumer opt-ins
+
+          privacy_policy_url: URL pointing to the business's privacy policy. Plain string, no URL format
+              validation.
+
+          terms_and_condition_url: URL pointing to the business's terms and conditions. Plain string, no URL format
+              validation.
+
           webhook_url: URL that should receive webhooks relating to this verification request
 
           extra_headers: Send extra headers
@@ -331,7 +422,18 @@ class RequestsResource(SyncAPIResource):
                     "production_message_content": production_message_content,
                     "use_case": use_case,
                     "use_case_summary": use_case_summary,
+                    "age_gated_content": age_gated_content,
                     "business_addr2": business_addr2,
+                    "business_registration_country": business_registration_country,
+                    "business_registration_number": business_registration_number,
+                    "business_registration_type": business_registration_type,
+                    "doing_business_as": doing_business_as,
+                    "entity_type": entity_type,
+                    "help_message_response": help_message_response,
+                    "opt_in_confirmation_response": opt_in_confirmation_response,
+                    "opt_in_keywords": opt_in_keywords,
+                    "privacy_policy_url": privacy_policy_url,
+                    "terms_and_condition_url": terms_and_condition_url,
                     "webhook_url": webhook_url,
                 },
                 request_update_params.RequestUpdateParams,
@@ -480,7 +582,18 @@ class AsyncRequestsResource(AsyncAPIResource):
         production_message_content: str,
         use_case: UseCaseCategories,
         use_case_summary: str,
+        age_gated_content: bool | Omit = omit,
         business_addr2: str | Omit = omit,
+        business_registration_country: Optional[str] | Omit = omit,
+        business_registration_number: Optional[str] | Omit = omit,
+        business_registration_type: Optional[str] | Omit = omit,
+        doing_business_as: Optional[str] | Omit = omit,
+        entity_type: Optional[TollFreeVerificationEntityType] | Omit = omit,
+        help_message_response: Optional[str] | Omit = omit,
+        opt_in_confirmation_response: Optional[str] | Omit = omit,
+        opt_in_keywords: Optional[str] | Omit = omit,
+        privacy_policy_url: Optional[str] | Omit = omit,
+        terms_and_condition_url: Optional[str] | Omit = omit,
         webhook_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -535,8 +648,36 @@ class AsyncRequestsResource(AsyncAPIResource):
 
           use_case_summary: Human-readable summary of the desired use-case
 
+          age_gated_content: Indicates if messaging content requires age gating (e.g., 18+). Defaults to
+              false if not provided.
+
           business_addr2: Line 2 of the business address
 
+          business_registration_country: ISO 3166-1 alpha-2 country code of the issuing business authority. Must be
+              exactly 2 letters. Automatically converted to uppercase. Required from
+              January 2026.
+
+          business_registration_number: Official business registration number (e.g., Employer Identification Number
+              (EIN) in the U.S.). Required from January 2026.
+
+          business_registration_type: Type of business registration being provided. Required from January 2026.
+
+          doing_business_as: Doing Business As (DBA) name if different from legal name
+
+          entity_type: Business entity classification
+
+          help_message_response: The message returned when users text 'HELP'
+
+          opt_in_confirmation_response: Message sent to users confirming their opt-in to receive messages
+
+          opt_in_keywords: Keywords used to collect and process consumer opt-ins
+
+          privacy_policy_url: URL pointing to the business's privacy policy. Plain string, no URL format
+              validation.
+
+          terms_and_condition_url: URL pointing to the business's terms and conditions. Plain string, no URL format
+              validation.
+
           webhook_url: URL that should receive webhooks relating to this verification request
 
           extra_headers: Send extra headers
@@ -570,7 +711,18 @@ class AsyncRequestsResource(AsyncAPIResource):
                     "production_message_content": production_message_content,
                     "use_case": use_case,
                     "use_case_summary": use_case_summary,
+                    "age_gated_content": age_gated_content,
                     "business_addr2": business_addr2,
+                    "business_registration_country": business_registration_country,
+                    "business_registration_number": business_registration_number,
+                    "business_registration_type": business_registration_type,
+                    "doing_business_as": doing_business_as,
+                    "entity_type": entity_type,
+                    "help_message_response": help_message_response,
+                    "opt_in_confirmation_response": opt_in_confirmation_response,
+                    "opt_in_keywords": opt_in_keywords,
+                    "privacy_policy_url": privacy_policy_url,
+                    "terms_and_condition_url": terms_and_condition_url,
                     "webhook_url": webhook_url,
                 },
                 request_create_params.RequestCreateParams,
@@ -637,7 +789,18 @@ class AsyncRequestsResource(AsyncAPIResource):
         production_message_content: str,
         use_case: UseCaseCategories,
         use_case_summary: str,
+        age_gated_content: bool | Omit = omit,
         business_addr2: str | Omit = omit,
+        business_registration_country: Optional[str] | Omit = omit,
+        business_registration_number: Optional[str] | Omit = omit,
+        business_registration_type: Optional[str] | Omit = omit,
+        doing_business_as: Optional[str] | Omit = omit,
+        entity_type: Optional[TollFreeVerificationEntityType] | Omit = omit,
+        help_message_response: Optional[str] | Omit = omit,
+        opt_in_confirmation_response: Optional[str] | Omit = omit,
+        opt_in_keywords: Optional[str] | Omit = omit,
+        privacy_policy_url: Optional[str] | Omit = omit,
+        terms_and_condition_url: Optional[str] | Omit = omit,
         webhook_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -694,8 +857,36 @@ class AsyncRequestsResource(AsyncAPIResource):
 
           use_case_summary: Human-readable summary of the desired use-case
 
+          age_gated_content: Indicates if messaging content requires age gating (e.g., 18+). Defaults to
+              false if not provided.
+
           business_addr2: Line 2 of the business address
 
+          business_registration_country: ISO 3166-1 alpha-2 country code of the issuing business authority. Must be
+              exactly 2 letters. Automatically converted to uppercase. Required from
+              January 2026.
+
+          business_registration_number: Official business registration number (e.g., Employer Identification Number
+              (EIN) in the U.S.). Required from January 2026.
+
+          business_registration_type: Type of business registration being provided. Required from January 2026.
+
+          doing_business_as: Doing Business As (DBA) name if different from legal name
+
+          entity_type: Business entity classification
+
+          help_message_response: The message returned when users text 'HELP'
+
+          opt_in_confirmation_response: Message sent to users confirming their opt-in to receive messages
+
+          opt_in_keywords: Keywords used to collect and process consumer opt-ins
+
+          privacy_policy_url: URL pointing to the business's privacy policy. Plain string, no URL format
+              validation.
+
+          terms_and_condition_url: URL pointing to the business's terms and conditions. Plain string, no URL format
+              validation.
+
           webhook_url: URL that should receive webhooks relating to this verification request
 
           extra_headers: Send extra headers
@@ -731,7 +922,18 @@ class AsyncRequestsResource(AsyncAPIResource):
                     "production_message_content": production_message_content,
                     "use_case": use_case,
                     "use_case_summary": use_case_summary,
+                    "age_gated_content": age_gated_content,
                     "business_addr2": business_addr2,
+                    "business_registration_country": business_registration_country,
+                    "business_registration_number": business_registration_number,
+                    "business_registration_type": business_registration_type,
+                    "doing_business_as": doing_business_as,
+                    "entity_type": entity_type,
+                    "help_message_response": help_message_response,
+                    "opt_in_confirmation_response": opt_in_confirmation_response,
+                    "opt_in_keywords": opt_in_keywords,
+                    "privacy_policy_url": privacy_policy_url,
+                    "terms_and_condition_url": terms_and_condition_url,
                     "webhook_url": webhook_url,
                 },
                 request_update_params.RequestUpdateParams,