late-sdk 0.0.831 → 0.0.833

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ee3491c75b179ff9884371bf65a75b2fa566f255cb0f5f6408b5240c2e2a999
-  data.tar.gz: 6b77fd1151ad5e66428a139f1d6cd63894b423777fd65971c0d48d9c0ceec38a
+  metadata.gz: f4e50ad88580b0384b74e9e6d81f30de09a8733d791ce399e2999f25551d2d1e
+  data.tar.gz: 2cc8206621298cdb44c2cb87f4a82dfc0781556492b318bc9bbd4f97e402bcc8
 SHA512:
-  metadata.gz: 324113959387117c71cf8e506246df841a78f60200219d60beb99938be0995f7f939a8bd60cd93522e1389bf9aca791ede45b96a302ec1be0f7cb5ab7a1bbbcb
-  data.tar.gz: b49be07900c9ba3603951602b4e5b69206cc2a9bd34b42b82e3b7ffa2bf3a1746b330f4c4fc0468f407b0fe6bb1e3072a44bba226daf9787cae3ca3b05238399
+  metadata.gz: a8202c500aeacefc3118008620a7c6fe911b1e397d7ce42b53bb1985d47bc9b96a821869ee8669065404355b2ac0640e2badade444b792cd2d98ee6b125d7711
+  data.tar.gz: 4304660e353ac16f22c09f7a8c8c425580e5740a2d2b0859e5064346124d207bf8c8a5f6859219c9ce1711dab2973a80ad7018cb1a5e62e9e524522b4e9fe2b0

data/docs/AdTreeAdSet.md

@@ -19,7 +19,7 @@
 | **cost_type** | **String** | LinkedIn only. Effective cost model (billing event) of the LinkedIn campaign backing this ad set: CPM, CPC or CPV. Null for non-LinkedIn ad sets. | [optional] |
 | **serving_statuses** | **Array<String>** | LinkedIn only. Why the LinkedIn campaign backing this ad set is (or is not) delivering. A LinkedIn Campaign maps to this ad-set node, so this is the level where LinkedIn's holds actually apply. Empty means no serving data, [\"RUNNABLE\"] means eligible to serve, anything else is a hold. See the `servingStatuses` field on `Ad` for the known values. | [optional] |
 | **promoted_object** | [**AdTreeAdSetPromotedObject**](AdTreeAdSetPromotedObject.md) |  | [optional] |
-| **ads** | [**Array<Ad>**](Ad.md) | Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`. | [optional] |
+| **ads** | [**Array<Ad>**](Ad.md) | Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`. | [optional] |
 | **daily** | [**Array<AdDailyMetrics>**](AdDailyMetrics.md) | Per-day metric series for this ad set. Present only when `GET /v1/ads/tree` is called with `timeIncrement=1` and `dailyLevel` is `adset` or `ad`. | [optional] |
 
 ## Example

data/docs/ListPhoneNumberCountries200ResponseCountriesInner.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **code** | **String** | ISO 3166-1 alpha-2 | [optional] |
 | **tier** | **Integer** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3. | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
 | **calls_available** | **Boolean** | Regular phone (PSTN) calling on the number, inbound + outbound. Available on every offerable country. | [optional] |
 | **whatsapp_available** | **Boolean** | WhatsApp can be enabled on numbers from this country. | [optional] |

data/docs/ListPhoneNumberCountries200ResponseCountriesInnerTypesInner.md

@@ -7,7 +7,7 @@
 | **number_type** | **String** |  | [optional] |
 | **tier** | **Integer** |  | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number of this type costs per month, in cents. | [optional] |
 | **whatsapp_available** | **Boolean** | Always false for toll_free (WhatsApp does not reliably register toll-free numbers). | [optional] |
 | **sms_available** | **Boolean** |  | [optional] |
 | **calls_available** | **Boolean** |  | [optional] |

data/docs/ListPhoneNumbers200ResponseNumbersInner.md

