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

telnyx/types/messaging_tollfree/verification/request_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Iterable, Optional
 from typing_extensions import Required, Annotated, TypedDict
 
 from .volume import Volume
@@ -10,6 +10,7 @@ from ...._utils import PropertyInfo
 from .url_param import URLParam
 from .use_case_categories import UseCaseCategories
 from .tf_phone_number_param import TfPhoneNumberParam
+from .toll_free_verification_entity_type import TollFreeVerificationEntityType
 
 __all__ = ["RequestCreateParams"]
 
@@ -84,8 +85,57 @@ class RequestCreateParams(TypedDict, total=False):
     use_case_summary: Required[Annotated[str, PropertyInfo(alias="useCaseSummary")]]
     """Human-readable summary of the desired use-case"""
 
+    age_gated_content: Annotated[bool, PropertyInfo(alias="ageGatedContent")]
+    """Indicates if messaging content requires age gating (e.g., 18+).
+
+    Defaults to false if not provided.
+    """
+
     business_addr2: Annotated[str, PropertyInfo(alias="businessAddr2")]
     """Line 2 of the business address"""
 
+    business_registration_country: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationCountry")]
+    """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: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationNumber")]
+    """
+    Official business registration number (e.g., Employer Identification Number
+    (EIN) in the U.S.). Required from January 2026.
+    """
+
+    business_registration_type: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationType")]
+    """Type of business registration being provided. Required from January 2026."""
+
+    doing_business_as: Annotated[Optional[str], PropertyInfo(alias="doingBusinessAs")]
+    """Doing Business As (DBA) name if different from legal name"""
+
+    entity_type: Annotated[Optional[TollFreeVerificationEntityType], PropertyInfo(alias="entityType")]
+    """Business entity classification"""
+
+    help_message_response: Annotated[Optional[str], PropertyInfo(alias="helpMessageResponse")]
+    """The message returned when users text 'HELP'"""
+
+    opt_in_confirmation_response: Annotated[Optional[str], PropertyInfo(alias="optInConfirmationResponse")]
+    """Message sent to users confirming their opt-in to receive messages"""
+
+    opt_in_keywords: Annotated[Optional[str], PropertyInfo(alias="optInKeywords")]
+    """Keywords used to collect and process consumer opt-ins"""
+
+    privacy_policy_url: Annotated[Optional[str], PropertyInfo(alias="privacyPolicyURL")]
+    """URL pointing to the business's privacy policy.
+
+    Plain string, no URL format validation.
+    """
+
+    terms_and_condition_url: Annotated[Optional[str], PropertyInfo(alias="termsAndConditionURL")]
+    """URL pointing to the business's terms and conditions.
+
+    Plain string, no URL format validation.
+    """
+
     webhook_url: Annotated[str, PropertyInfo(alias="webhookUrl")]
     """URL that should receive webhooks relating to this verification request"""

telnyx/types/messaging_tollfree/verification/request_update_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Iterable, Optional
 from typing_extensions import Required, Annotated, TypedDict
 
 from .volume import Volume
@@ -10,6 +10,7 @@ from ...._utils import PropertyInfo
 from .url_param import URLParam
 from .use_case_categories import UseCaseCategories
 from .tf_phone_number_param import TfPhoneNumberParam
+from .toll_free_verification_entity_type import TollFreeVerificationEntityType
 
 __all__ = ["RequestUpdateParams"]
 
@@ -84,8 +85,57 @@ class RequestUpdateParams(TypedDict, total=False):
     use_case_summary: Required[Annotated[str, PropertyInfo(alias="useCaseSummary")]]
     """Human-readable summary of the desired use-case"""
 
+    age_gated_content: Annotated[bool, PropertyInfo(alias="ageGatedContent")]
+    """Indicates if messaging content requires age gating (e.g., 18+).
+
+    Defaults to false if not provided.
+    """
+
     business_addr2: Annotated[str, PropertyInfo(alias="businessAddr2")]
     """Line 2 of the business address"""
 
+    business_registration_country: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationCountry")]
+    """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: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationNumber")]
+    """
+    Official business registration number (e.g., Employer Identification Number
+    (EIN) in the U.S.). Required from January 2026.
+    """
+
+    business_registration_type: Annotated[Optional[str], PropertyInfo(alias="businessRegistrationType")]
+    """Type of business registration being provided. Required from January 2026."""
+
+    doing_business_as: Annotated[Optional[str], PropertyInfo(alias="doingBusinessAs")]
+    """Doing Business As (DBA) name if different from legal name"""
+
+    entity_type: Annotated[Optional[TollFreeVerificationEntityType], PropertyInfo(alias="entityType")]
+    """Business entity classification"""
+
+    help_message_response: Annotated[Optional[str], PropertyInfo(alias="helpMessageResponse")]
+    """The message returned when users text 'HELP'"""
+
+    opt_in_confirmation_response: Annotated[Optional[str], PropertyInfo(alias="optInConfirmationResponse")]
+    """Message sent to users confirming their opt-in to receive messages"""
+
+    opt_in_keywords: Annotated[Optional[str], PropertyInfo(alias="optInKeywords")]
+    """Keywords used to collect and process consumer opt-ins"""
+
+    privacy_policy_url: Annotated[Optional[str], PropertyInfo(alias="privacyPolicyURL")]
+    """URL pointing to the business's privacy policy.
+
+    Plain string, no URL format validation.
+    """
+
+    terms_and_condition_url: Annotated[Optional[str], PropertyInfo(alias="termsAndConditionURL")]
+    """URL pointing to the business's terms and conditions.
+
+    Plain string, no URL format validation.
+    """
+
     webhook_url: Annotated[str, PropertyInfo(alias="webhookUrl")]
     """URL that should receive webhooks relating to this verification request"""

telnyx/types/messaging_tollfree/verification/toll_free_verification_entity_type.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["TollFreeVerificationEntityType"]
+
+TollFreeVerificationEntityType: TypeAlias = Literal[
+    "SOLE_PROPRIETOR", "PRIVATE_PROFIT", "PUBLIC_PROFIT", "NON_PROFIT", "GOVERNMENT"
+]

telnyx/types/messaging_tollfree/verification/verification_request_egress.py

@@ -10,6 +10,7 @@ from ...._models import BaseModel
 from .tf_phone_number import TfPhoneNumber
 from .use_case_categories import UseCaseCategories
 from .tf_verification_status import TfVerificationStatus
+from .toll_free_verification_entity_type import TollFreeVerificationEntityType
 
 __all__ = ["VerificationRequestEgress"]
 
@@ -59,8 +60,31 @@ class VerificationRequestEgress(BaseModel):
 
     verification_request_id: str = FieldInfo(alias="verificationRequestId")
 
+    age_gated_content: Optional[bool] = FieldInfo(alias="ageGatedContent", default=None)
+
     business_addr2: Optional[str] = FieldInfo(alias="businessAddr2", default=None)
 
+    business_registration_country: Optional[str] = FieldInfo(alias="businessRegistrationCountry", default=None)
+
+    business_registration_number: Optional[str] = FieldInfo(alias="businessRegistrationNumber", default=None)
+
+    business_registration_type: Optional[str] = FieldInfo(alias="businessRegistrationType", default=None)
+
+    doing_business_as: Optional[str] = FieldInfo(alias="doingBusinessAs", default=None)
+
+    entity_type: Optional[TollFreeVerificationEntityType] = FieldInfo(alias="entityType", default=None)
+    """Business entity classification"""
+
+    help_message_response: Optional[str] = FieldInfo(alias="helpMessageResponse", default=None)
+
+    opt_in_confirmation_response: Optional[str] = FieldInfo(alias="optInConfirmationResponse", default=None)
+
+    opt_in_keywords: Optional[str] = FieldInfo(alias="optInKeywords", default=None)
+
+    privacy_policy_url: Optional[str] = FieldInfo(alias="privacyPolicyURL", default=None)
+
+    terms_and_condition_url: Optional[str] = FieldInfo(alias="termsAndConditionURL", default=None)
+
     verification_status: Optional[TfVerificationStatus] = FieldInfo(alias="verificationStatus", default=None)
     """Tollfree verification status"""
 

telnyx/types/messaging_tollfree/verification/verification_request_status.py

@@ -11,6 +11,7 @@ from ...._models import BaseModel
 from .tf_phone_number import TfPhoneNumber
 from .use_case_categories import UseCaseCategories
 from .tf_verification_status import TfVerificationStatus
+from .toll_free_verification_entity_type import TollFreeVerificationEntityType
 
 __all__ = ["VerificationRequestStatus"]
 
@@ -61,12 +62,35 @@ class VerificationRequestStatus(BaseModel):
     verification_status: TfVerificationStatus = FieldInfo(alias="verificationStatus")
     """Tollfree verification status"""
 
+    age_gated_content: Optional[bool] = FieldInfo(alias="ageGatedContent", default=None)
+
     business_addr2: Optional[str] = FieldInfo(alias="businessAddr2", default=None)
 
+    business_registration_country: Optional[str] = FieldInfo(alias="businessRegistrationCountry", default=None)
+
+    business_registration_number: Optional[str] = FieldInfo(alias="businessRegistrationNumber", default=None)
+
+    business_registration_type: Optional[str] = FieldInfo(alias="businessRegistrationType", default=None)
+
     created_at: Optional[datetime] = FieldInfo(alias="createdAt", default=None)
 
+    doing_business_as: Optional[str] = FieldInfo(alias="doingBusinessAs", default=None)
+
+    entity_type: Optional[TollFreeVerificationEntityType] = FieldInfo(alias="entityType", default=None)
+    """Business entity classification"""
+
+    help_message_response: Optional[str] = FieldInfo(alias="helpMessageResponse", default=None)
+
+    opt_in_confirmation_response: Optional[str] = FieldInfo(alias="optInConfirmationResponse", default=None)
+
+    opt_in_keywords: Optional[str] = FieldInfo(alias="optInKeywords", default=None)
+
+    privacy_policy_url: Optional[str] = FieldInfo(alias="privacyPolicyURL", default=None)
+
     reason: Optional[str] = None
 
+    terms_and_condition_url: Optional[str] = FieldInfo(alias="termsAndConditionURL", default=None)
+
     updated_at: Optional[datetime] = FieldInfo(alias="updatedAt", default=None)
 
     webhook_url: Optional[str] = FieldInfo(alias="webhookUrl", default=None)

telnyx/types/number_order_status_update_webhook_event1.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+from .number_order_with_phone_numbers import NumberOrderWithPhoneNumbers
+
+__all__ = ["NumberOrderStatusUpdateWebhookEvent", "Data", "Meta"]
+
+
+class Data(BaseModel):
+    id: str
+    """Unique identifier for the event"""
+
+    event_type: str
+    """The type of event being sent"""
+
+    occurred_at: datetime
+    """ISO 8601 timestamp of when the event occurred"""
+
+    payload: NumberOrderWithPhoneNumbers
+
+    record_type: str
+    """Type of record"""
+
+
+class Meta(BaseModel):
+    attempt: int
+    """Webhook delivery attempt number"""
+
+    delivered_to: str
+    """URL where the webhook was delivered"""
+
+
+class NumberOrderStatusUpdateWebhookEvent(BaseModel):
+    data: Data
+
+    meta: Meta

telnyx/types/oauth_client.py

@@ -0,0 +1,59 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["OAuthClient"]
+
+
+class OAuthClient(BaseModel):
+    client_id: str
+    """OAuth client identifier"""
+
+    client_type: Literal["public", "confidential"]
+    """OAuth client type"""
+
+    created_at: datetime
+    """Timestamp when the client was created"""
+
+    name: str
+    """Human-readable name for the OAuth client"""
+
+    org_id: str
+    """Organization ID that owns this OAuth client"""
+
+    record_type: Literal["oauth_client"]
+    """Record type identifier"""
+
+    require_pkce: bool
+    """Whether PKCE (Proof Key for Code Exchange) is required for this client"""
+
+    updated_at: datetime
+    """Timestamp when the client was last updated"""
+
+    user_id: str
+    """User ID that created this OAuth client"""
+
+    allowed_grant_types: Optional[List[Literal["client_credentials", "authorization_code", "refresh_token"]]] = None
+    """List of allowed OAuth grant types"""
+
+    allowed_scopes: Optional[List[str]] = None
+    """List of allowed OAuth scopes"""
+
+    client_secret: Optional[str] = None
+    """Client secret (only included when available, for confidential clients)"""
+
+    logo_uri: Optional[str] = None
+    """URL of the client logo"""
+
+    policy_uri: Optional[str] = None
+    """URL of the client's privacy policy"""
+
+    redirect_uris: Optional[List[str]] = None
+    """List of allowed redirect URIs"""
+
+    tos_uri: Optional[str] = None
+    """URL of the client's terms of service"""

telnyx/types/oauth_client_create_response.py

@@ -1,63 +1,12 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
-from datetime import datetime
-from typing_extensions import Literal
+from typing import Optional
 
 from .._models import BaseModel
+from .oauth_client import OAuthClient
 
-__all__ = ["OAuthClientCreateResponse", "Data"]
-
-
-class Data(BaseModel):
-    client_id: str
-    """OAuth client identifier"""
-
-    client_type: Literal["public", "confidential"]
-    """OAuth client type"""
-
-    created_at: datetime
-    """Timestamp when the client was created"""
-
-    name: str
-    """Human-readable name for the OAuth client"""
-
-    org_id: str
-    """Organization ID that owns this OAuth client"""
-
-    record_type: Literal["oauth_client"]
-    """Record type identifier"""
-
-    require_pkce: bool
-    """Whether PKCE (Proof Key for Code Exchange) is required for this client"""
-
-    updated_at: datetime
-    """Timestamp when the client was last updated"""
-
-    user_id: str
-    """User ID that created this OAuth client"""
-
-    allowed_grant_types: Optional[List[Literal["client_credentials", "authorization_code", "refresh_token"]]] = None
-    """List of allowed OAuth grant types"""
-
-    allowed_scopes: Optional[List[str]] = None
-    """List of allowed OAuth scopes"""
-
-    client_secret: Optional[str] = None
-    """Client secret (only included when available, for confidential clients)"""
-
-    logo_uri: Optional[str] = None
-    """URL of the client logo"""
-
-    policy_uri: Optional[str] = None
-    """URL of the client's privacy policy"""
-
-    redirect_uris: Optional[List[str]] = None
-    """List of allowed redirect URIs"""
-
-    tos_uri: Optional[str] = None
-    """URL of the client's terms of service"""
+__all__ = ["OAuthClientCreateResponse"]
 
 
 class OAuthClientCreateResponse(BaseModel):
-    data: Optional[Data] = None
+    data: Optional[OAuthClient] = None

telnyx/types/oauth_client_list_response.py

@@ -1,79 +1,15 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import List, Optional
-from datetime import datetime
-from typing_extensions import Literal
 
 from .._models import BaseModel
+from .oauth_client import OAuthClient
+from .pagination_meta_oauth import PaginationMetaOAuth
 
-__all__ = ["OAuthClientListResponse", "Data", "Meta"]
-
-
-class Data(BaseModel):
-    client_id: str
-    """OAuth client identifier"""
-
-    client_type: Literal["public", "confidential"]
-    """OAuth client type"""
-
-    created_at: datetime
-    """Timestamp when the client was created"""
-
-    name: str
-    """Human-readable name for the OAuth client"""
-
-    org_id: str
-    """Organization ID that owns this OAuth client"""
-
-    record_type: Literal["oauth_client"]
-    """Record type identifier"""
-
-    require_pkce: bool
-    """Whether PKCE (Proof Key for Code Exchange) is required for this client"""
-
-    updated_at: datetime
-    """Timestamp when the client was last updated"""
-
-    user_id: str
-    """User ID that created this OAuth client"""
-
-    allowed_grant_types: Optional[List[Literal["client_credentials", "authorization_code", "refresh_token"]]] = None
-    """List of allowed OAuth grant types"""
-
-    allowed_scopes: Optional[List[str]] = None
-    """List of allowed OAuth scopes"""
-
-    client_secret: Optional[str] = None
-    """Client secret (only included when available, for confidential clients)"""
-
-    logo_uri: Optional[str] = None
-    """URL of the client logo"""
-
-    policy_uri: Optional[str] = None
-    """URL of the client's privacy policy"""
-
-    redirect_uris: Optional[List[str]] = None
-    """List of allowed redirect URIs"""
-
-    tos_uri: Optional[str] = None
-    """URL of the client's terms of service"""
-
-
-class Meta(BaseModel):
-    page_number: Optional[int] = None
-    """Current page number"""
-
-    page_size: Optional[int] = None
-    """Number of items per page"""
-
-    total_pages: Optional[int] = None
-    """Total number of pages"""
-
-    total_results: Optional[int] = None
-    """Total number of results"""
+__all__ = ["OAuthClientListResponse"]
 
 
 class OAuthClientListResponse(BaseModel):
-    data: Optional[List[Data]] = None
+    data: Optional[List[OAuthClient]] = None
 
-    meta: Optional[Meta] = None
+    meta: Optional[PaginationMetaOAuth] = None

telnyx/types/oauth_client_retrieve_response.py

@@ -1,63 +1,12 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
-from datetime import datetime
-from typing_extensions import Literal
+from typing import Optional
 
 from .._models import BaseModel
