@stigg/typescript 0.1.0-alpha.2 → 0.1.0-alpha.21

package/resources/v1/subscriptions/subscriptions.d.ts

@@ -1,159 +1,82 @@
 import { APIResource } from "../../../core/resource.js";
 import * as FutureUpdateAPI from "./future-update.js";
-import { FutureUpdate, FutureUpdateCancelPendingPaymentResponse, FutureUpdateCancelScheduleResponse } from "./future-update.js";
+import { CancelSubscription, FutureUpdate as FutureUpdateAPIFutureUpdate } from "./future-update.js";
+import * as InvoiceAPI from "./invoice.js";
+import { Invoice, InvoiceMarkAsPaidResponse } from "./invoice.js";
+import * as UsageAPI from "./usage.js";
+import { Usage, UsageChargeUsageParams, UsageChargeUsageResponse, UsageSyncResponse } from "./usage.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.js";
 import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Subscriptions extends APIResource {
     futureUpdate: FutureUpdateAPI.FutureUpdate;
+    usage: UsageAPI.Usage;
+    invoice: InvoiceAPI.Invoice;
     /**
-     * Create a new Subscription
+     * Retrieves a subscription by its unique identifier, including plan details,
+     * billing period, status, and add-ons.
      */
-    create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
+    retrieve(id: string, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a single Subscription by id
+     * Updates an active subscription's properties including billing period, add-ons,
+     * unit quantities, and discounts.
      */
-    retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
+    update(id: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a list of Subscriptions
+     * Retrieves a paginated list of subscriptions, with optional filters for customer,
+     * status, and plan.
      */
     list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse>;
     /**
-     * Perform delegate on a Subscription
+     * Cancels an active subscription, either immediately or at a specified time such
+     * as end of billing period.
      */
-    delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<SubscriptionDelegateResponse>;
+    cancel(id: string, body: SubscriptionCancelParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Perform migrate to latest plan version on a Subscription
+     * Delegates the payment responsibility of a subscription to a different customer.
+     * The delegated customer will be billed for this subscription.
      */
-    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<SubscriptionMigrateResponse>;
+    delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Create a new Subscription Preview
+     * Imports multiple subscriptions in bulk. Used for migrating subscription data
+     * from external systems.
+     */
+    import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse>;
+    /**
+     * Migrates a subscription to the latest published version of its plan or add-ons.
+     * Handles prorated charges or credits automatically.
+     */
+    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription>;
+    /**
+     * Previews the pricing impact of creating or updating a subscription without
+     * making changes. Returns estimated costs, taxes, and proration details.
      */
     preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
     /**
-     * Perform transfer to resource on a Subscription
+     * Creates a new subscription for an existing customer. When payment is required
+     * and no payment method exists, returns a checkout URL.
      */
-    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<SubscriptionTransferResponse>;
+    provision(body: SubscriptionProvisionParams, options?: RequestOptions): APIPromise<SubscriptionProvisionResponse>;
+    /**
+     * Transfers a subscription to a different resource ID. Used for multi-resource
+     * products where subscriptions apply to specific entities like websites or apps.
+     */
+    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<Subscription>;
 }
 export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
-export interface SubscriptionCreateResponse {
-    data: SubscriptionCreateResponse.Data;
-}
-export declare namespace SubscriptionCreateResponse {
-    interface Data {
-        /**
-         * Unique identifier for the provisioned subscription
-         */
-        id: string;
-        /**
-         * Provision status: SUCCESS or PAYMENT_REQUIRED
-         */
-        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
-        /**
-         * Checkout billing ID when payment is required
-         */
-        checkoutBillingId?: string | null;
-        /**
-         * URL to complete payment when PAYMENT_REQUIRED
-         */
-        checkoutUrl?: string | null;
-        /**
-         * Whether the subscription is scheduled for future activation
-         */
-        isScheduled?: boolean;
-        subscription?: Data.Subscription;
-    }
-    namespace Data {
-        interface Subscription {
-            /**
-             * Subscription ID
-             */
-            id: string;
-            /**
-             * Billing ID
-             */
-            billingId: string | null;
-            /**
-             * Created at
-             */
-            createdAt: string;
-            /**
-             * Customer ID
-             */
-            customerId: string;
-            /**
-             * Payment collection
-             */
-            paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-            /**
-             * Plan ID
-             */
-            planId: string;
-            /**
-             * Pricing type
-             */
-            pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-            /**
-             * Subscription start date
-             */
-            startDate: string;
-            /**
-             * Subscription status
-             */
-            status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-            /**
-             * Subscription cancellation date
-             */
-            cancellationDate?: string | null;
-            /**
-             * Subscription cancel reason
-             */
-            cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
-            /**
-             * End of the current billing period
-             */
-            currentBillingPeriodEnd?: string | null;
-            /**
-             * Start of the current billing period
-             */
-            currentBillingPeriodStart?: string | null;
-            /**
-             * Subscription effective end date
-             */
-            effectiveEndDate?: string | null;
-            /**
-             * Subscription end date
-             */
-            endDate?: string | null;
-            /**
-             * Additional metadata for the subscription
-             */
-            metadata?: {
-                [key: string]: string;
-            };
-            /**
-             * Paying customer ID for delegated billing
-             */
-            payingCustomerId?: string | null;
-            /**
-             * The method used to collect payments for a subscription
-             */
-            paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-            /**
-             * Resource ID
-             */
-            resourceId?: string | null;
-            /**
-             * Subscription trial end date
-             */
-            trialEndDate?: string | null;
-        }
-    }
-}
-export interface SubscriptionRetrieveResponse {
-    data: SubscriptionRetrieveResponse.Data;
+/**
+ * Response object
+ */
+export interface Subscription {
+    /**
+     * Customer subscription to a plan
+     */
+    data: Subscription.Data;
 }
-export declare namespace SubscriptionRetrieveResponse {
+export declare namespace Subscription {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -191,6 +114,15 @@ export declare namespace SubscriptionRetrieveResponse {
          * Subscription status
          */
         status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        addons?: Array<Data.Addon>;
+        /**
+         * Billing cycle anchor date
+         */
+        billingCycleAnchor?: string | null;
+        /**
+         * Budget configuration
+         */
+        budget?: Data.Budget | null;
         /**
          * Subscription cancellation date
          */
@@ -199,6 +131,10 @@ export declare namespace SubscriptionRetrieveResponse {
          * Subscription cancel reason
          */
         cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        /**
+         * Coupons applied to the subscription
+         */
+        coupons?: Array<Data.Coupon>;
         /**
          * End of the current billing period
          */
@@ -215,12 +151,24 @@ export declare namespace SubscriptionRetrieveResponse {
          * Subscription end date
          */
         endDate?: string | null;
+        /**
+         * Scheduled future updates for the subscription
+         */
+        futureUpdates?: Array<Data.FutureUpdate>;
+        /**
+         * Latest invoice for the subscription
+         */
+        latestInvoice?: Data.LatestInvoice | null;
         /**
          * Additional metadata for the subscription
          */
         metadata?: {
             [key: string]: string;
         };
+        /**
+         * Minimum spend configuration
+         */
+        minimumSpend?: Data.MinimumSpend | null;
         /**
          * Paying customer ID for delegated billing
          */
@@ -229,250 +177,1881 @@ export declare namespace SubscriptionRetrieveResponse {
          * The method used to collect payments for a subscription
          */
         paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
         resourceId?: string | null;
         /**
-         * Subscription trial end date
-         */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionListResponse {
-    /**
-     * Subscription ID
-     */
-    id: string;
-    /**
-     * Billing ID
-     */
-    billingId: string | null;
-    /**
-     * Created at
-     */
-    createdAt: string;
-    /**
-     * Customer ID
-     */
-    customerId: string;
-    /**
-     * Payment collection
-     */
-    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-    /**
-     * Plan ID
-     */
-    planId: string;
-    /**
-     * Pricing type
-     */
-    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-    /**
-     * Subscription start date
-     */
-    startDate: string;
-    /**
-     * Subscription status
-     */
-    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-    /**
-     * Subscription cancellation date
-     */
-    cancellationDate?: string | null;
-    /**
-     * Subscription cancel reason
-     */
-    cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
-    /**
-     * End of the current billing period
-     */
-    currentBillingPeriodEnd?: string | null;
-    /**
-     * Start of the current billing period
-     */
-    currentBillingPeriodStart?: string | null;
-    /**
-     * Subscription effective end date
-     */
-    effectiveEndDate?: string | null;
-    /**
-     * Subscription end date
-     */
-    endDate?: string | null;
-    /**
-     * Additional metadata for the subscription
-     */
-    metadata?: {
-        [key: string]: string;
-    };
-    /**
-     * Paying customer ID for delegated billing
-     */
-    payingCustomerId?: string | null;
-    /**
-     * The method used to collect payments for a subscription
-     */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-    /**
-     * Resource ID
-     */
-    resourceId?: string | null;
-    /**
-     * Subscription trial end date
-     */
-    trialEndDate?: string | null;
-}
-export interface SubscriptionDelegateResponse {
-    data: SubscriptionDelegateResponse.Data;
-}
-export declare namespace SubscriptionDelegateResponse {
-    interface Data {
-        /**
-         * Subscription ID
-         */
-        id: string;
-        /**
-         * Billing ID
+         * Entitlements associated with the subscription
          */
-        billingId: string | null;
+        subscriptionEntitlements?: Array<Data.SubscriptionEntitlement>;
         /**
-         * Created at
+         * Trial configuration
          */
-        createdAt: string;
+        trial?: Data.Trial | null;
         /**
-         * Customer ID
+         * Subscription trial end date
          */
-        customerId: string;
+        trialEndDate?: string | null;
+    }
+    namespace Data {
         /**
-         * Payment collection
+         * Addon configuration
          */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+        interface Addon {
+            /**
+             * Addon ID
+             */
+            id: string;
+            /**
+             * Number of addon instances
+             */
+            quantity: number;
+        }
         /**
-         * Plan ID
+         * Budget configuration
          */
-        planId: string;
+        interface Budget {
+            /**
+             * Whether the budget is a soft limit
+             */
+            hasSoftLimit: boolean;
+            /**
+             * Maximum spending limit
+             */
+            limit: number;
+        }
         /**
-         * Pricing type
+         * Coupon applied to a subscription
          */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-        /**
-         * Subscription start date
+        interface Coupon {
+            /**
+             * Coupon ID
+             */
+            id: string;
+            /**
+             * Coupon name
+             */
+            name: string;
+            /**
+             * Coupon status
+             */
+            status: 'ACTIVE' | 'EXPIRED' | 'REMOVED';
+            /**
+             * Fixed amount discounts by currency
+             */
+            amountsOff?: Array<Coupon.AmountsOff> | null;
+            /**
+             * Percentage discount
+             */
+            percentOff?: number | null;
+        }
+        namespace Coupon {
+            interface AmountsOff {
+                /**
+                 * The price amount
+                 */
+                amount?: number;
+                /**
+                 * The price currency
+                 */
+                currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+        }
+        /**
+         * Scheduled subscription update
+         */
+        interface FutureUpdate {
+            /**
+             * Scheduled execution time
+             */
+            scheduledExecutionTime: string;
+            /**
+             * Status of the scheduled update
+             */
+            scheduleStatus: 'PENDING_PAYMENT' | 'SCHEDULED' | 'CANCELED' | 'DONE' | 'FAILED';
+            /**
+             * Type of scheduled change
+             */
+            subscriptionScheduleType: 'DOWNGRADE' | 'PLAN' | 'BILLING_PERIOD' | 'UNIT_AMOUNT' | 'RECURRING_CREDITS' | 'PRICE_OVERRIDE' | 'ADDON' | 'COUPON' | 'MIGRATE_TO_LATEST' | 'ADDITIONAL_META_DATA' | 'BILLING_INFO_METADATA';
+            /**
+             * Target package for the update
+             */
+            targetPackage?: FutureUpdate.TargetPackage | null;
+        }
+        namespace FutureUpdate {
+            /**
+             * Target package for the update
+             */
+            interface TargetPackage {
+                /**
+                 * Target package for the update
+                 */
+                id: string;
+            }
+        }
+        /**
+         * Latest invoice for the subscription
+         */
+        interface LatestInvoice {
+            /**
+             * Invoice billing ID
+             */
+            billingId: string;
+            /**
+             * Invoice creation date
+             */
+            createdAt: string;
+            /**
+             * Whether payment requires action
+             */
+            requiresAction: boolean;
+            /**
+             * Invoice status
+             */
+            status: 'OPEN' | 'CANCELED' | 'PAID';
+            /**
+             * Amount due
+             */
+            amountDue?: number | null;
+            /**
+             * Billing reason
+             */
+            billingReason?: 'BILLING_CYCLE' | 'SUBSCRIPTION_CREATION' | 'SUBSCRIPTION_UPDATE' | 'MANUAL' | 'MINIMUM_INVOICE_AMOUNT_EXCEEDED' | 'OTHER' | null;
+            /**
+             * Invoice currency
+             */
+            currency?: string | null;
+            /**
+             * Invoice PDF URL
+             */
+            pdfUrl?: string | null;
+            /**
+             * Total amount
+             */
+            total?: number | null;
+        }
+        /**
+         * Minimum spend configuration
+         */
+        interface MinimumSpend {
+            /**
+             * The price amount
+             */
+            amount?: number;
+            /**
+             * The price currency
+             */
+            currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+        }
+        interface Price {
+            /**
+             * Addon identifier for the price override
+             */
+            addonId?: string | null;
+            /**
+             * The price amount
+             */
+            amount?: number;
+            /**
+             * Whether this is a base charge override
+             */
+            baseCharge?: boolean;
+            /**
+             * The billing country code of the price
+             */
+            billingCountryCode?: string;
+            /**
+             * Block size for pricing
+             */
+            blockSize?: number;
+            /**
+             * The price currency
+             */
+            currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            /**
+             * Feature identifier for the price override
+             */
+            featureId?: string | null;
+            /**
+             * Pricing tiers configuration
+             */
+            tiers?: Array<Price.Tier>;
+        }
+        namespace Price {
+            interface Tier {
+                /**
+                 * The flat fee price of the price tier
+                 */
+                flatPrice?: Tier.FlatPrice;
+                /**
+                 * The unit price of the price tier
+                 */
+                unitPrice?: Tier.UnitPrice;
+                /**
+                 * The up to quantity of the price tier
+                 */
+                upTo?: number;
+            }
+            namespace Tier {
+                /**
+                 * The flat fee price of the price tier
+                 */
+                interface FlatPrice {
+                    /**
+                     * The price amount
+                     */
+                    amount: number;
+                    /**
+                     * The price currency
+                     */
+                    currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                }
+                /**
+                 * The unit price of the price tier
+                 */
+                interface UnitPrice {
+                    /**
+                     * The price amount
+                     */
+                    amount: number;
+                    /**
+                     * The price currency
+                     */
+                    currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                }
+            }
+        }
+        /**
+         * Subscription entitlement reference
+         */
+        interface SubscriptionEntitlement {
+            /**
+             * Feature ID or currency ID
+             */
+            id: string;
+            /**
+             * Entitlement type (FEATURE or CREDIT)
+             */
+            type: 'FEATURE' | 'CREDIT';
+        }
+        /**
+         * Trial configuration
+         */
+        interface Trial {
+            /**
+             * Behavior when the trial ends
+             */
+            trialEndBehavior: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+        }
+    }
+}
+/**
+ * Customer subscription to a plan
+ */
+export interface SubscriptionListResponse {
+    /**
+     * Subscription ID
+     */
+    id: string;
+    /**
+     * Billing ID
+     */
+    billingId: string | null;
+    /**
+     * Created at
+     */
+    createdAt: string;
+    /**
+     * Customer ID
+     */
+    customerId: string;
+    /**
+     * Payment collection
+     */
+    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+    /**
+     * Plan ID
+     */
+    planId: string;
+    /**
+     * Pricing type
+     */
+    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+    /**
+     * Subscription start date
+     */
+    startDate: string;
+    /**
+     * Subscription status
+     */
+    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+    addons?: Array<SubscriptionListResponse.Addon>;
+    /**
+     * Billing cycle anchor date
+     */
+    billingCycleAnchor?: string | null;
+    /**
+     * Budget configuration
+     */
+    budget?: SubscriptionListResponse.Budget | null;
+    /**
+     * Subscription cancellation date
+     */
+    cancellationDate?: string | null;
+    /**
+     * Subscription cancel reason
+     */
+    cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+    /**
+     * Coupons applied to the subscription
+     */
+    coupons?: Array<SubscriptionListResponse.Coupon>;
+    /**
+     * End of the current billing period
+     */
+    currentBillingPeriodEnd?: string | null;
+    /**
+     * Start of the current billing period
+     */
+    currentBillingPeriodStart?: string | null;
+    /**
+     * Subscription effective end date
+     */
+    effectiveEndDate?: string | null;
+    /**
+     * Subscription end date
+     */
+    endDate?: string | null;
+    /**
+     * Scheduled future updates for the subscription
+     */
+    futureUpdates?: Array<SubscriptionListResponse.FutureUpdate>;
+    /**
+     * Latest invoice for the subscription
+     */
+    latestInvoice?: SubscriptionListResponse.LatestInvoice | null;
+    /**
+     * Additional metadata for the subscription
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Minimum spend configuration
+     */
+    minimumSpend?: SubscriptionListResponse.MinimumSpend | null;
+    /**
+     * Paying customer ID for delegated billing
+     */
+    payingCustomerId?: string | null;
+    /**
+     * The method used to collect payments for a subscription
+     */
+    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+    prices?: Array<SubscriptionListResponse.Price>;
+    /**
+     * Resource ID
+     */
+    resourceId?: string | null;
+    /**
+     * Entitlements associated with the subscription
+     */
+    subscriptionEntitlements?: Array<SubscriptionListResponse.SubscriptionEntitlement>;
+    /**
+     * Trial configuration
+     */
+    trial?: SubscriptionListResponse.Trial | null;
+    /**
+     * Subscription trial end date
+     */
+    trialEndDate?: string | null;
+}
+export declare namespace SubscriptionListResponse {
+    /**
+     * Addon configuration
+     */
+    interface Addon {
+        /**
+         * Addon ID
+         */
+        id: string;
+        /**
+         * Number of addon instances
+         */
+        quantity: number;
+    }
+    /**
+     * Budget configuration
+     */
+    interface Budget {
+        /**
+         * Whether the budget is a soft limit
+         */
+        hasSoftLimit: boolean;
+        /**
+         * Maximum spending limit
+         */
+        limit: number;
+    }
+    /**
+     * Coupon applied to a subscription
+     */
+    interface Coupon {
+        /**
+         * Coupon ID
+         */
+        id: string;
+        /**
+         * Coupon name
+         */
+        name: string;
+        /**
+         * Coupon status
+         */
+        status: 'ACTIVE' | 'EXPIRED' | 'REMOVED';
+        /**
+         * Fixed amount discounts by currency
+         */
+        amountsOff?: Array<Coupon.AmountsOff> | null;
+        /**
+         * Percentage discount
+         */
+        percentOff?: number | null;
+    }
+    namespace Coupon {
+        interface AmountsOff {
+            /**
+             * The price amount
+             */
+            amount?: number;
+            /**
+             * The price currency
+             */
+            currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+        }
+    }
+    /**
+     * Scheduled subscription update
+     */
+    interface FutureUpdate {
+        /**
+         * Scheduled execution time
+         */
+        scheduledExecutionTime: string;
+        /**
+         * Status of the scheduled update
+         */
+        scheduleStatus: 'PENDING_PAYMENT' | 'SCHEDULED' | 'CANCELED' | 'DONE' | 'FAILED';
+        /**
+         * Type of scheduled change
+         */
+        subscriptionScheduleType: 'DOWNGRADE' | 'PLAN' | 'BILLING_PERIOD' | 'UNIT_AMOUNT' | 'RECURRING_CREDITS' | 'PRICE_OVERRIDE' | 'ADDON' | 'COUPON' | 'MIGRATE_TO_LATEST' | 'ADDITIONAL_META_DATA' | 'BILLING_INFO_METADATA';
+        /**
+         * Target package for the update
+         */
+        targetPackage?: FutureUpdate.TargetPackage | null;
+    }
+    namespace FutureUpdate {
+        /**
+         * Target package for the update
+         */
+        interface TargetPackage {
+            /**
+             * Target package for the update
+             */
+            id: string;
+        }
+    }
+    /**
+     * Latest invoice for the subscription
+     */
+    interface LatestInvoice {
+        /**
+         * Invoice billing ID
+         */
+        billingId: string;
+        /**
+         * Invoice creation date
+         */
+        createdAt: string;
+        /**
+         * Whether payment requires action
+         */
+        requiresAction: boolean;
+        /**
+         * Invoice status
+         */
+        status: 'OPEN' | 'CANCELED' | 'PAID';
+        /**
+         * Amount due
+         */
+        amountDue?: number | null;
+        /**
+         * Billing reason
+         */
+        billingReason?: 'BILLING_CYCLE' | 'SUBSCRIPTION_CREATION' | 'SUBSCRIPTION_UPDATE' | 'MANUAL' | 'MINIMUM_INVOICE_AMOUNT_EXCEEDED' | 'OTHER' | null;
+        /**
+         * Invoice currency
+         */
+        currency?: string | null;
+        /**
+         * Invoice PDF URL
+         */
+        pdfUrl?: string | null;
+        /**
+         * Total amount
+         */
+        total?: number | null;
+    }
+    /**
+     * Minimum spend configuration
+     */
+    interface MinimumSpend {
+        /**
+         * The price amount
+         */
+        amount?: number;
+        /**
+         * The price currency
+         */
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+    }
+    interface Price {
+        /**
+         * Addon identifier for the price override
+         */
+        addonId?: string | null;
+        /**
+         * The price amount
+         */
+        amount?: number;
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string;
+        /**
+         * Block size for pricing
+         */
+        blockSize?: number;
+        /**
+         * The price currency
+         */
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+        /**
+         * Feature identifier for the price override
+         */
+        featureId?: string | null;
+        /**
+         * Pricing tiers configuration
+         */
+        tiers?: Array<Price.Tier>;
+    }
+    namespace Price {
+        interface Tier {
+            /**
+             * The flat fee price of the price tier
+             */
+            flatPrice?: Tier.FlatPrice;
+            /**
+             * The unit price of the price tier
+             */
+            unitPrice?: Tier.UnitPrice;
+            /**
+             * The up to quantity of the price tier
+             */
+            upTo?: number;
+        }
+        namespace Tier {
+            /**
+             * The flat fee price of the price tier
+             */
+            interface FlatPrice {
+                /**
+                 * The price amount
+                 */
+                amount: number;
+                /**
+                 * The price currency
+                 */
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+            /**
+             * The unit price of the price tier
+             */
+            interface UnitPrice {
+                /**
+                 * The price amount
+                 */
+                amount: number;
+                /**
+                 * The price currency
+                 */
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+        }
+    }
+    /**
+     * Subscription entitlement reference
+     */
+    interface SubscriptionEntitlement {
+        /**
+         * Feature ID or currency ID
+         */
+        id: string;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'FEATURE' | 'CREDIT';
+    }
+    /**
+     * Trial configuration
+     */
+    interface Trial {
+        /**
+         * Behavior when the trial ends
+         */
+        trialEndBehavior: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionImportResponse {
+    data: SubscriptionImportResponse.Data;
+}
+export declare namespace SubscriptionImportResponse {
+    interface Data {
+        /**
+         * Unique identifier for the import task
+         */
+        taskId: string;
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    data: SubscriptionPreviewResponse.Data;
+}
+export declare namespace SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    interface Data {
+        /**
+         * Invoice due immediately
+         */
+        immediateInvoice: Data.ImmediateInvoice;
+        /**
+         * Billing period range
+         */
+        billingPeriodRange?: Data.BillingPeriodRange;
+        /**
+         * Free items included
+         */
+        freeItems?: Array<Data.FreeItem>;
+        /**
+         * Whether updates are scheduled
+         */
+        hasScheduledUpdates?: boolean;
+        /**
+         * Whether this is a downgrade
+         */
+        isPlanDowngrade?: boolean;
+        /**
+         * Recurring invoice preview
+         */
+        recurringInvoice?: Data.RecurringInvoice;
+    }
+    namespace Data {
+        /**
+         * Invoice due immediately
+         */
+        interface ImmediateInvoice {
+            /**
+             * Subtotal before discounts
+             */
+            subTotal: number;
+            /**
+             * Invoice total
+             */
+            total: number;
+            /**
+             * Billing period covered
+             */
+            billingPeriodRange?: ImmediateInvoice.BillingPeriodRange;
+            /**
+             * Currency code
+             */
+            currency?: string | null;
+            /**
+             * Total discount amount
+             */
+            discount?: number;
+            /**
+             * Discount breakdown
+             */
+            discountDetails?: ImmediateInvoice.DiscountDetails;
+            /**
+             * Applied discounts
+             */
+            discounts?: Array<ImmediateInvoice.Discount>;
+            /**
+             * Line items
+             */
+            lines?: Array<ImmediateInvoice.Line>;
+            /**
+             * Tax amount
+             */
+            tax?: number;
+        }
+        namespace ImmediateInvoice {
+            /**
+             * Billing period covered
+             */
+            interface BillingPeriodRange {
+                /**
+                 * Billing period end date
+                 */
+                end: string;
+                /**
+                 * Billing period start date
+                 */
+                start: string;
+            }
+            /**
+             * Discount breakdown
+             */
+            interface DiscountDetails {
+                /**
+                 * Promo code used
+                 */
+                code?: string;
+                /**
+                 * Fixed discount amount
+                 */
+                fixedAmount?: number;
+                /**
+                 * Percentage discount
+                 */
+                percentage?: number;
+            }
+            /**
+             * Applied discount amount
+             */
+            interface Discount {
+                /**
+                 * Discount amount
+                 */
+                amount: number;
+                /**
+                 * Currency code
+                 */
+                currency: string;
+                /**
+                 * Discount description
+                 */
+                description: string;
+            }
+            /**
+             * Invoice line item
+             */
+            interface Line {
+                /**
+                 * Currency code
+                 */
+                currency: string;
+                /**
+                 * Line item description
+                 */
+                description: string;
+                /**
+                 * Line subtotal
+                 */
+                subTotal: number;
+                /**
+                 * Price per unit
+                 */
+                unitPrice: number;
+                /**
+                 * Quantity
+                 */
+                quantity?: number;
+            }
+        }
+        /**
+         * Billing period range
+         */
+        interface BillingPeriodRange {
+            /**
+             * Billing period end date
+             */
+            end?: string;
+            /**
+             * Billing period start date
+             */
+            start?: string;
+        }
+        /**
+         * Addon configuration
+         */
+        interface FreeItem {
+            /**
+             * Addon ID
+             */
+            id: string;
+            /**
+             * Number of addon instances
+             */
+            quantity: number;
+        }
+        /**
+         * Recurring invoice preview
+         */
+        interface RecurringInvoice {
+            /**
+             * Subtotal before discounts
+             */
+            subTotal: number;
+            /**
+             * Invoice total
+             */
+            total: number;
+            /**
+             * Billing period covered
+             */
+            billingPeriodRange?: RecurringInvoice.BillingPeriodRange;
+            /**
+             * Currency code
+             */
+            currency?: string | null;
+            /**
+             * Total discount amount
+             */
+            discount?: number;
+            /**
+             * Discount breakdown
+             */
+            discountDetails?: RecurringInvoice.DiscountDetails;
+            /**
+             * Applied discounts
+             */
+            discounts?: Array<RecurringInvoice.Discount>;
+            /**
+             * Line items
+             */
+            lines?: Array<RecurringInvoice.Line>;
+            /**
+             * Tax amount
+             */
+            tax?: number;
+        }
+        namespace RecurringInvoice {
+            /**
+             * Billing period covered
+             */
+            interface BillingPeriodRange {
+                /**
+                 * Billing period end date
+                 */
+                end: string;
+                /**
+                 * Billing period start date
+                 */
+                start: string;
+            }
+            /**
+             * Discount breakdown
+             */
+            interface DiscountDetails {
+                /**
+                 * Promo code used
+                 */
+                code?: string;
+                /**
+                 * Fixed discount amount
+                 */
+                fixedAmount?: number;
+                /**
+                 * Percentage discount
+                 */
+                percentage?: number;
+            }
+            /**
+             * Applied discount amount
+             */
+            interface Discount {
+                /**
+                 * Discount amount
+                 */
+                amount: number;
+                /**
+                 * Currency code
+                 */
+                currency: string;
+                /**
+                 * Discount description
+                 */
+                description: string;
+            }
+            /**
+             * Invoice line item
+             */
+            interface Line {
+                /**
+                 * Currency code
+                 */
+                currency: string;
+                /**
+                 * Line item description
+                 */
+                description: string;
+                /**
+                 * Line subtotal
+                 */
+                subTotal: number;
+                /**
+                 * Price per unit
+                 */
+                unitPrice: number;
+                /**
+                 * Quantity
+                 */
+                quantity?: number;
+            }
+        }
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionProvisionResponse {
+    /**
+     * Provisioning result with status and subscription or checkout URL.
+     */
+    data: SubscriptionProvisionResponse.Data;
+}
+export declare namespace SubscriptionProvisionResponse {
+    /**
+     * Provisioning result with status and subscription or checkout URL.
+     */
+    interface Data {
+        /**
+         * Unique identifier for the provisioned subscription
+         */
+        id: string;
+        entitlements: Array<Data.UnionObjectVariant0 | Data.UnionObjectVariant1> | null;
+        /**
+         * Provision status: SUCCESS or PAYMENT_REQUIRED
+         */
+        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
+        /**
+         * Created subscription (when status is SUCCESS)
+         */
+        subscription: Data.Subscription | null;
+        /**
+         * Checkout billing ID when payment is required
+         */
+        checkoutBillingId?: string;
+        /**
+         * URL to complete payment when PAYMENT_REQUIRED
+         */
+        checkoutUrl?: string;
+        /**
+         * Whether the subscription is scheduled for future activation
+         */
+        isScheduled?: boolean;
+    }
+    namespace Data {
+        interface UnionObjectVariant0 {
+            accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+            isGranted: boolean;
+            type: 'FEATURE';
+            currentUsage?: number;
+            /**
+             * Timestamp of the last update to the entitlement grant or configuration.
+             */
+            entitlementUpdatedAt?: string;
+            feature?: UnionObjectVariant0.Feature;
+            hasUnlimitedUsage?: boolean;
+            resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+            usageLimit?: number | null;
+            /**
+             * The anchor for calculating the usage period for metered entitlements with a
+             * reset period configured
+             */
+            usagePeriodAnchor?: string;
+            /**
+             * The end date of the usage period for metered entitlements with a reset period
+             * configured
+             */
+            usagePeriodEnd?: string;
+            /**
+             * The start date of the usage period for metered entitlements with a reset period
+             * configured
+             */
+            usagePeriodStart?: string;
+            /**
+             * The next time the entitlement should be recalculated
+             */
+            validUntil?: string;
+        }
+        namespace UnionObjectVariant0 {
+            interface Feature {
+                /**
+                 * The human-readable name of the entitlement, shown in UI elements.
+                 */
+                displayName: string;
+                /**
+                 * The current status of the feature.
+                 */
+                featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+                /**
+                 * The type of feature associated with the entitlement.
+                 */
+                featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+                /**
+                 * The unique reference ID of the entitlement.
+                 */
+                refId: string;
+            }
+        }
+        interface UnionObjectVariant1 {
+            accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            currency: UnionObjectVariant1.Currency;
+            currentUsage: number;
+            isGranted: boolean;
+            type: 'CREDIT';
+            usageLimit: number;
+            /**
+             * Timestamp of the last update to the credit usage.
+             */
+            usageUpdatedAt: string;
+            /**
+             * Timestamp of the last update to the entitlement grant or configuration.
+             */
+            entitlementUpdatedAt?: string;
+            /**
+             * The end date of the current billing period for recurring credit grants.
+             */
+            usagePeriodEnd?: string;
+            /**
+             * The next time the entitlement should be recalculated
+             */
+            validUntil?: string;
+        }
+        namespace UnionObjectVariant1 {
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            interface Currency {
+                /**
+                 * The unique identifier of the custom currency.
+                 */
+                currencyId: string;
+                /**
+                 * The display name of the currency.
+                 */
+                displayName: string;
+                /**
+                 * Additional metadata associated with the currency.
+                 */
+                additionalMetaData?: unknown;
+                /**
+                 * A description of the currency.
+                 */
+                description?: string | null;
+                /**
+                 * The plural form of the currency unit.
+                 */
+                unitPlural?: string | null;
+                /**
+                 * The singular form of the currency unit.
+                 */
+                unitSingular?: string | null;
+            }
+        }
+        /**
+         * Created subscription (when status is SUCCESS)
+         */
+        interface Subscription {
+            /**
+             * Subscription ID
+             */
+            id: string;
+            /**
+             * Billing ID
+             */
+            billingId: string | null;
+            /**
+             * Created at
+             */
+            createdAt: string;
+            /**
+             * Customer ID
+             */
+            customerId: string;
+            /**
+             * Payment collection
+             */
+            paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+            /**
+             * Plan ID
+             */
+            planId: string;
+            /**
+             * Pricing type
+             */
+            pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+            /**
+             * Subscription start date
+             */
+            startDate: string;
+            /**
+             * Subscription status
+             */
+            status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+            addons?: Array<Subscription.Addon>;
+            /**
+             * Billing cycle anchor date
+             */
+            billingCycleAnchor?: string | null;
+            /**
+             * Budget configuration
+             */
+            budget?: Subscription.Budget | null;
+            /**
+             * Subscription cancellation date
+             */
+            cancellationDate?: string | null;
+            /**
+             * Subscription cancel reason
+             */
+            cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+            /**
+             * Coupons applied to the subscription
+             */
+            coupons?: Array<Subscription.Coupon>;
+            /**
+             * End of the current billing period
+             */
+            currentBillingPeriodEnd?: string | null;
+            /**
+             * Start of the current billing period
+             */
+            currentBillingPeriodStart?: string | null;
+            /**
+             * Subscription effective end date
+             */
+            effectiveEndDate?: string | null;
+            /**
+             * Subscription end date
+             */
+            endDate?: string | null;
+            /**
+             * Scheduled future updates for the subscription
+             */
+            futureUpdates?: Array<Subscription.FutureUpdate>;
+            /**
+             * Latest invoice for the subscription
+             */
+            latestInvoice?: Subscription.LatestInvoice | null;
+            /**
+             * Additional metadata for the subscription
+             */
+            metadata?: {
+                [key: string]: string;
+            };
+            /**
+             * Minimum spend configuration
+             */
+            minimumSpend?: Subscription.MinimumSpend | null;
+            /**
+             * Paying customer ID for delegated billing
+             */
+            payingCustomerId?: string | null;
+            /**
+             * The method used to collect payments for a subscription
+             */
+            paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+            prices?: Array<Subscription.Price>;
+            /**
+             * Resource ID
+             */
+            resourceId?: string | null;
+            /**
+             * Entitlements associated with the subscription
+             */
+            subscriptionEntitlements?: Array<Subscription.SubscriptionEntitlement>;
+            /**
+             * Trial configuration
+             */
+            trial?: Subscription.Trial | null;
+            /**
+             * Subscription trial end date
+             */
+            trialEndDate?: string | null;
+        }
+        namespace Subscription {
+            /**
+             * Addon configuration
+             */
+            interface Addon {
+                /**
+                 * Addon ID
+                 */
+                id: string;
+                /**
+                 * Number of addon instances
+                 */
+                quantity: number;
+            }
+            /**
+             * Budget configuration
+             */
+            interface Budget {
+                /**
+                 * Whether the budget is a soft limit
+                 */
+                hasSoftLimit: boolean;
+                /**
+                 * Maximum spending limit
+                 */
+                limit: number;
+            }
+            /**
+             * Coupon applied to a subscription
+             */
+            interface Coupon {
+                /**
+                 * Coupon ID
+                 */
+                id: string;
+                /**
+                 * Coupon name
+                 */
+                name: string;
+                /**
+                 * Coupon status
+                 */
+                status: 'ACTIVE' | 'EXPIRED' | 'REMOVED';
+                /**
+                 * Fixed amount discounts by currency
+                 */
+                amountsOff?: Array<Coupon.AmountsOff> | null;
+                /**
+                 * Percentage discount
+                 */
+                percentOff?: number | null;
+            }
+            namespace Coupon {
+                interface AmountsOff {
+                    /**
+                     * The price amount
+                     */
+                    amount?: number;
+                    /**
+                     * The price currency
+                     */
+                    currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                }
+            }
+            /**
+             * Scheduled subscription update
+             */
+            interface FutureUpdate {
+                /**
+                 * Scheduled execution time
+                 */
+                scheduledExecutionTime: string;
+                /**
+                 * Status of the scheduled update
+                 */
+                scheduleStatus: 'PENDING_PAYMENT' | 'SCHEDULED' | 'CANCELED' | 'DONE' | 'FAILED';
+                /**
+                 * Type of scheduled change
+                 */
+                subscriptionScheduleType: 'DOWNGRADE' | 'PLAN' | 'BILLING_PERIOD' | 'UNIT_AMOUNT' | 'RECURRING_CREDITS' | 'PRICE_OVERRIDE' | 'ADDON' | 'COUPON' | 'MIGRATE_TO_LATEST' | 'ADDITIONAL_META_DATA' | 'BILLING_INFO_METADATA';
+                /**
+                 * Target package for the update
+                 */
+                targetPackage?: FutureUpdate.TargetPackage | null;
+            }
+            namespace FutureUpdate {
+                /**
+                 * Target package for the update
+                 */
+                interface TargetPackage {
+                    /**
+                     * Target package for the update
+                     */
+                    id: string;
+                }
+            }
+            /**
+             * Latest invoice for the subscription
+             */
+            interface LatestInvoice {
+                /**
+                 * Invoice billing ID
+                 */
+                billingId: string;
+                /**
+                 * Invoice creation date
+                 */
+                createdAt: string;
+                /**
+                 * Whether payment requires action
+                 */
+                requiresAction: boolean;
+                /**
+                 * Invoice status
+                 */
+                status: 'OPEN' | 'CANCELED' | 'PAID';
+                /**
+                 * Amount due
+                 */
+                amountDue?: number | null;
+                /**
+                 * Billing reason
+                 */
+                billingReason?: 'BILLING_CYCLE' | 'SUBSCRIPTION_CREATION' | 'SUBSCRIPTION_UPDATE' | 'MANUAL' | 'MINIMUM_INVOICE_AMOUNT_EXCEEDED' | 'OTHER' | null;
+                /**
+                 * Invoice currency
+                 */
+                currency?: string | null;
+                /**
+                 * Invoice PDF URL
+                 */
+                pdfUrl?: string | null;
+                /**
+                 * Total amount
+                 */
+                total?: number | null;
+            }
+            /**
+             * Minimum spend configuration
+             */
+            interface MinimumSpend {
+                /**
+                 * The price amount
+                 */
+                amount?: number;
+                /**
+                 * The price currency
+                 */
+                currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+            interface Price {
+                /**
+                 * Addon identifier for the price override
+                 */
+                addonId?: string | null;
+                /**
+                 * The price amount
+                 */
+                amount?: number;
+                /**
+                 * Whether this is a base charge override
+                 */
+                baseCharge?: boolean;
+                /**
+                 * The billing country code of the price
+                 */
+                billingCountryCode?: string;
+                /**
+                 * Block size for pricing
+                 */
+                blockSize?: number;
+                /**
+                 * The price currency
+                 */
+                currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                /**
+                 * Feature identifier for the price override
+                 */
+                featureId?: string | null;
+                /**
+                 * Pricing tiers configuration
+                 */
+                tiers?: Array<Price.Tier>;
+            }
+            namespace Price {
+                interface Tier {
+                    /**
+                     * The flat fee price of the price tier
+                     */
+                    flatPrice?: Tier.FlatPrice;
+                    /**
+                     * The unit price of the price tier
+                     */
+                    unitPrice?: Tier.UnitPrice;
+                    /**
+                     * The up to quantity of the price tier
+                     */
+                    upTo?: number;
+                }
+                namespace Tier {
+                    /**
+                     * The flat fee price of the price tier
+                     */
+                    interface FlatPrice {
+                        /**
+                         * The price amount
+                         */
+                        amount: number;
+                        /**
+                         * The price currency
+                         */
+                        currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                    }
+                    /**
+                     * The unit price of the price tier
+                     */
+                    interface UnitPrice {
+                        /**
+                         * The price amount
+                         */
+                        amount: number;
+                        /**
+                         * The price currency
+                         */
+                        currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+                    }
+                }
+            }
+            /**
+             * Subscription entitlement reference
+             */
+            interface SubscriptionEntitlement {
+                /**
+                 * Feature ID or currency ID
+                 */
+                id: string;
+                /**
+                 * Entitlement type (FEATURE or CREDIT)
+                 */
+                type: 'FEATURE' | 'CREDIT';
+            }
+            /**
+             * Trial configuration
+             */
+            interface Trial {
+                /**
+                 * Behavior when the trial ends
+                 */
+                trialEndBehavior: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+            }
+        }
+    }
+}
+export interface SubscriptionUpdateParams {
+    addons?: Array<SubscriptionUpdateParams.Addon>;
+    appliedCoupon?: SubscriptionUpdateParams.AppliedCoupon;
+    awaitPaymentConfirmation?: boolean;
+    billingCycleAnchor?: 'UNCHANGED' | 'NOW';
+    billingInformation?: SubscriptionUpdateParams.BillingInformation;
+    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    budget?: SubscriptionUpdateParams.Budget | null;
+    charges?: Array<SubscriptionUpdateParams.Charge>;
+    entitlements?: Array<SubscriptionUpdateParams.Feature | SubscriptionUpdateParams.Credit>;
+    /**
+     * Additional metadata for the subscription
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Minimum spend amount
+     */
+    minimumSpend?: SubscriptionUpdateParams.MinimumSpend | null;
+    priceOverrides?: Array<SubscriptionUpdateParams.PriceOverride>;
+    promotionCode?: string;
+    scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+    /**
+     * Subscription trial end date
+     */
+    trialEndDate?: string;
+}
+export declare namespace SubscriptionUpdateParams {
+    /**
+     * Addon configuration
+     */
+    interface Addon {
+        /**
+         * Addon ID
          */
-        startDate: string;
+        id: string;
         /**
-         * Subscription status
+         * Number of addon instances
          */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        quantity: number;
+    }
+    interface AppliedCoupon {
+        billingCouponId?: string;
+        configuration?: AppliedCoupon.Configuration;
+        couponId?: string;
+        discount?: AppliedCoupon.Discount;
+        promotionCode?: string | null;
+    }
+    namespace AppliedCoupon {
+        interface Configuration {
+            /**
+             * Coupon start date
+             */
+            startDate?: string;
+        }
+        interface Discount {
+            amountsOff?: Array<Discount.AmountsOff> | null;
+            description?: string;
+            durationInMonths?: number;
+            name?: string;
+            percentOff?: number;
+        }
+        namespace Discount {
+            /**
+             * Monetary amount with currency
+             */
+            interface AmountsOff {
+                /**
+                 * The price amount
+                 */
+                amount: number;
+                /**
+                 * The price currency
+                 */
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+        }
+    }
+    interface BillingInformation {
         /**
-         * Subscription cancellation date
+         * Physical address
          */
-        cancellationDate?: string | null;
+        billingAddress?: BillingInformation.BillingAddress;
+        chargeOnBehalfOfAccount?: string;
+        couponId?: string;
+        integrationId?: string;
+        invoiceDaysUntilDue?: number;
+        isBackdated?: boolean;
+        isInvoicePaid?: boolean;
         /**
-         * Subscription cancel reason
+         * Additional metadata for the subscription
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+        taxIds?: Array<BillingInformation.TaxID>;
+        taxPercentage?: number;
+        taxRateIds?: Array<string>;
+    }
+    namespace BillingInformation {
         /**
-         * End of the current billing period
+         * Physical address
          */
-        currentBillingPeriodEnd?: string | null;
+        interface BillingAddress {
+            /**
+             * City name
+             */
+            city?: string;
+            /**
+             * Country code or name
+             */
+            country?: string;
+            /**
+             * Street address line 1
+             */
+            line1?: string;
+            /**
+             * Street address line 2
+             */
+            line2?: string;
+            /**
+             * Postal or ZIP code
+             */
+            postalCode?: string;
+            /**
+             * State or province
+             */
+            state?: string;
+        }
+        interface TaxID {
+            type: string;
+            value: string;
+        }
+    }
+    interface Budget {
         /**
-         * Start of the current billing period
+         * Whether the budget is a soft limit
          */
-        currentBillingPeriodStart?: string | null;
+        hasSoftLimit: boolean;
         /**
-         * Subscription effective end date
+         * Maximum spending limit
          */
-        effectiveEndDate?: string | null;
+        limit: number;
+    }
+    interface Charge {
         /**
-         * Subscription end date
+         * Charge ID
          */
-        endDate?: string | null;
+        id: string;
+        quantity: number;
+        type: 'FEATURE' | 'CREDIT';
+    }
+    /**
+     * Feature entitlement configuration for a subscription
+     */
+    interface Feature {
         /**
-         * Additional metadata for the subscription
+         * The feature ID to attach the entitlement to
          */
-        metadata?: {
-            [key: string]: string;
-        };
+        id: string;
         /**
-         * Paying customer ID for delegated billing
+         * SubscriptionFeatureEntitlementRequest
          */
-        payingCustomerId?: string | null;
+        type: 'FEATURE';
+        /**
+         * Whether the usage limit is a soft limit
+         */
+        hasSoftLimit?: boolean;
+        /**
+         * Whether usage is unlimited
+         */
+        hasUnlimitedUsage?: boolean;
+        /**
+         * Configuration for monthly reset period
+         */
+        monthlyResetPeriodConfiguration?: Feature.MonthlyResetPeriodConfiguration | null;
+        /**
+         * Period at which usage resets
+         */
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR';
+        /**
+         * Maximum allowed usage for the feature
+         */
+        usageLimit?: number;
+        /**
+         * Configuration for weekly reset period
+         */
+        weeklyResetPeriodConfiguration?: Feature.WeeklyResetPeriodConfiguration | null;
+        /**
+         * Configuration for yearly reset period
+         */
+        yearlyResetPeriodConfiguration?: Feature.YearlyResetPeriodConfiguration | null;
+    }
+    namespace Feature {
+        /**
+         * Configuration for monthly reset period
+         */
+        interface MonthlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Configuration for weekly reset period
+         */
+        interface WeeklyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+        /**
+         * Configuration for yearly reset period
+         */
+        interface YearlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+    }
+    /**
+     * Credit entitlement configuration for a subscription
+     */
+    interface Credit {
+        /**
+         * The custom currency ID for the credit entitlement
+         */
+        id: string;
+        /**
+         * Credit grant amount
+         */
+        amount: number;
+        /**
+         * Credit grant cadence (MONTH or YEAR)
+         */
+        cadence: 'MONTH' | 'YEAR';
+        /**
+         * SubscriptionCreditEntitlementRequest
+         */
+        type: 'CREDIT';
+    }
+    /**
+     * Minimum spend amount
+     */
+    interface MinimumSpend {
         /**
-         * The method used to collect payments for a subscription
+         * The price amount
          */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        amount?: number;
         /**
-         * Resource ID
+         * The price currency
          */
-        resourceId?: string | null;
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+    }
+    interface PriceOverride {
         /**
-         * Subscription trial end date
+         * Addon ID
          */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionMigrateResponse {
-    data: SubscriptionMigrateResponse.Data;
-}
-export declare namespace SubscriptionMigrateResponse {
-    interface Data {
+        addonId?: string;
         /**
-         * Subscription ID
+         * The price amount
          */
-        id: string;
+        amount?: number;
         /**
-         * Billing ID
+         * Whether this is a base charge override
          */
-        billingId: string | null;
+        baseCharge?: boolean;
         /**
-         * Created at
+         * The price currency
          */
-        createdAt: string;
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
         /**
-         * Customer ID
+         * The corresponding custom currency id of the recurring credits price
          */
-        customerId: string;
+        currencyId?: string;
         /**
-         * Payment collection
+         * Feature ID
          */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+        featureId?: string;
+    }
+}
+export interface SubscriptionListParams extends MyCursorIDPageParams {
+    /**
+     * Filter by creation date using range operators: gt, gte, lt, lte
+     */
+    createdAt?: SubscriptionListParams.CreatedAt;
+    /**
+     * Filter by customer ID
+     */
+    customerId?: string;
+    /**
+     * Filter by plan ID
+     */
+    planId?: string;
+    /**
+     * Filter by pricing type. Supports comma-separated values for multiple types
+     */
+    pricingType?: string;
+    /**
+     * Filter by resource ID
+     */
+    resourceId?: string;
+    /**
+     * Filter by subscription status. Supports comma-separated values for multiple
+     * statuses
+     */
+    status?: string;
+}
+export declare namespace SubscriptionListParams {
+    /**
+     * Filter by creation date using range operators: gt, gte, lt, lte
+     */
+    interface CreatedAt {
         /**
-         * Plan ID
+         * Greater than the specified createdAt value
          */
-        planId: string;
+        gt?: string;
         /**
-         * Pricing type
+         * Greater than or equal to the specified createdAt value
          */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+        gte?: string;
         /**
-         * Subscription start date
+         * Less than the specified createdAt value
          */
-        startDate: string;
+        lt?: string;
         /**
-         * Subscription status
+         * Less than or equal to the specified createdAt value
          */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        lte?: string;
+    }
+}
+export interface SubscriptionCancelParams {
+    /**
+     * Action on cancellation (downgrade or revoke)
+     */
+    cancellationAction?: 'DEFAULT' | 'REVOKE_ENTITLEMENTS';
+    /**
+     * When to cancel (immediate, period end, or date)
+     */
+    cancellationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE' | 'SPECIFIC_DATE';
+    /**
+     * Subscription end date
+     */
+    endDate?: string;
+    /**
+     * If set, enables or disables prorating of credits on subscription cancellation.
+     */
+    prorate?: boolean;
+}
+export interface SubscriptionDelegateParams {
+    /**
+     * The unique identifier of the customer who will assume payment responsibility for
+     * this subscription. This customer must already exist in your Stigg account and
+     * have a valid payment method if the subscription requires payment.
+     */
+    targetCustomerId: string;
+}
+export interface SubscriptionImportParams {
+    /**
+     * List of subscription objects to import
+     */
+    subscriptions: Array<SubscriptionImportParams.Subscription>;
+    /**
+     * Integration ID to use for importing subscriptions
+     */
+    integrationId?: string | null;
+}
+export declare namespace SubscriptionImportParams {
+    interface Subscription {
         /**
-         * Subscription cancellation date
+         * Subscription ID
          */
-        cancellationDate?: string | null;
+        id: string;
         /**
-         * Subscription cancel reason
+         * Customer ID
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        customerId: string;
         /**
-         * End of the current billing period
+         * Plan ID
          */
-        currentBillingPeriodEnd?: string | null;
+        planId: string;
+        addons?: Array<Subscription.Addon>;
         /**
-         * Start of the current billing period
+         * Billing ID
          */
-        currentBillingPeriodStart?: string | null;
+        billingId?: string | null;
         /**
-         * Subscription effective end date
+         * Billing period (MONTHLY or ANNUALLY)
          */
-        effectiveEndDate?: string | null;
+        billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+        charges?: Array<Subscription.Charge>;
         /**
          * Subscription end date
          */
@@ -484,222 +2063,330 @@ export declare namespace SubscriptionMigrateResponse {
             [key: string]: string;
         };
         /**
-         * Paying customer ID for delegated billing
+         * Resource ID
          */
-        payingCustomerId?: string | null;
+        resourceId?: string | null;
         /**
-         * The method used to collect payments for a subscription
+         * Subscription start date
          */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        startDate?: string;
+    }
+    namespace Subscription {
         /**
-         * Resource ID
+         * Addon configuration
          */
-        resourceId?: string | null;
+        interface Addon {
+            /**
+             * Addon ID
+             */
+            id: string;
+            /**
+             * Number of addon instances
+             */
+            quantity: number;
+        }
         /**
-         * Subscription trial end date
+         * Charge item
          */
-        trialEndDate?: string | null;
+        interface Charge {
+            /**
+             * Charge ID
+             */
+            id: string;
+            /**
+             * Charge quantity
+             */
+            quantity: number;
+            /**
+             * Charge type
+             */
+            type: 'FEATURE' | 'CREDIT';
+        }
     }
 }
-export interface SubscriptionPreviewResponse {
-    data: SubscriptionPreviewResponse.Data;
+export interface SubscriptionMigrateParams {
+    /**
+     * When to migrate (immediate or period end)
+     */
+    subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
 }
-export declare namespace SubscriptionPreviewResponse {
-    interface Data {
-        immediateInvoice: Data.ImmediateInvoice;
-        billingPeriodRange?: Data.BillingPeriodRange;
-        freeItems?: Array<Data.FreeItem>;
-        hasScheduledUpdates?: boolean;
-        isPlanDowngrade?: boolean;
-        recurringInvoice?: Data.RecurringInvoice;
+export interface SubscriptionPreviewParams {
+    /**
+     * Customer ID
+     */
+    customerId: string;
+    /**
+     * Plan ID
+     */
+    planId: string;
+    /**
+     * Addons to include
+     */
+    addons?: Array<SubscriptionPreviewParams.Addon>;
+    /**
+     * Coupon or discount to apply
+     */
+    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
+    /**
+     * Billable features with quantities
+     */
+    billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
+    /**
+     * ISO 3166-1 country code for localization
+     */
+    billingCountryCode?: string;
+    /**
+     * Billing cycle anchor behavior for the subscription
+     */
+    billingCycleAnchor?: 'UNCHANGED' | 'NOW';
+    /**
+     * Billing and tax configuration
+     */
+    billingInformation?: SubscriptionPreviewParams.BillingInformation;
+    /**
+     * Billing period (MONTHLY or ANNUALLY)
+     */
+    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    /**
+     * One-time or recurring charges
+     */
+    charges?: Array<SubscriptionPreviewParams.Charge>;
+    /**
+     * Paying customer ID for delegated billing
+     */
+    payingCustomerId?: string;
+    /**
+     * Resource ID for multi-instance subscriptions
+     */
+    resourceId?: string;
+    /**
+     * When to apply subscription changes
+     */
+    scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+    /**
+     * Subscription start date
+     */
+    startDate?: string;
+    /**
+     * Trial period override settings
+     */
+    trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+    /**
+     * Unit quantity for per-unit pricing
+     */
+    unitQuantity?: number;
+}
+export declare namespace SubscriptionPreviewParams {
+    /**
+     * Addon configuration
+     */
+    interface Addon {
+        /**
+         * Addon ID
+         */
+        id: string;
+        /**
+         * Number of addon instances
+         */
+        quantity: number;
     }
-    namespace Data {
-        interface ImmediateInvoice {
-            subTotal: number;
-            total: number;
-            billingPeriodRange?: ImmediateInvoice.BillingPeriodRange;
-            currency?: string | null;
-            discount?: number;
-            discountDetails?: ImmediateInvoice.DiscountDetails;
-            discounts?: Array<ImmediateInvoice.Discount>;
-            lines?: Array<ImmediateInvoice.Line>;
-            tax?: number;
-        }
-        namespace ImmediateInvoice {
-            interface BillingPeriodRange {
-                /**
-                 * Billing period end date
-                 */
-                end: string;
-                /**
-                 * Billing period start date
-                 */
-                start: string;
-            }
-            interface DiscountDetails {
-                code?: string;
-                fixedAmount?: number;
-                percentage?: number;
-            }
-            interface Discount {
-                amount: number;
-                currency: string;
-                description: string;
-            }
-            interface Line {
-                currency: string;
-                description: string;
-                subTotal: number;
-                unitPrice: number;
-                quantity?: number;
-            }
+    /**
+     * Coupon or discount to apply
+     */
+    interface AppliedCoupon {
+        /**
+         * Billing provider coupon ID
+         */
+        billingCouponId?: string;
+        /**
+         * Coupon timing configuration
+         */
+        configuration?: AppliedCoupon.Configuration;
+        /**
+         * Stigg coupon ID
+         */
+        couponId?: string;
+        /**
+         * Ad-hoc discount configuration
+         */
+        discount?: AppliedCoupon.Discount;
+        /**
+         * Promotion code to apply
+         */
+        promotionCode?: string;
+    }
+    namespace AppliedCoupon {
+        /**
+         * Coupon timing configuration
+         */
+        interface Configuration {
+            /**
+             * Coupon start date
+             */
+            startDate?: string;
         }
-        interface BillingPeriodRange {
+        /**
+         * Ad-hoc discount configuration
+         */
+        interface Discount {
             /**
-             * Billing period end date
+             * Fixed amounts off by currency
              */
-            end?: string;
+            amountsOff?: Array<Discount.AmountsOff> | null;
             /**
-             * Billing period start date
+             * Ad-hoc discount
              */
-            start?: string;
-        }
-        interface FreeItem {
-            addonId: string;
-            quantity: number;
-        }
-        interface RecurringInvoice {
-            subTotal: number;
-            total: number;
-            billingPeriodRange?: RecurringInvoice.BillingPeriodRange;
-            currency?: string | null;
-            discount?: number;
-            discountDetails?: RecurringInvoice.DiscountDetails;
-            discounts?: Array<RecurringInvoice.Discount>;
-            lines?: Array<RecurringInvoice.Line>;
-            tax?: number;
+            description?: string;
+            /**
+             * Duration in months
+             */
+            durationInMonths?: number;
+            /**
+             * Discount name
+             */
+            name?: string;
+            /**
+             * Percentage discount
+             */
+            percentOff?: number;
         }
-        namespace RecurringInvoice {
-            interface BillingPeriodRange {
+        namespace Discount {
+            interface AmountsOff {
                 /**
-                 * Billing period end date
+                 * The price amount
                  */
-                end: string;
+                amount: number;
                 /**
-                 * Billing period start date
+                 * The price currency
                  */
-                start: string;
-            }
-            interface DiscountDetails {
-                code?: string;
-                fixedAmount?: number;
-                percentage?: number;
-            }
-            interface Discount {
-                amount: number;
-                currency: string;
-                description: string;
-            }
-            interface Line {
-                currency: string;
-                description: string;
-                subTotal: number;
-                unitPrice: number;
-                quantity?: number;
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
             }
         }
     }
-}
-export interface SubscriptionTransferResponse {
-    data: SubscriptionTransferResponse.Data;
-}
-export declare namespace SubscriptionTransferResponse {
-    interface Data {
+    /**
+     * Feature with quantity
+     */
+    interface BillableFeature {
         /**
-         * Subscription ID
+         * Feature ID
          */
-        id: string;
+        featureId: string;
         /**
-         * Billing ID
+         * Quantity of feature units
          */
-        billingId: string | null;
+        quantity: number;
+    }
+    /**
+     * Billing and tax configuration
+     */
+    interface BillingInformation {
         /**
-         * Created at
+         * Billing address
          */
-        createdAt: string;
+        billingAddress?: BillingInformation.BillingAddress;
         /**
-         * Customer ID
+         * Connected account ID for platform billing
          */
-        customerId: string;
+        chargeOnBehalfOfAccount?: string;
         /**
-         * Payment collection
+         * Billing integration ID
          */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+        integrationId?: string;
         /**
-         * Plan ID
+         * Days until invoice is due
          */
-        planId: string;
+        invoiceDaysUntilDue?: number;
         /**
-         * Pricing type
+         * Whether subscription is backdated
          */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+        isBackdated?: boolean;
         /**
-         * Subscription start date
+         * Whether invoice is already paid
          */
-        startDate: string;
+        isInvoicePaid?: boolean;
         /**
-         * Subscription status
+         * Additional billing metadata
          */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        metadata?: unknown;
         /**
-         * Subscription cancellation date
+         * Proration behavior
          */
-        cancellationDate?: string | null;
+        prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
         /**
-         * Subscription cancel reason
+         * Customer tax IDs
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        taxIds?: Array<BillingInformation.TaxID>;
         /**
-         * End of the current billing period
+         * Tax percentage to apply
          */
-        currentBillingPeriodEnd?: string | null;
+        taxPercentage?: number;
         /**
-         * Start of the current billing period
+         * Tax rate IDs from billing provider
          */
-        currentBillingPeriodStart?: string | null;
+        taxRateIds?: Array<string>;
+    }
+    namespace BillingInformation {
         /**
-         * Subscription effective end date
+         * Billing address
          */
-        effectiveEndDate?: string | null;
+        interface BillingAddress {
+            city?: string;
+            country?: string;
+            line1?: string;
+            line2?: string;
+            postalCode?: string;
+            state?: string;
+        }
         /**
-         * Subscription end date
+         * Tax exemption identifier
          */
-        endDate?: string | null;
+        interface TaxID {
+            /**
+             * Tax exemption type (e.g., vat, gst)
+             */
+            type: string;
+            /**
+             * Tax exemption identifier value
+             */
+            value: string;
+        }
+    }
+    /**
+     * Charge item
+     */
+    interface Charge {
         /**
-         * Additional metadata for the subscription
+         * Charge ID
          */
-        metadata?: {
-            [key: string]: string;
-        };
+        id: string;
         /**
-         * Paying customer ID for delegated billing
+         * Charge quantity
          */
-        payingCustomerId?: string | null;
+        quantity: number;
         /**
-         * The method used to collect payments for a subscription
+         * Charge type
          */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        type: 'FEATURE' | 'CREDIT';
+    }
+    /**
+     * Trial period override settings
+     */
+    interface TrialOverrideConfiguration {
         /**
-         * Resource ID
+         * Whether to start as trial
          */
-        resourceId?: string | null;
+        isTrial: boolean;
         /**
-         * Subscription trial end date
+         * Behavior when trial ends
          */
-        trialEndDate?: string | null;
+        trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+        /**
+         * Trial end date
+         */
+        trialEndDate?: string;
     }
 }
-export interface SubscriptionCreateParams {
+export interface SubscriptionProvisionParams {
     /**
      * Customer ID to provision the subscription for
      */
@@ -711,151 +2398,153 @@ export interface SubscriptionCreateParams {
     /**
      * Unique identifier for the subscription
      */
-    id?: string | null;
+    id?: string;
+    addons?: Array<SubscriptionProvisionParams.Addon>;
+    /**
+     * Coupon configuration
+     */
+    appliedCoupon?: SubscriptionProvisionParams.AppliedCoupon;
     /**
      * Whether to wait for payment confirmation before returning the subscription
      */
     awaitPaymentConfirmation?: boolean;
-    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
-    checkoutOptions?: SubscriptionCreateParams.CheckoutOptions;
     /**
-     * Additional metadata for the subscription
+     * The ISO 3166-1 alpha-2 country code for billing
      */
-    metadata?: {
-        [key: string]: string;
-    };
+    billingCountryCode?: string | null;
     /**
-     * Optional paying customer ID for split billing scenarios
+     * Billing cycle anchor behavior for the subscription
      */
-    payingCustomerId?: string | null;
+    billingCycleAnchor?: 'UNCHANGED' | 'NOW';
     /**
-     * Optional resource ID for multi-instance subscriptions
+     * External billing system identifier
      */
-    resourceId?: string | null;
-    trialOverrideConfiguration?: SubscriptionCreateParams.TrialOverrideConfiguration;
-}
-export declare namespace SubscriptionCreateParams {
-    interface CheckoutOptions {
-        /**
-         * URL to redirect to if checkout is canceled
-         */
-        cancelUrl: string;
-        /**
-         * URL to redirect to after successful checkout
-         */
-        successUrl: string;
-        /**
-         * Allow promotional codes during checkout
-         */
-        allowPromoCodes?: boolean;
-        /**
-         * Allow tax ID collection during checkout
-         */
-        allowTaxIdCollection?: boolean;
-        /**
-         * Collect billing address during checkout
-         */
-        collectBillingAddress?: boolean;
-        /**
-         * Collect phone number during checkout
-         */
-        collectPhoneNumber?: boolean;
-        /**
-         * Optional reference ID for the checkout session
-         */
-        referenceId?: string | null;
-    }
-    interface TrialOverrideConfiguration {
-        /**
-         * Whether the subscription should start with a trial period
-         */
-        isTrial: boolean;
-        /**
-         * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
-         */
-        trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
-        /**
-         * Custom trial end date
-         */
-        trialEndDate?: string;
-    }
-}
-export interface SubscriptionListParams extends MyCursorIDPageParams {
+    billingId?: string | null;
+    billingInformation?: SubscriptionProvisionParams.BillingInformation;
     /**
-     * Filter by customer ID
+     * Billing period (MONTHLY or ANNUALLY)
      */
-    customerId?: string;
+    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    budget?: SubscriptionProvisionParams.Budget | null;
+    charges?: Array<SubscriptionProvisionParams.Charge>;
     /**
-     * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-     * ACTIVE,IN_TRIAL)
+     * Checkout page configuration for payment collection
      */
-    status?: string;
-}
-export interface SubscriptionDelegateParams {
+    checkoutOptions?: SubscriptionProvisionParams.CheckoutOptions;
+    entitlements?: Array<SubscriptionProvisionParams.Feature | SubscriptionProvisionParams.Credit>;
     /**
-     * The customer ID to delegate the subscription to
+     * Additional metadata for the subscription
      */
-    targetCustomerId: string;
-}
-export interface SubscriptionMigrateParams {
+    metadata?: {
+        [key: string]: string;
+    };
     /**
-     * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+     * Minimum spend amount
      */
-    subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
-}
-export interface SubscriptionPreviewParams {
+    minimumSpend?: SubscriptionProvisionParams.MinimumSpend | null;
+    /**
+     * Optional paying customer ID for split billing scenarios
+     */
+    payingCustomerId?: string | null;
+    /**
+     * How payments should be collected for this subscription
+     */
+    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE';
+    priceOverrides?: Array<SubscriptionProvisionParams.PriceOverride>;
+    /**
+     * Optional resource ID for multi-instance subscriptions
+     */
+    resourceId?: string | null;
     /**
-     * Customer ID
+     * Salesforce ID
      */
-    customerId: string;
+    salesforceId?: string | null;
     /**
-     * Plan ID
+     * Strategy for scheduling subscription changes
      */
-    planId: string;
-    addons?: Array<SubscriptionPreviewParams.Addon>;
-    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
-    billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
-    billingCountryCode?: string;
-    billingInformation?: SubscriptionPreviewParams.BillingInformation;
-    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
-    charges?: Array<SubscriptionPreviewParams.Charge>;
-    payingCustomerId?: string;
-    resourceId?: string;
     scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
     /**
      * Subscription start date
      */
     startDate?: string;
-    trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+    /**
+     * Trial period override settings
+     */
+    trialOverrideConfiguration?: SubscriptionProvisionParams.TrialOverrideConfiguration;
     unitQuantity?: number;
 }
-export declare namespace SubscriptionPreviewParams {
+export declare namespace SubscriptionProvisionParams {
+    /**
+     * Addon configuration
+     */
     interface Addon {
         /**
          * Addon ID
          */
-        addonId: string;
-        quantity?: number;
+        id: string;
+        /**
+         * Number of addon instances
+         */
+        quantity: number;
     }
+    /**
+     * Coupon configuration
+     */
     interface AppliedCoupon {
+        /**
+         * Billing provider coupon ID
+         */
         billingCouponId?: string;
+        /**
+         * Coupon timing configuration
+         */
         configuration?: AppliedCoupon.Configuration;
+        /**
+         * Stigg coupon ID
+         */
         couponId?: string;
+        /**
+         * Ad-hoc discount configuration
+         */
         discount?: AppliedCoupon.Discount;
+        /**
+         * Promotion code to apply
+         */
         promotionCode?: string;
     }
     namespace AppliedCoupon {
+        /**
+         * Coupon timing configuration
+         */
         interface Configuration {
             /**
              * Coupon start date
              */
             startDate?: string;
         }
+        /**
+         * Ad-hoc discount configuration
+         */
         interface Discount {
+            /**
+             * Fixed amounts off by currency
+             */
             amountsOff?: Array<Discount.AmountsOff> | null;
+            /**
+             * Ad-hoc discount
+             */
             description?: string;
+            /**
+             * Duration in months
+             */
             durationInMonths?: number;
+            /**
+             * Discount name
+             */
             name?: string;
+            /**
+             * Percentage discount
+             */
             percentOff?: number;
         }
         namespace Discount {
@@ -871,27 +2560,58 @@ export declare namespace SubscriptionPreviewParams {
             }
         }
     }
-    interface BillableFeature {
+    interface BillingInformation {
         /**
-         * Feature ID
+         * Billing address for the subscription
          */
-        featureId: string;
-        quantity: number;
-    }
-    interface BillingInformation {
         billingAddress?: BillingInformation.BillingAddress;
-        chargeOnBehalfOfAccount?: string;
-        integrationId?: string;
+        /**
+         * Stripe Connect account to charge on behalf of
+         */
+        chargeOnBehalfOfAccount?: string | null;
+        /**
+         * Billing integration identifier
+         */
+        integrationId?: string | null;
+        /**
+         * Number of days until invoice is due
+         */
         invoiceDaysUntilDue?: number;
+        /**
+         * Whether the subscription is backdated
+         */
         isBackdated?: boolean;
+        /**
+         * Whether the invoice is marked as paid
+         */
         isInvoicePaid?: boolean;
-        metadata?: unknown;
+        /**
+         * Additional metadata for the subscription
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * How to handle proration for billing changes
+         */
         prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+        /**
+         * Customer tax identification numbers
+         */
         taxIds?: Array<BillingInformation.TaxID>;
+        /**
+         * Tax percentage (0-100)
+         */
         taxPercentage?: number;
+        /**
+         * Tax rate identifiers to apply
+         */
         taxRateIds?: Array<string>;
     }
     namespace BillingInformation {
+        /**
+         * Billing address for the subscription
+         */
         interface BillingAddress {
             city?: string;
             country?: string;
@@ -901,36 +2621,302 @@ export declare namespace SubscriptionPreviewParams {
             state?: string;
         }
         interface TaxID {
+            /**
+             * The type of tax exemption identifier, such as VAT.
+             */
             type: string;
+            /**
+             * The actual tax identifier value
+             */
             value: string;
         }
     }
+    interface Budget {
+        /**
+         * Whether the budget is a soft limit
+         */
+        hasSoftLimit: boolean;
+        /**
+         * Maximum spending limit
+         */
+        limit: number;
+    }
+    /**
+     * Charge item
+     */
     interface Charge {
         /**
          * Charge ID
          */
         id: string;
+        /**
+         * Charge quantity
+         */
         quantity: number;
+        /**
+         * Charge type
+         */
         type: 'FEATURE' | 'CREDIT';
     }
+    /**
+     * Checkout page configuration for payment collection
+     */
+    interface CheckoutOptions {
+        /**
+         * URL to redirect to if checkout is canceled
+         */
+        cancelUrl: string;
+        /**
+         * URL to redirect to after successful checkout
+         */
+        successUrl: string;
+        /**
+         * Allow promotional codes during checkout
+         */
+        allowPromoCodes?: boolean;
+        /**
+         * Allow tax ID collection during checkout
+         */
+        allowTaxIdCollection?: boolean;
+        /**
+         * Collect billing address during checkout
+         */
+        collectBillingAddress?: boolean;
+        /**
+         * Collect phone number during checkout
+         */
+        collectPhoneNumber?: boolean;
+        /**
+         * Optional reference ID for the checkout session
+         */
+        referenceId?: string | null;
+    }
+    /**
+     * Feature entitlement configuration for a subscription
+     */
+    interface Feature {
+        /**
+         * The feature ID to attach the entitlement to
+         */
+        id: string;
+        /**
+         * SubscriptionFeatureEntitlementRequest
+         */
+        type: 'FEATURE';
+        /**
+         * Whether the usage limit is a soft limit
+         */
+        hasSoftLimit?: boolean;
+        /**
+         * Whether usage is unlimited
+         */
+        hasUnlimitedUsage?: boolean;
+        /**
+         * Configuration for monthly reset period
+         */
+        monthlyResetPeriodConfiguration?: Feature.MonthlyResetPeriodConfiguration | null;
+        /**
+         * Period at which usage resets
+         */
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR';
+        /**
+         * Maximum allowed usage for the feature
+         */
+        usageLimit?: number;
+        /**
+         * Configuration for weekly reset period
+         */
+        weeklyResetPeriodConfiguration?: Feature.WeeklyResetPeriodConfiguration | null;
+        /**
+         * Configuration for yearly reset period
+         */
+        yearlyResetPeriodConfiguration?: Feature.YearlyResetPeriodConfiguration | null;
+    }
+    namespace Feature {
+        /**
+         * Configuration for monthly reset period
+         */
+        interface MonthlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Configuration for weekly reset period
+         */
+        interface WeeklyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+        /**
+         * Configuration for yearly reset period
+         */
+        interface YearlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+    }
+    /**
+     * Credit entitlement configuration for a subscription
+     */
+    interface Credit {
+        /**
+         * The custom currency ID for the credit entitlement
+         */
+        id: string;
+        /**
+         * Credit grant amount
+         */
+        amount: number;
+        /**
+         * Credit grant cadence (MONTH or YEAR)
+         */
+        cadence: 'MONTH' | 'YEAR';
+        /**
+         * SubscriptionCreditEntitlementRequest
+         */
+        type: 'CREDIT';
+    }
+    /**
+     * Minimum spend amount
+     */
+    interface MinimumSpend {
+        /**
+         * The price amount
+         */
+        amount?: number;
+        /**
+         * The price currency
+         */
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+    }
+    interface PriceOverride {
+        /**
+         * Addon identifier for the price override
+         */
+        addonId?: string | null;
+        /**
+         * The price amount
+         */
+        amount?: number;
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string;
+        /**
+         * Block size for pricing
+         */
+        blockSize?: number;
+        creditGrantCadence?: 'BEGINNING_OF_BILLING_PERIOD' | 'MONTHLY';
+        creditRate?: PriceOverride.CreditRate;
+        /**
+         * The price currency
+         */
+        currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+        /**
+         * Feature identifier for the price override
+         */
+        featureId?: string | null;
+        /**
+         * Pricing tiers configuration
+         */
+        tiers?: Array<PriceOverride.Tier>;
+    }
+    namespace PriceOverride {
+        interface CreditRate {
+            /**
+             * The credit rate amount
+             */
+            amount: number;
+            /**
+             * The custom currency refId for the credit rate
+             */
+            currencyId: string;
+            /**
+             * A custom formula for calculating cost based on single event dimensions
+             */
+            costFormula?: string | null;
+        }
+        interface Tier {
+            /**
+             * The flat fee price of the price tier
+             */
+            flatPrice?: Tier.FlatPrice;
+            /**
+             * The unit price of the price tier
+             */
+            unitPrice?: Tier.UnitPrice;
+            /**
+             * The up to quantity of the price tier
+             */
+            upTo?: number;
+        }
+        namespace Tier {
+            /**
+             * The flat fee price of the price tier
+             */
+            interface FlatPrice {
+                /**
+                 * The price amount
+                 */
+                amount: number;
+                /**
+                 * The price currency
+                 */
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+            /**
+             * The unit price of the price tier
+             */
+            interface UnitPrice {
+                /**
+                 * The price amount
+                 */
+                amount: number;
+                /**
+                 * The price currency
+                 */
+                currency: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+        }
+    }
+    /**
+     * Trial period override settings
+     */
     interface TrialOverrideConfiguration {
+        /**
+         * Whether the subscription should start with a trial period
+         */
         isTrial: boolean;
+        /**
+         * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+         */
         trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
         /**
-         * Trial end date
+         * Custom trial end date
          */
         trialEndDate?: string;
     }
 }
 export interface SubscriptionTransferParams {
     /**
-     * The resource ID to transfer the subscription to. The destination resource must
-     * belong to the same customer.
+     * Resource ID to transfer the subscription to
      */
     destinationResourceId: string;
 }
 export declare namespace Subscriptions {
-    export { type SubscriptionCreateResponse as SubscriptionCreateResponse, type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionDelegateResponse as SubscriptionDelegateResponse, type SubscriptionMigrateResponse as SubscriptionMigrateResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionTransferResponse as SubscriptionTransferResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
-    export { FutureUpdate as FutureUpdate, type FutureUpdateCancelPendingPaymentResponse as FutureUpdateCancelPendingPaymentResponse, type FutureUpdateCancelScheduleResponse as FutureUpdateCancelScheduleResponse, };
+    export { type Subscription as Subscription, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionImportResponse as SubscriptionImportResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionProvisionResponse as SubscriptionProvisionResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, type SubscriptionUpdateParams as SubscriptionUpdateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionCancelParams as SubscriptionCancelParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionImportParams as SubscriptionImportParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionProvisionParams as SubscriptionProvisionParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
+    export { FutureUpdateAPIFutureUpdate as FutureUpdate, type CancelSubscription as CancelSubscription };
+    export { Usage as Usage, type UsageChargeUsageResponse as UsageChargeUsageResponse, type UsageSyncResponse as UsageSyncResponse, type UsageChargeUsageParams as UsageChargeUsageParams, };
+    export { Invoice as Invoice, type InvoiceMarkAsPaidResponse as InvoiceMarkAsPaidResponse };
 }
 //# sourceMappingURL=subscriptions.d.ts.map