zernio-sdk 1.4.330__tar.gz → 1.4.332__tar.gz

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zernio-sdk
-Version: 1.4.330
+Version: 1.4.332
 Summary: The official Python library for the Zernio API
 Project-URL: Homepage, https://zernio.com
 Project-URL: Documentation, https://docs.zernio.com
@@ -459,6 +459,7 @@ Both `from zernio import ...` and `from late import ...` work identically. The `
 | Method | Description |
 |--------|-------------|
 | `ad_campaigns.list_ad_campaigns()` | List campaigns |
+| `ad_campaigns.list_ad_keywords()` | List Search keywords |
 | `ad_campaigns.list_ads()` | List ads |
 | `ad_campaigns.bulk_update_ad_campaign_status()` | Pause or resume many campaigns |
 | `ad_campaigns.create_ad_campaign()` | Create a standalone campaign |

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/README.md

@@ -406,6 +406,7 @@ Both `from zernio import ...` and `from late import ...` work identically. The `
 | Method | Description |
 |--------|-------------|
 | `ad_campaigns.list_ad_campaigns()` | List campaigns |
+| `ad_campaigns.list_ad_keywords()` | List Search keywords |
 | `ad_campaigns.list_ads()` | List ads |
 | `ad_campaigns.bulk_update_ad_campaign_status()` | Pause or resume many campaigns |
 | `ad_campaigns.create_ad_campaign()` | Create a standalone campaign |

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/openapi.yaml

@@ -27899,6 +27899,17 @@ paths:
                     connect WhatsApp (400 when combined with
                     connectWhatsapp:true), and wantsSms:true requires an
                     SMS-capable type.
+                areaCode:
+                  type: string
+                  pattern: '^\d{1,4}$'
+                  description: >
+                    Area code (national destination code, e.g. 11 for Sao
+                    Paulo) the number must be in. Hard constraint: when the
+                    area has no deliverable inventory the purchase fails with
+                    409 code AREA_CODE_UNAVAILABLE instead of assigning a
+                    number from another area, and later replacements stay in
+                    this area too. Omit for any area. Get live options from
+                    GET /v1/phone-numbers/availability (areaOptions).
                 connectWhatsapp:
                   type: boolean
                   default: true
@@ -27990,16 +28001,18 @@ paths:
         '403': { description: A paid plan is required }
         '409':
           description: >
-            Duplicate-purchase protection: another number was purchased for
-            this user within the last 10 minutes. Retry with allowMultiple:
-            true to confirm the additional purchase is intentional.
+            Either duplicate-purchase protection (code PURCHASE_VELOCITY:
+            another number was purchased within the last 10 minutes; retry
+            with allowMultiple: true to confirm), or the requested areaCode
+            has no deliverable inventory right now (code
+            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode).
           content:
             application/json:
               schema:
                 type: object
                 properties:
                   error: { type: string }
-                  code: { type: string, enum: [PURCHASE_VELOCITY] }
+                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE] }
         '202':
           description: Country requires end-user KYC before the number can be ordered.
           content:
@@ -28132,6 +28145,7 @@ paths:
       parameters:
         - { name: country, in: query, required: true, schema: { type: string }, description: ISO-2 country code. }
         - { name: numberType, in: query, required: false, schema: { type: string, enum: [local, mobile, national, toll_free] }, description: "Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type." }
+        - { name: sms, in: query, required: false, schema: { type: boolean }, description: 'Pass true when the buyer wants SMS: availability, areas, and areaOptions then describe the SMS-capable pool (an SMS purchase orders from it), not the wider voice-only pool.' }
       responses:
         '200':
           description: Availability + address constraint.
@@ -28148,6 +28162,20 @@ paths:
                     type: array
                     description: For `geo` only — the area(s) the registered address must be in.
                     items: { type: string }
+                  areaOptions:
+                    type: array
+                    description: >
+                      Live inventory grouped by area code, largest stock
+                      first. Empty when out of stock (or the area lookup
+                      failed). Pass a chosen `ndc` as `areaCode` on POST
+                      /v1/phone-numbers/purchase (or on the KYC submit for
+                      regulated countries) to require that area.
+                    items:
+                      type: object
+                      properties:
+                        ndc: { type: string, description: 'Area code (national destination code), e.g. "11".' }
+                        name: { type: string, description: 'Human-readable area name, e.g. "Sao Paulo".' }
+                        count: { type: integer, description: Deliverable numbers seen in this area on the latest inventory page. }
         '400': { description: Country not offerable }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