@@ -10,7 +10,7 @@
 | **status** | **String** |  | [optional] |
 | **registrant_name** | **String** | For regulated numbers, who it's registered for (company or person) — set from the submitted KYC. | [optional] |
 | **telnyx_order_id** | **String** | Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. | [optional] |
-| **monthly_cents** | **Integer** | Per-country monthly price in cents ($2..$25). | [optional] |
+| **monthly_cents** | **Integer** | What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes. | [optional] |
 | **hosted_by_zernio** | **Boolean** | False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them. | [optional] |
 | **sip_trunk_id** | **String** | SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409. | [optional] |
 | **profile_id** | **Object** |  | [optional] |

data/docs/ListWhatsAppNumberCountries200ResponseCountriesInner.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **code** | **String** | ISO 3166-1 alpha-2 | [optional] |
 | **tier** | **Integer** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3. | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
 | **outbound_calling_available** | **Boolean** |  | [optional] |
 

data/docs/PhoneNumbersApi.md

@@ -1149,7 +1149,7 @@ end
 
 Purchase phone number
 
-Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 

data/docs/WhatsAppPhoneNumbersApi.md

@@ -660,7 +660,7 @@ end
 
 Purchase phone number
 
-Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 

data/lib/zernio-sdk/api/phone_numbers_api.rb

@@ -1065,7 +1065,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchasePhoneNumber200Response]
@@ -1075,7 +1075,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchasePhoneNumber200Response, Integer, Hash)>] PurchasePhoneNumber200Response data, response status code and response headers

data/lib/zernio-sdk/api/whats_app_phone_numbers_api.rb

@@ -621,7 +621,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchaseWhatsAppPhoneNumber200Response]
@@ -631,7 +631,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchaseWhatsAppPhoneNumber200Response, Integer, Hash)>] PurchaseWhatsAppPhoneNumber200Response data, response status code and response headers

data/lib/zernio-sdk/models/ad_tree_ad_set.rb

@@ -53,7 +53,7 @@ module Zernio
 
     attr_accessor :promoted_object
 
-    # Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+    # Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
     attr_accessor :ads
 
     # Per-day metric series for this ad set. Present only when `GET /v1/ads/tree` is called with `timeIncrement=1` and `dailyLevel` is `adset` or `ad`.

data/lib/zernio-sdk/models/list_phone_number_countries200_response_countries_inner.rb

@@ -20,6 +20,7 @@ module Zernio
 
     attr_accessor :tier
 
+    # Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3.
     attr_accessor :monthly_cents
 
     attr_accessor :needs_kyc

data/lib/zernio-sdk/models/list_phone_number_countries200_response_countries_inner_types_inner.rb

@@ -21,6 +21,7 @@ module Zernio
 
     attr_accessor :needs_kyc
 
+    # Price a NEW number of this type costs per month, in cents.
     attr_accessor :monthly_cents
 
     # Always false for toll_free (WhatsApp does not reliably register toll-free numbers).

data/lib/zernio-sdk/models/list_phone_numbers200_response_numbers_inner.rb

@@ -29,7 +29,7 @@ module Zernio
     # Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review.
     attr_accessor :telnyx_order_id
 
-    # Per-country monthly price in cents ($2..$25).
+    # What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes.
     attr_accessor :monthly_cents
 
     # False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them.

data/lib/zernio-sdk/models/list_whats_app_number_countries200_response_countries_inner.rb

@@ -20,6 +20,7 @@ module Zernio
 
     attr_accessor :tier
 
+    # Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3.
     attr_accessor :monthly_cents
 
     attr_accessor :needs_kyc

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.831'
+  VERSION = '0.0.833'
 end

data/openapi.yaml

@@ -8934,7 +8934,7 @@ components:
         ads:
           type: array
           items: { $ref: '#/components/schemas/Ad' }
-          description: "Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`."
+          description: "Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`."
         daily:
           type: array
           items: { $ref: '#/components/schemas/AdDailyMetrics' }