+from .oauth_client import OAuthClient
 
-__all__ = ["OAuthClientRetrieveResponse", "Data"]
-
-
-class Data(BaseModel):
-    client_id: str
-    """OAuth client identifier"""
-
-    client_type: Literal["public", "confidential"]
-    """OAuth client type"""
-
-    created_at: datetime
-    """Timestamp when the client was created"""
-
-    name: str
-    """Human-readable name for the OAuth client"""
-
-    org_id: str
-    """Organization ID that owns this OAuth client"""
-
-    record_type: Literal["oauth_client"]
-    """Record type identifier"""
-
-    require_pkce: bool
-    """Whether PKCE (Proof Key for Code Exchange) is required for this client"""
-
-    updated_at: datetime
-    """Timestamp when the client was last updated"""
-
-    user_id: str
-    """User ID that created this OAuth client"""
-
-    allowed_grant_types: Optional[List[Literal["client_credentials", "authorization_code", "refresh_token"]]] = None
-    """List of allowed OAuth grant types"""
-
-    allowed_scopes: Optional[List[str]] = None
-    """List of allowed OAuth scopes"""
-
-    client_secret: Optional[str] = None
-    """Client secret (only included when available, for confidential clients)"""
-
-    logo_uri: Optional[str] = None
-    """URL of the client logo"""
-
-    policy_uri: Optional[str] = None
-    """URL of the client's privacy policy"""
-
-    redirect_uris: Optional[List[str]] = None
-    """List of allowed redirect URIs"""
-
-    tos_uri: Optional[str] = None
-    """URL of the client's terms of service"""
+__all__ = ["OAuthClientRetrieveResponse"]
 
 
 class OAuthClientRetrieveResponse(BaseModel):
-    data: Optional[Data] = None
+    data: Optional[OAuthClient] = None

telnyx/types/oauth_client_update_response.py

@@ -1,63 +1,12 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
-from datetime import datetime
-from typing_extensions import Literal
+from typing import Optional
 
 from .._models import BaseModel
+from .oauth_client import OAuthClient
 
-__all__ = ["OAuthClientUpdateResponse", "Data"]
-
-
-class Data(BaseModel):
-    client_id: str
-    """OAuth client identifier"""
-
-    client_type: Literal["public", "confidential"]
-    """OAuth client type"""
-
-    created_at: datetime
-    """Timestamp when the client was created"""
-
-    name: str
-    """Human-readable name for the OAuth client"""
-
-    org_id: str
-    """Organization ID that owns this OAuth client"""
-
-    record_type: Literal["oauth_client"]
-    """Record type identifier"""
-
-    require_pkce: bool
-    """Whether PKCE (Proof Key for Code Exchange) is required for this client"""
-
-    updated_at: datetime
-    """Timestamp when the client was last updated"""
-
-    user_id: str
-    """User ID that created this OAuth client"""
-
-    allowed_grant_types: Optional[List[Literal["client_credentials", "authorization_code", "refresh_token"]]] = None
-    """List of allowed OAuth grant types"""
-
-    allowed_scopes: Optional[List[str]] = None
-    """List of allowed OAuth scopes"""
-
-    client_secret: Optional[str] = None
-    """Client secret (only included when available, for confidential clients)"""
-
-    logo_uri: Optional[str] = None
-    """URL of the client logo"""
-
-    policy_uri: Optional[str] = None
-    """URL of the client's privacy policy"""
-
-    redirect_uris: Optional[List[str]] = None
-    """List of allowed redirect URIs"""
-
-    tos_uri: Optional[str] = None
-    """URL of the client's terms of service"""
+__all__ = ["OAuthClientUpdateResponse"]
 
 
 class OAuthClientUpdateResponse(BaseModel):
-    data: Optional[Data] = None
+    data: Optional[OAuthClient] = None

telnyx/types/oauth_grant.py

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["OAuthGrant"]
+
+
+class OAuthGrant(BaseModel):
+    id: str
+    """Unique identifier for the OAuth grant"""
+
+    client_id: str
+    """OAuth client identifier"""
+
+    created_at: datetime
+    """Timestamp when the grant was created"""
+
+    record_type: Literal["oauth_grant"]
+    """Record type identifier"""
+
+    scopes: List[str]
+    """List of granted OAuth scopes"""
+
+    last_used_at: Optional[datetime] = None
+    """Timestamp when the grant was last used"""