@@ -28356,16 +28384,18 @@ paths:
         '403': { description: A paid plan is required }
         '409':
           description: >
-            Duplicate-purchase protection: another number was purchased for
-            this user within the last 10 minutes. Retry with allowMultiple:
-            true to confirm the additional purchase is intentional.
+            Either duplicate-purchase protection (code PURCHASE_VELOCITY:
+            another number was purchased within the last 10 minutes; retry
+            with allowMultiple: true to confirm), or the requested areaCode
+            has no deliverable inventory right now (code
+            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode).
           content:
             application/json:
               schema:
                 type: object
                 properties:
                   error: { type: string }
-                  code: { type: string, enum: [PURCHASE_VELOCITY] }
+                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE] }
         '202':
           description: Country requires end-user KYC before the number can be ordered.
           content:
@@ -28481,6 +28511,7 @@ paths:
       parameters:
         - { name: country, in: query, required: true, schema: { type: string }, description: ISO-2 country code. }
         - { name: numberType, in: query, required: false, schema: { type: string, enum: [local, mobile, national, toll_free] }, description: "Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type." }
+        - { name: sms, in: query, required: false, schema: { type: boolean }, description: 'Pass true when the buyer wants SMS: availability, areas, and areaOptions then describe the SMS-capable pool (an SMS purchase orders from it), not the wider voice-only pool.' }
       responses:
         '200':
           description: Availability + address constraint.
@@ -28497,6 +28528,20 @@ paths:
                     type: array
                     description: For `geo` only — the area(s) the registered address must be in.
                     items: { type: string }
+                  areaOptions:
+                    type: array
+                    description: >
+                      Live inventory grouped by area code, largest stock
+                      first. Empty when out of stock (or the area lookup
+                      failed). Pass a chosen `ndc` as `areaCode` on POST
+                      /v1/phone-numbers/purchase (or on the KYC submit for
+                      regulated countries) to require that area.
+                    items:
+                      type: object
+                      properties:
+                        ndc: { type: string, description: 'Area code (national destination code), e.g. "11".' }
+                        name: { type: string, description: 'Human-readable area name, e.g. "Sao Paulo".' }
+                        count: { type: integer, description: Deliverable numbers seen in this area on the latest inventory page. }
         '400': { description: Country not offerable }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
@@ -28607,6 +28652,7 @@ paths:
                 reuse: { type: boolean, description: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). }
                 reuseOptionId: { type: string, description: 'Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.' }
                 reuseFrom: { type: string, description: 'Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.' }
+                areaCode: { type: string, pattern: '^\d{1,4}$', description: 'Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.' }
                 endUserFirstName: { type: string, description: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. }
                 endUserLastName: { type: string, description: End user's legal last name. Same condition as endUserFirstName. }
                 values:
@@ -28668,7 +28714,7 @@ paths:
                         phoneNumber: { type: string }
                         country: { type: string }
         '400': { description: "Validation error (e.g. address not in-country, file too large)" }
-        '409': { description: reuse requested but no prior approved verification exists for this country }
+        '409': { description: 'Either reuse was requested but no prior approved verification exists for this country, or the requested areaCode has no deliverable inventory right now (code: area_code_unavailable; pick another area and resubmit).' }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
   /v1/phone-numbers/kyc/document/{documentId}:
@@ -28831,6 +28877,7 @@ paths:
               properties:
                 profileId: { type: string }
                 country: { type: string, minLength: 2, maxLength: 2, description: ISO 3166-1 alpha-2 country code (must be a regulated/KYC country). }
+                areaCode: { type: string, pattern: '^\d{1,4}$', description: 'Area code (NDC) the eventual number must be in. Hard constraint carried by the link; the end customer filling the form makes no area choice. Options come from GET /v1/phone-numbers/availability (areaOptions).' }
                 branding:
                   type: object
                   description: Optional white-label of the hosted page the end customer sees.
@@ -29577,6 +29624,7 @@ paths:
                 reuse: { type: boolean, description: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). }
                 reuseOptionId: { type: string, description: 'Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.' }
                 reuseFrom: { type: string, description: 'Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.' }
+                areaCode: { type: string, pattern: '^\d{1,4}$', description: 'Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.' }
                 endUserFirstName: { type: string, description: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. }
                 endUserLastName: { type: string, description: End user's legal last name. Same condition as endUserFirstName. }
                 values:
@@ -29638,7 +29686,7 @@ paths:
                         phoneNumber: { type: string }
                         country: { type: string }
         '400': { description: "Validation error (e.g. address not in-country, file too large)" }
-        '409': { description: reuse requested but no prior approved verification exists for this country }
+        '409': { description: 'Either reuse was requested but no prior approved verification exists for this country, or the requested areaCode has no deliverable inventory right now (code: area_code_unavailable; pick another area and resubmit).' }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
   /v1/whatsapp/phone-numbers/kyc/upload-document:
@@ -29785,6 +29833,7 @@ paths:
               properties:
                 profileId: { type: string }
                 country: { type: string, minLength: 2, maxLength: 2, description: ISO 3166-1 alpha-2 country code (must be a regulated/KYC country). }
+                areaCode: { type: string, pattern: '^\d{1,4}$', description: 'Area code (NDC) the eventual number must be in. Hard constraint carried by the link; the end customer filling the form makes no area choice. Options come from GET /v1/phone-numbers/availability (areaOptions).' }
                 branding:
                   type: object
                   description: Optional white-label of the hosted page the end customer sees.
@@ -33662,6 +33711,67 @@ paths:
         '403':
           description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
 
+  /v1/ads/keywords:
+    get:
+      operationId: listAdKeywords
+      tags: ["Ad Campaigns"]
+      x-platforms: ["google"]
+      summary: List Search keywords
+      description: |
+        Returns the Google Search keyword criteria (positive and negative) synced from
+        connected Google Ads accounts, one row per ad-group keyword. Populated by the
+        periodic ads discovery sweep (roughly every 3 hours per account), so keywords
+        added on Google appear with that delay. Campaign-level negative keywords are
+        not included; only ad-group-level criteria are.
+      security:
+        - bearerAuth: []
+      parameters:
+        - $ref: '#/components/parameters/PageParam'
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 500, default: 50 } }
+        - { name: accountId, in: query, schema: { type: string }, description: Social account ID }
+        - { name: adAccountId, in: query, schema: { type: string }, description: 'Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.' }
+        - { name: profileId, in: query, schema: { type: string }, description: Profile ID }
+        - { name: campaignId, in: query, schema: { type: string }, description: Platform campaign ID }
+        - { name: adSetId, in: query, schema: { type: string }, description: 'Platform ad group ID (Google ad group)' }
+        - { name: status, in: query, schema: { type: string, enum: [active, paused] }, description: Keyword criterion status }
+        - { name: matchType, in: query, schema: { type: string, enum: [exact, phrase, broad, unknown] } }
+        - { name: negative, in: query, schema: { type: boolean }, description: 'true = negative keywords only, false = positive only. Omit for both.' }
+        - { name: search, in: query, schema: { type: string, maxLength: 200 }, description: 'Case-insensitive substring match on the keyword text' }
+      responses:
+        '200':
+          description: Paginated keywords
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  keywords:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string }
+                        accountId: { type: string, description: Social account ID owning the sync }
+                        profileId: { type: string }
+                        platform: { type: string, enum: [google] }
+                        adAccountId: { type: string, description: Google customer ID }
+                        campaignId: { type: string }
+                        campaignName: { type: [string, "null"] }
+                        campaignStatus: { type: [string, "null"] }
+                        adSetId: { type: string, description: Google ad group ID }
+                        adSetName: { type: [string, "null"] }
+                        adSetStatus: { type: [string, "null"] }
+                        keyword: { type: string }
+                        matchType: { type: string, enum: [exact, phrase, broad, unknown] }
+                        status: { type: string, enum: [active, paused] }
+                        negative: { type: boolean }
+                        syncedAt: { type: [string, "null"], format: date-time }
+                  pagination: { $ref: '#/components/schemas/Pagination' }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+
   /v1/ads/campaigns:
     get:
       operationId: listAdCampaigns

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "zernio-sdk"
-version = "1.4.330"
+version = "1.4.332"
 description = "The official Python library for the Zernio API"
 readme = "README.md"
 requires-python = ">=3.10"

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/src/late/__init__.py

@@ -42,7 +42,7 @@ from .enums import (
     Visibility,
 )
 
-__version__ = "1.4.330"
+__version__ = "1.4.332"
 
 __all__ = [
     # Client

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/src/late/mcp/generated_tools.py

@@ -1777,6 +1777,60 @@ def register_generated_tools(mcp, _get_client):
         except Exception as e:
             return f"Error: {e}"
 
+    @mcp.tool(
+        annotations=ToolAnnotations(
+            title="List Search keywords",
+            readOnlyHint=True,
+            destructiveHint=False,
+            openWorldHint=False,
+        )
+    )
+    def ad_campaigns_list_ad_keywords(
+        page: int = 1,
+        limit: int = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> str:
+        """List Search keywords
+
+        Args:
+            page: Page number
+            limit
+            account_id: Social account ID
+            ad_account_id: Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.
+            profile_id: Profile ID
+            campaign_id: Platform campaign ID
+            ad_set_id: Platform ad group ID (Google ad group)
+            status: Keyword criterion status
+            match_type
+            negative: true = negative keywords only, false = positive only. Omit for both.
+            search: Case-insensitive substring match on the keyword text"""
+        client = _get_client()
+        try:
+            response = client.ad_campaigns.list_ad_keywords(
+                page=page,
+                limit=limit,
+                account_id=account_id,
+                ad_account_id=ad_account_id,
+                profile_id=profile_id,
+                campaign_id=campaign_id,
+                ad_set_id=ad_set_id,
+                status=status,
+                match_type=match_type,
+                negative=negative,
+                search=search,
+            )
+            return _format_response(response)
+        except Exception as e:
+            return f"Error: {e}"
+
     @mcp.tool(
         annotations=ToolAnnotations(
             title="List campaigns",
@@ -10187,6 +10241,7 @@ def register_generated_tools(mcp, _get_client):
         profile_id: str,
         country: str = "US",
         number_type: str | None = None,
+        area_code: str | None = None,
         connect_whatsapp: bool = True,
         wants_sms: bool = False,
         wants_whatsapp: bool = False,
@@ -10199,6 +10254,7 @@ def register_generated_tools(mcp, _get_client):
             profile_id: Profile to associate the number with (required)
             country: ISO 3166-1 alpha-2 country for the number (default US). International numbers require usage-based billing. Tier 3/4 countries return 202 { status: "kyc_required", kycUrl } — the customer must complete KYC at that URL before the number is ordered. See GET /v1/phone-numbers/countries.
             number_type: Which of the country's offered number types to order (see `types[]` on GET /v1/phone-numbers/countries). Omitted = the country's default type, which is always the WhatsApp-safe choice. Capabilities, price, and KYC requirements are per (country, type): toll_free can never connect WhatsApp (400 when combined with connectWhatsapp:true), and wantsSms:true requires an SMS-capable type.
+            area_code: Area code (national destination code, e.g. 11 for Sao Paulo) the number must be in. Hard constraint: when the area has no deliverable inventory the purchase fails with 409 code AREA_CODE_UNAVAILABLE instead of assigning a number from another area, and later replacements stay in this area too. Omit for any area. Get live options from GET /v1/phone-numbers/availability (areaOptions).
             connect_whatsapp: A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow.
             wants_sms: SMS capability is per-number, not per-country. Pass true to provision from the SMS-capable inventory pool so the number can actually text (see also GET /v1/phone-numbers/available with sms=true, and smsAvailable on GET /v1/phone-numbers/countries).
             wants_whatsapp: Declare WhatsApp intent on a STANDALONE purchase (connectWhatsapp:false). The number still activates and bills immediately, but if WhatsApp's buy-time check rejects the assigned number, it is automatically swapped for a WhatsApp-eligible one during the purchase instead of being delivered with WhatsApp unavailable. Ignored on the WhatsApp provisioning path (connectWhatsapp omitted or true), which always delivers a WhatsApp-verified number.
@@ -10210,6 +10266,7 @@ def register_generated_tools(mcp, _get_client):
                 profile_id=profile_id,
                 country=country,
                 number_type=number_type,
+                area_code=area_code,
                 connect_whatsapp=connect_whatsapp,
                 wants_sms=wants_sms,
                 wants_whatsapp=wants_whatsapp,
@@ -10288,17 +10345,18 @@ def register_generated_tools(mcp, _get_client):
         )
     )
     def phone_numbers_check_phone_number_availability(
-        country: str, number_type: str | None = None
+        country: str, number_type: str | None = None, sms: bool | None = None
     ) -> str:
         """Check country availability
 
         Args:
             country: ISO-2 country code. (required)
-            number_type: Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type."""
+            number_type: Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type.
+            sms: Pass true when the buyer wants SMS: availability, areas, and areaOptions then describe the SMS-capable pool (an SMS purchase orders from it), not the wider voice-only pool."""
         client = _get_client()
         try:
             response = client.phone_numbers.check_phone_number_availability(
-                country=country, number_type=number_type
+                country=country, number_type=number_type, sms=sms
             )
             return _format_response(response)
         except Exception as e:
@@ -10345,6 +10403,7 @@ def register_generated_tools(mcp, _get_client):
         reuse: bool | None = None,
         reuse_option_id: str | None = None,
         reuse_from: str | None = None,
+        area_code: str | None = None,
         end_user_first_name: str | None = None,
         end_user_last_name: str | None = None,
         values: dict[str, Any] | None = None,
@@ -10361,6 +10420,7 @@ def register_generated_tools(mcp, _get_client):
             reuse: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
             reuse_option_id: Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
             reuse_from: Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
+            area_code: Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
             end_user_first_name: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
             end_user_last_name: End user's legal last name. Same condition as endUserFirstName.
             values: requirementId → textual value
@@ -10376,6 +10436,7 @@ def register_generated_tools(mcp, _get_client):
                 reuse=reuse,
                 reuse_option_id=reuse_option_id,
                 reuse_from=reuse_from,
+                area_code=area_code,
                 end_user_first_name=end_user_first_name,
                 end_user_last_name=end_user_last_name,
                 values=values,
@@ -10472,6 +10533,7 @@ def register_generated_tools(mcp, _get_client):
     def phone_numbers_create_phone_number_kyc_link(
         profile_id: str,
         country: str,
+        area_code: str | None = None,
         branding: dict[str, Any] | None = None,
         redirect_url: str | None = None,
     ) -> str:
@@ -10480,6 +10542,7 @@ def register_generated_tools(mcp, _get_client):
             Args:
                 profile_id: (required)
                 country: ISO 3166-1 alpha-2 country code (must be a regulated/KYC country). (required)
+                area_code: Area code (NDC) the eventual number must be in. Hard constraint carried by the link; the end customer filling the form makes no area choice. Options come from GET /v1/phone-numbers/availability (areaOptions).
                 branding: Optional white-label of the hosted page the end customer sees.
                 redirect_url: Where to send the end customer's browser after a successful
         submit. On completion Zernio appends `kyc=submitted` and
@@ -10490,6 +10553,7 @@ def register_generated_tools(mcp, _get_client):
             response = client.phone_numbers.create_phone_number_kyc_link(
                 profile_id=profile_id,
                 country=country,
+                area_code=area_code,
                 branding=branding,
                 redirect_url=redirect_url,
             )
@@ -15819,18 +15883,19 @@ def register_generated_tools(mcp, _get_client):
         )
     )
     def whatsapp_phone_numbers_check_whats_app_number_availability(
-        country: str, number_type: str | None = None
+        country: str, number_type: str | None = None, sms: bool | None = None
     ) -> str:
         """Check country availability
 
         Args:
             country: ISO-2 country code. (required)
-            number_type: Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type."""
+            number_type: Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type.
+            sms: Pass true when the buyer wants SMS: availability, areas, and areaOptions then describe the SMS-capable pool (an SMS purchase orders from it), not the wider voice-only pool."""
         client = _get_client()
         try:
             response = (
                 client.whatsapp_phone_numbers.check_whats_app_number_availability(
-                    country=country, number_type=number_type
+                    country=country, number_type=number_type, sms=sms
                 )
             )
             return _format_response(response)
@@ -15878,6 +15943,7 @@ def register_generated_tools(mcp, _get_client):
         reuse: bool | None = None,
         reuse_option_id: str | None = None,
         reuse_from: str | None = None,
+        area_code: str | None = None,
         end_user_first_name: str | None = None,
         end_user_last_name: str | None = None,
         values: dict[str, Any] | None = None,
@@ -15894,6 +15960,7 @@ def register_generated_tools(mcp, _get_client):
             reuse: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
             reuse_option_id: Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
             reuse_from: Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
+            area_code: Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
             end_user_first_name: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
             end_user_last_name: End user's legal last name. Same condition as endUserFirstName.
             values: requirementId → textual value
@@ -15909,6 +15976,7 @@ def register_generated_tools(mcp, _get_client):
                 reuse=reuse,
                 reuse_option_id=reuse_option_id,
                 reuse_from=reuse_from,
+                area_code=area_code,
                 end_user_first_name=end_user_first_name,
                 end_user_last_name=end_user_last_name,
                 values=values,
@@ -15987,6 +16055,7 @@ def register_generated_tools(mcp, _get_client):
     def whatsapp_phone_numbers_create_whats_app_number_kyc_link(
         profile_id: str,
         country: str,
+        area_code: str | None = None,
         branding: dict[str, Any] | None = None,
         redirect_url: str | None = None,
     ) -> str:
@@ -15995,6 +16064,7 @@ def register_generated_tools(mcp, _get_client):
             Args:
                 profile_id: (required)
                 country: ISO 3166-1 alpha-2 country code (must be a regulated/KYC country). (required)
+                area_code: Area code (NDC) the eventual number must be in. Hard constraint carried by the link; the end customer filling the form makes no area choice. Options come from GET /v1/phone-numbers/availability (areaOptions).
                 branding: Optional white-label of the hosted page the end customer sees.
                 redirect_url: Where to send the end customer's browser after a successful
         submit. On completion Zernio appends `kyc=submitted` and
@@ -16005,6 +16075,7 @@ def register_generated_tools(mcp, _get_client):
             response = client.whatsapp_phone_numbers.create_whats_app_number_kyc_link(
                 profile_id=profile_id,
                 country=country,
+                area_code=area_code,
                 branding=branding,
                 redirect_url=redirect_url,
             )

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/src/late/models/_generated/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   timestamp: 2026-07-24T16:38:10+00:00
+#   timestamp: 2026-07-27T09:31:44+00:00
 
 from __future__ import annotations
 

{zernio_sdk-1.4.330 → zernio_sdk-1.4.332}/src/late/resources/_generated/ad_campaigns.py

@@ -93,6 +93,37 @@ class AdCampaignsResource:
         )
         return self._client._get("/v1/ads", params=params)
 
+    def list_ad_keywords(
+        self,
+        *,
+        page: int | None = 1,
+        limit: int | None = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> dict[str, Any]:
+        """List Search keywords"""
+        params = self._build_params(
+            page=page,
+            limit=limit,
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+            profile_id=profile_id,
+            campaign_id=campaign_id,
+            ad_set_id=ad_set_id,
+            status=status,
+            match_type=match_type,
+            negative=negative,
+            search=search,
+        )
+        return self._client._get("/v1/ads/keywords", params=params)
+
     def list_ad_campaigns(
         self,
         *,
@@ -670,6 +701,37 @@ class AdCampaignsResource:
         )
         return await self._client._aget("/v1/ads", params=params)
 
+    async def alist_ad_keywords(
+        self,
+        *,
+        page: int | None = 1,
+        limit: int | None = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> dict[str, Any]:
+        """List Search keywords (async)"""
+        params = self._build_params(
+            page=page,
+            limit=limit,
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+            profile_id=profile_id,
+            campaign_id=campaign_id,
+            ad_set_id=ad_set_id,
+            status=status,
+            match_type=match_type,
+            negative=negative,
+            search=search,
+        )
+        return await self._client._aget("/v1/ads/keywords", params=params)
+
     async def alist_ad_campaigns(
         self,
         *,