@@ -33947,7 +33947,7 @@ paths:
                         status: { type: string, enum: [pending_payment, pending_regulatory, regulatory_declined, provisioning, verifying, active, suspended, releasing, released] }
                         registrantName: { type: [string, "null"], description: "For regulated numbers, who it's registered for (company or person) — set from the submitted KYC." }
                         telnyxOrderId: { type: [string, "null"], description: Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. }
-                        monthlyCents: { type: integer, description: Per-country monthly price in cents ($2..$25). }
+                        monthlyCents: { type: integer, description: "What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes." }
                         hostedByZernio: { type: boolean, description: "False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them." }
                         sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
                         profileId: { type: object }
@@ -34097,6 +34097,10 @@ paths:
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
 
+        The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that
+        country and `numberType` at the time of purchase, and it is stamped on the number:
+        later rate-card changes never move a number you already own.
+
         Requires usage-based billing (the Usage plan). The maximum number of phone numbers
         is determined by the user's plan.
       security:
@@ -34299,7 +34303,7 @@ paths:
                       properties:
                         code: { type: string, description: ISO 3166-1 alpha-2 }
                         tier: { type: integer, enum: [1, 2, 3, 4] }
-                        monthlyCents: { type: integer }
+                        monthlyCents: { type: integer, description: "Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3." }
                         needsKyc: { type: boolean }
                         callsAvailable: { type: boolean, description: "Regular phone (PSTN) calling on the number, inbound + outbound. Available on every offerable country." }
                         whatsappAvailable: { type: boolean, description: WhatsApp can be enabled on numbers from this country. }
@@ -34320,7 +34324,7 @@ paths:
                               numberType: { type: string, enum: [local, mobile, national, toll_free] }
                               tier: { type: integer, enum: [1, 2, 3, 4] }
                               needsKyc: { type: boolean }
-                              monthlyCents: { type: integer }
+                              monthlyCents: { type: integer, description: "Price a NEW number of this type costs per month, in cents." }
                               whatsappAvailable: { type: boolean, description: "Always false for toll_free (WhatsApp does not reliably register toll-free numbers)." }
                               smsAvailable: { type: boolean }
                               callsAvailable: { type: boolean }
@@ -34491,7 +34495,7 @@ paths:
                         status: { type: string, enum: [pending_payment, pending_regulatory, regulatory_declined, provisioning, verifying, active, suspended, releasing, released] }
                         registrantName: { type: [string, "null"], description: "For regulated numbers, who it's registered for (company or person) — set from the submitted KYC." }
                         telnyxOrderId: { type: [string, "null"], description: Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. }
-                        monthlyCents: { type: integer, description: Per-country monthly price in cents ($2..$25). }
+                        monthlyCents: { type: integer, description: "What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes." }
                         hostedByZernio: { type: boolean, description: "False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them." }
                         sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
                         profileId: { type: object }
@@ -34557,6 +34561,10 @@ paths:
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
 
+        The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that
+        country and `numberType` at the time of purchase, and it is stamped on the number:
+        later rate-card changes never move a number you already own.
+
         Requires usage-based billing (the Usage plan). The maximum number of phone numbers
         is determined by the user's plan.
       security:
@@ -34700,7 +34708,7 @@ paths:
                       properties:
                         code: { type: string, description: ISO 3166-1 alpha-2 }
                         tier: { type: integer, enum: [1, 2, 3, 4] }
-                        monthlyCents: { type: integer }
+                        monthlyCents: { type: integer, description: "Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3." }
                         needsKyc: { type: boolean }
                         outboundCallingAvailable: { type: boolean }
         '401': { $ref: '#/components/responses/Unauthorized' }

data/spec/api/phone_numbers_api_spec.rb

@@ -226,7 +226,7 @@ describe 'PhoneNumbersApi' do
 
   # unit tests for purchase_phone_number
   # Purchase phone number
-  # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchasePhoneNumber200Response]

data/spec/api/whats_app_phone_numbers_api_spec.rb

@@ -146,7 +146,7 @@ describe 'WhatsAppPhoneNumbersApi' do
 
   # unit tests for purchase_whats_app_phone_number
   # Purchase phone number
-  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_whats_app_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchaseWhatsAppPhoneNumber200Response]