@stigg/typescript 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -8,6 +8,7 @@ import {
   FutureUpdateCancelScheduleResponse,
 } from './future-update';
 import { APIPromise } from '../../../core/api-promise';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
@@ -15,31 +16,34 @@ export class Subscriptions extends APIResource {
   futureUpdate: FutureUpdateAPI.FutureUpdate = new FutureUpdateAPI.FutureUpdate(this._client);
 
   /**
-   * Create a new Subscription
+   * Provision subscription
    */
   create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse> {
     return this._client.post('/api/v1/subscriptions', { body, ...options });
   }
 
   /**
-   * Get a single Subscription by id
+   * Get a single subscription by ID
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse> {
     return this._client.get(path`/api/v1/subscriptions/${id}`, options);
   }
 
   /**
-   * Get a list of Subscriptions
+   * Get a list of subscriptions
    */
   list(
     query: SubscriptionListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<SubscriptionListResponse> {
-    return this._client.get('/api/v1/subscriptions', { query, ...options });
+  ): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse> {
+    return this._client.getAPIList('/api/v1/subscriptions', MyCursorIDPage<SubscriptionListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
-   * Perform delegate on a Subscription
+   * Delegate subscription payment to customer
    */
   delegate(
     id: string,
@@ -50,7 +54,7 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Perform migrate to latest plan version on a Subscription
+   * Migrate subscription to latest plan version
    */
   migrate(
     id: string,
@@ -61,7 +65,7 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Create a new Subscription Preview
+   * Preview subscription
    */
   preview(
     body: SubscriptionPreviewParams,
@@ -71,7 +75,7 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Perform transfer to resource on a Subscription
+   * Transfer subscription to resource
    */
   transfer(
     id: string,
@@ -82,17 +86,30 @@ export class Subscriptions extends APIResource {
   }
 }
 
+export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
+
+/**
+ * Response object
+ */
 export interface SubscriptionCreateResponse {
+  /**
+   * Provisioning result with status and subscription or checkout URL.
+   */
   data: SubscriptionCreateResponse.Data;
 }
 
 export namespace SubscriptionCreateResponse {
+  /**
+   * Provisioning result with status and subscription or checkout URL.
+   */
   export interface Data {
     /**
      * Unique identifier for the provisioned subscription
      */
     id: string;
 
+    entitlements: Array<Data.Entitlement>;
+
     /**
      * Provision status: SUCCESS or PAYMENT_REQUIRED
      */
@@ -113,10 +130,61 @@ export namespace SubscriptionCreateResponse {
      */
     isScheduled?: boolean;
 
+    /**
+     * Created subscription (when status is SUCCESS)
+     */
     subscription?: Data.Subscription;
   }
 
   export namespace Data {
+    export interface Entitlement {
+      accessDeniedReason?: string | null;
+
+      currentUsage?: number;
+
+      /**
+       * entitlement updated at
+       */
+      entitlementUpdatedAt?: string | null;
+
+      feature?: Entitlement.Feature | null;
+
+      hasUnlimitedUsage?: boolean | null;
+
+      isGranted?: boolean;
+
+      resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+
+      usageLimit?: number | null;
+
+      /**
+       * usage period anchor
+       */
+      usagePeriodAnchor?: string | null;
+
+      /**
+       * usage period end
+       */
+      usagePeriodEnd?: string | null;
+
+      /**
+       * usage period start
+       */
+      usagePeriodStart?: string | null;
+    }
+
+    export namespace Entitlement {
+      export interface Feature {
+        /**
+         * Feature ID
+         */
+        refId: string;
+      }
+    }
+
+    /**
+     * Created subscription (when status is SUCCESS)
+     */
     export interface Subscription {
       /**
        * Subscription ID
@@ -220,6 +288,8 @@ export namespace SubscriptionCreateResponse {
        */
       paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+      prices?: Array<Subscription.Price>;
+
       /**
        * Resource ID
        */
@@ -230,14 +300,486 @@ export namespace SubscriptionCreateResponse {
        */
       trialEndDate?: string | null;
     }
+
+    export namespace Subscription {
+      export interface Price {
+        /**
+         * Addon identifier for the price override
+         */
+        addonId?: string | null;
+
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+
+        /**
+         * Block size for pricing
+         */
+        blockSize?: number;
+
+        /**
+         * Feature identifier for the price override
+         */
+        featureId?: string | null;
+
+        /**
+         * Override price amount
+         */
+        price?: Price.Price;
+
+        /**
+         * Pricing tiers configuration
+         */
+        tiers?: Array<Price.Tier>;
+      }
+
+      export namespace Price {
+        /**
+         * Override price amount
+         */
+        export interface Price {
+          /**
+           * The price amount
+           */
+          amount?: number;
+
+          /**
+           * The billing country code of the price
+           */
+          billingCountryCode?: string | null;
+
+          /**
+           * 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';
+        }
+
+        export 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;
+        }
+
+        export namespace Tier {
+          /**
+           * The flat fee price of the price tier
+           */
+          export interface FlatPrice {
+            /**
+             * The price amount
+             */
+            amount?: number;
+
+            /**
+             * The billing country code of the price
+             */
+            billingCountryCode?: string | null;
+
+            /**
+             * 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
+           */
+          export interface UnitPrice {
+            /**
+             * The price amount
+             */
+            amount?: number;
+
+            /**
+             * The billing country code of the price
+             */
+            billingCountryCode?: string | null;
+
+            /**
+             * 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';
+          }
+        }
+      }
+    }
   }
 }
 
+/**
+ * Response object
+ */
 export interface SubscriptionRetrieveResponse {
+  /**
+   * Customer subscription to a plan
+   */
   data: SubscriptionRetrieveResponse.Data;
 }
 
 export namespace SubscriptionRetrieveResponse {
+  /**
+   * Customer subscription to a plan
+   */
   export interface Data {
     /**
      * Subscription ID
@@ -341,6 +883,8 @@ export namespace SubscriptionRetrieveResponse {
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+    prices?: Array<Data.Price>;
+
     /**
      * Resource ID
      */
@@ -351,138 +895,183 @@ export namespace SubscriptionRetrieveResponse {
      */
     trialEndDate?: string | null;
   }
+
+  export namespace Data {
+    export interface Price {
+      /**
+       * Price ID
+       */
+      id: string;
+
+      /**
+       * Creation timestamp
+       */
+      createdAt: string;
+
+      /**
+       * Last update timestamp
+       */
+      updatedAt: string;
+
+      [k: string]: unknown;
+    }
+  }
 }
 
+/**
+ * Customer subscription to a plan
+ */
 export interface SubscriptionListResponse {
-  data: Array<SubscriptionListResponse.Data>;
-}
+  /**
+   * Subscription ID
+   */
+  id: string;
 
-export namespace SubscriptionListResponse {
-  export interface Data {
-    /**
-     * Subscription ID
-     */
-    id: string;
+  /**
+   * Billing ID
+   */
+  billingId: string | null;
 
-    /**
-     * Billing ID
-     */
-    billingId: string | null;
+  /**
+   * Created at
+   */
+  createdAt: string;
 
-    /**
-     * Created at
-     */
-    createdAt: string;
+  /**
+   * Customer ID
+   */
+  customerId: string;
 
-    /**
-     * Cursor ID for query pagination
-     */
-    cursorId: string;
+  /**
+   * Payment collection
+   */
+  paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
 
-    /**
-     * Customer ID
-     */
-    customerId: string;
+  /**
+   * Plan ID
+   */
+  planId: string;
 
-    /**
-     * Payment collection
-     */
-    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+  /**
+   * Pricing type
+   */
+  pricingType: 'FREE' | 'PAID' | 'CUSTOM';
 
-    /**
-     * Plan ID
-     */
-    planId: string;
+  /**
+   * Subscription start date
+   */
+  startDate: string;
 
-    /**
-     * Pricing type
-     */
-    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+  /**
+   * Subscription status
+   */
+  status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
 
-    /**
-     * Subscription start date
-     */
-    startDate: string;
+  /**
+   * Subscription cancellation date
+   */
+  cancellationDate?: string | null;
 
-    /**
-     * Subscription status
-     */
-    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+  /**
+   * 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;
 
-    /**
-     * Subscription cancellation date
-     */
-    cancellationDate?: string | null;
+  /**
+   * End of the current billing period
+   */
+  currentBillingPeriodEnd?: 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;
+  /**
+   * Start of the current billing period
+   */
+  currentBillingPeriodStart?: string | null;
 
-    /**
-     * End of the current billing period
-     */
-    currentBillingPeriodEnd?: string | null;
+  /**
+   * Subscription effective end date
+   */
+  effectiveEndDate?: string | null;
 
-    /**
-     * Start of the current billing period
-     */
-    currentBillingPeriodStart?: string | null;
+  /**
+   * Subscription end date
+   */
+  endDate?: string | null;
 
-    /**
-     * Subscription effective end date
-     */
-    effectiveEndDate?: string | null;
+  /**
+   * Additional metadata for the subscription
+   */
+  metadata?: { [key: string]: string };
 
-    /**
-     * Subscription end date
-     */
-    endDate?: string | null;
+  /**
+   * Paying customer ID for delegated billing
+   */
+  payingCustomerId?: string | null;
 
-    /**
-     * Additional metadata for the subscription
-     */
-    metadata?: { [key: string]: string };
+  /**
+   * The method used to collect payments for a subscription
+   */
+  paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
-    /**
-     * Paying customer ID for delegated billing
-     */
-    payingCustomerId?: string | null;
+  prices?: Array<SubscriptionListResponse.Price>;
+
+  /**
+   * Resource ID
+   */
+  resourceId?: string | null;
+
+  /**
+   * Subscription trial end date
+   */
+  trialEndDate?: string | null;
+}
 
+export namespace SubscriptionListResponse {
+  export interface Price {
     /**
-     * The method used to collect payments for a subscription
+     * Price ID
      */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+    id: string;
 
     /**
-     * Resource ID
+     * Creation timestamp
      */
-    resourceId?: string | null;
+    createdAt: string;
 
     /**
-     * Subscription trial end date
+     * Last update timestamp
      */
-    trialEndDate?: string | null;
+    updatedAt: string;
+
+    [k: string]: unknown;
   }
 }
 
+/**
+ * Response object
+ */
 export interface SubscriptionDelegateResponse {
+  /**
+   * Customer subscription to a plan
+   */
   data: SubscriptionDelegateResponse.Data;
 }
 
 export namespace SubscriptionDelegateResponse {
+  /**
+   * Customer subscription to a plan
+   */
   export interface Data {
     /**
      * Subscription ID
@@ -586,6 +1175,8 @@ export namespace SubscriptionDelegateResponse {
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+    prices?: Array<Data.Price>;
+
     /**
      * Resource ID
      */
@@ -596,13 +1187,43 @@ export namespace SubscriptionDelegateResponse {
      */
     trialEndDate?: string | null;
   }
+
+  export namespace Data {
+    export interface Price {
+      /**
+       * Price ID
+       */
+      id: string;
+
+      /**
+       * Creation timestamp
+       */
+      createdAt: string;
+
+      /**
+       * Last update timestamp
+       */
+      updatedAt: string;
+
+      [k: string]: unknown;
+    }
+  }
 }
 
+/**
+ * Response object
+ */
 export interface SubscriptionMigrateResponse {
+  /**
+   * Customer subscription to a plan
+   */
   data: SubscriptionMigrateResponse.Data;
 }
 
 export namespace SubscriptionMigrateResponse {
+  /**
+   * Customer subscription to a plan
+   */
   export interface Data {
     /**
      * Subscription ID
@@ -706,6 +1327,8 @@ export namespace SubscriptionMigrateResponse {
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+    prices?: Array<Data.Price>;
+
     /**
      * Resource ID
      */
@@ -716,49 +1339,130 @@ export namespace SubscriptionMigrateResponse {
      */
     trialEndDate?: string | null;
   }
-}
 
-export interface SubscriptionPreviewResponse {
-  data: SubscriptionPreviewResponse.Data;
-}
+  export namespace Data {
+    export interface Price {
+      /**
+       * Price ID
+       */
+      id: string;
+
+      /**
+       * Creation timestamp
+       */
+      createdAt: string;
+
+      /**
+       * Last update timestamp
+       */
+      updatedAt: string;
+
+      [k: string]: unknown;
+    }
+  }
+}
+
+/**
+ * Response object
+ */
+export interface SubscriptionPreviewResponse {
+  /**
+   * Pricing preview with invoices
+   */
+  data: SubscriptionPreviewResponse.Data;
+}
 
 export namespace SubscriptionPreviewResponse {
+  /**
+   * Pricing preview with invoices
+   */
   export 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;
   }
 
   export namespace Data {
+    /**
+     * Invoice due immediately
+     */
     export 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;
     }
 
     export namespace ImmediateInvoice {
+      /**
+       * Billing period covered
+       */
       export interface BillingPeriodRange {
         /**
          * Billing period end date
@@ -771,35 +1475,80 @@ export namespace SubscriptionPreviewResponse {
         start: string;
       }
 
+      /**
+       * Discount breakdown
+       */
       export interface DiscountDetails {
+        /**
+         * Promo code used
+         */
         code?: string;
 
+        /**
+         * Fixed discount amount
+         */
         fixedAmount?: number;
 
+        /**
+         * Percentage discount
+         */
         percentage?: number;
       }
 
+      /**
+       * Applied discount amount
+       */
       export interface Discount {
+        /**
+         * Discount amount
+         */
         amount: number;
 
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Discount description
+         */
         description: string;
       }
 
+      /**
+       * Invoice line item
+       */
       export 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
+     */
     export interface BillingPeriodRange {
       /**
        * Billing period end date
@@ -812,33 +1561,75 @@ export namespace SubscriptionPreviewResponse {
       start?: string;
     }
 
+    /**
+     * Free item in subscription
+     */
     export interface FreeItem {
+      /**
+       * Addon ID
+       */
       addonId: string;
 
+      /**
+       * Quantity
+       */
       quantity: number;
     }
 
+    /**
+     * Recurring invoice preview
+     */
     export 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;
     }
 
     export namespace RecurringInvoice {
+      /**
+       * Billing period covered
+       */
       export interface BillingPeriodRange {
         /**
          * Billing period end date
@@ -851,42 +1642,93 @@ export namespace SubscriptionPreviewResponse {
         start: string;
       }
 
+      /**
+       * Discount breakdown
+       */
       export interface DiscountDetails {
+        /**
+         * Promo code used
+         */
         code?: string;
 
+        /**
+         * Fixed discount amount
+         */
         fixedAmount?: number;
 
+        /**
+         * Percentage discount
+         */
         percentage?: number;
       }
 
+      /**
+       * Applied discount amount
+       */
       export interface Discount {
+        /**
+         * Discount amount
+         */
         amount: number;
 
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Discount description
+         */
         description: string;
       }
 
+      /**
+       * Invoice line item
+       */
       export 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 SubscriptionTransferResponse {
+  /**
+   * Customer subscription to a plan
+   */
   data: SubscriptionTransferResponse.Data;
 }
 
 export namespace SubscriptionTransferResponse {
+  /**
+   * Customer subscription to a plan
+   */
   export interface Data {
     /**
      * Subscription ID
@@ -990,6 +1832,8 @@ export namespace SubscriptionTransferResponse {
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+    prices?: Array<Data.Price>;
+
     /**
      * Resource ID
      */
@@ -1000,6 +1844,27 @@ export namespace SubscriptionTransferResponse {
      */
     trialEndDate?: string | null;
   }
+
+  export namespace Data {
+    export interface Price {
+      /**
+       * Price ID
+       */
+      id: string;
+
+      /**
+       * Creation timestamp
+       */
+      createdAt: string;
+
+      /**
+       * Last update timestamp
+       */
+      updatedAt: string;
+
+      [k: string]: unknown;
+    }
+  }
 }
 
 export interface SubscriptionCreateParams {
@@ -1016,15 +1881,44 @@ export interface SubscriptionCreateParams {
   /**
    * Unique identifier for the subscription
    */
-  id?: string | null;
+  id?: string;
+
+  addons?: Array<SubscriptionCreateParams.Addon>;
+
+  /**
+   * Coupon configuration
+   */
+  appliedCoupon?: SubscriptionCreateParams.AppliedCoupon;
 
   /**
    * Whether to wait for payment confirmation before returning the subscription
    */
   awaitPaymentConfirmation?: boolean;
 
+  /**
+   * The ISO 3166-1 alpha-2 country code for billing
+   */
+  billingCountryCode?: string | null;
+
+  /**
+   * External billing system identifier
+   */
+  billingId?: string | null;
+
+  billingInformation?: SubscriptionCreateParams.BillingInformation;
+
+  /**
+   * Billing period (MONTHLY or ANNUALLY)
+   */
   billingPeriod?: 'MONTHLY' | 'ANNUALLY';
 
+  budget?: SubscriptionCreateParams.Budget | null;
+
+  charges?: Array<SubscriptionCreateParams.Charge>;
+
+  /**
+   * Checkout page configuration for payment collection
+   */
   checkoutOptions?: SubscriptionCreateParams.CheckoutOptions;
 
   /**
@@ -1032,113 +1926,1108 @@ export interface SubscriptionCreateParams {
    */
   metadata?: { [key: string]: string };
 
+  minimumSpend?: SubscriptionCreateParams.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<SubscriptionCreateParams.PriceOverride>;
+
   /**
    * Optional resource ID for multi-instance subscriptions
    */
   resourceId?: string | null;
 
+  /**
+   * Salesforce ID
+   */
+  salesforceId?: string | null;
+
+  /**
+   * Strategy for scheduling subscription changes
+   */
+  scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+
+  /**
+   * Subscription start date
+   */
+  startDate?: string;
+
+  subscriptionEntitlements?: Array<SubscriptionCreateParams.SubscriptionEntitlement>;
+
+  /**
+   * Trial period override settings
+   */
   trialOverrideConfiguration?: SubscriptionCreateParams.TrialOverrideConfiguration;
+
+  unitQuantity?: number;
 }
 
 export namespace SubscriptionCreateParams {
-  export interface CheckoutOptions {
+  export interface Addon {
     /**
-     * URL to redirect to if checkout is canceled
+     * Addon identifier
      */
-    cancelUrl: string;
+    addonId: string;
 
     /**
-     * URL to redirect to after successful checkout
+     * Number of addon units
      */
-    successUrl: string;
+    quantity?: number;
+  }
 
+  /**
+   * Coupon configuration
+   */
+  export interface AppliedCoupon {
     /**
-     * Allow promotional codes during checkout
+     * Billing provider coupon ID
      */
-    allowPromoCodes?: boolean;
+    billingCouponId?: string;
 
     /**
-     * Allow tax ID collection during checkout
+     * Coupon timing configuration
      */
-    allowTaxIdCollection?: boolean;
+    configuration?: AppliedCoupon.Configuration;
 
     /**
-     * Collect billing address during checkout
+     * Stigg coupon ID
      */
-    collectBillingAddress?: boolean;
+    couponId?: string;
 
     /**
-     * Collect phone number during checkout
+     * Ad-hoc discount configuration
      */
-    collectPhoneNumber?: boolean;
+    discount?: AppliedCoupon.Discount;
 
     /**
-     * Optional reference ID for the checkout session
+     * Promotion code to apply
      */
-    referenceId?: string | null;
+    promotionCode?: string;
   }
 
-  export interface TrialOverrideConfiguration {
+  export namespace AppliedCoupon {
     /**
-     * Whether the subscription should start with a trial period
+     * Coupon timing configuration
      */
-    isTrial: boolean;
+    export interface Configuration {
+      /**
+       * Coupon start date
+       */
+      startDate?: string;
+    }
 
     /**
-     * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+     * Ad-hoc discount configuration
      */
-    trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+    export interface Discount {
+      /**
+       * Fixed amounts off by currency
+       */
+      amountsOff?: Array<Discount.AmountsOff> | null;
 
-    /**
-     * Custom trial end date
-     */
-    trialEndDate?: string;
-  }
-}
+      /**
+       * Ad-hoc discount
+       */
+      description?: string;
 
-export interface SubscriptionListParams {
-  /**
-   * Filter by customer ID
+      /**
+       * Duration in months
+       */
+      durationInMonths?: number;
+
+      /**
+       * Discount name
+       */
+      name?: string;
+
+      /**
+       * Percentage discount
+       */
+      percentOff?: number;
+    }
+
+    export namespace Discount {
+      export 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';
+      }
+    }
+  }
+
+  export interface BillingInformation {
+    /**
+     * Billing address for the subscription
+     */
+    billingAddress?: BillingInformation.BillingAddress;
+
+    /**
+     * 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;
+
+    /**
+     * 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>;
+  }
+
+  export namespace BillingInformation {
+    /**
+     * Billing address for the subscription
+     */
+    export interface BillingAddress {
+      city?: string;
+
+      country?: string;
+
+      line1?: string;
+
+      line2?: string;
+
+      postalCode?: string;
+
+      state?: string;
+    }
+
+    export interface TaxID {
+      /**
+       * The type of tax exemption identifier, such as VAT.
+       */
+      type: string;
+
+      /**
+       * The actual tax identifier value
+       */
+      value: string;
+    }
+  }
+
+  export interface Budget {
+    /**
+     * Whether the budget is a soft limit
+     */
+    hasSoftLimit: boolean;
+
+    /**
+     * Maximum spending limit
+     */
+    limit: number;
+  }
+
+  /**
+   * Charge item
    */
-  customerId?: string;
+  export interface Charge {
+    /**
+     * Charge ID
+     */
+    id: string;
+
+    /**
+     * Charge quantity
+     */
+    quantity: number;
+
+    /**
+     * Charge type
+     */
+    type: 'FEATURE' | 'CREDIT';
+  }
+
+  /**
+   * Checkout page configuration for payment collection
+   */
+  export 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;
+  }
+
+  export interface MinimumSpend {
+    /**
+     * Minimum spend amount
+     */
+    minimum?: MinimumSpend.Minimum | null;
+  }
+
+  export namespace MinimumSpend {
+    /**
+     * Minimum spend amount
+     */
+    export interface Minimum {
+      /**
+       * The price amount
+       */
+      amount?: number;
+
+      /**
+       * The billing country code of the price
+       */
+      billingCountryCode?: string | null;
+
+      /**
+       * 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';
+    }
+  }
+
+  export interface PriceOverride {
+    /**
+     * Addon identifier for the price override
+     */
+    addonId?: string | null;
+
+    /**
+     * Whether this is a base charge override
+     */
+    baseCharge?: boolean;
+
+    /**
+     * Block size for pricing
+     */
+    blockSize?: number;
+
+    creditGrantCadence?: 'BEGINNING_OF_BILLING_PERIOD' | 'MONTHLY';
+
+    creditRate?: PriceOverride.CreditRate;
+
+    /**
+     * Feature identifier for the price override
+     */
+    featureId?: string | null;
+
+    /**
+     * Override price amount
+     */
+    price?: PriceOverride.Price;
+
+    /**
+     * Pricing tiers configuration
+     */
+    tiers?: Array<PriceOverride.Tier>;
+  }
+
+  export namespace PriceOverride {
+    export 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;
+    }
+
+    /**
+     * Override price amount
+     */
+    export interface Price {
+      /**
+       * The price amount
+       */
+      amount?: number;
+
+      /**
+       * The billing country code of the price
+       */
+      billingCountryCode?: string | null;
+
+      /**
+       * 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';
+    }
+
+    export 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;
+    }
+
+    export namespace Tier {
+      /**
+       * The flat fee price of the price tier
+       */
+      export interface FlatPrice {
+        /**
+         * The price amount
+         */
+        amount?: number;
+
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string | null;
+
+        /**
+         * 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
+       */
+      export interface UnitPrice {
+        /**
+         * The price amount
+         */
+        amount?: number;
+
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string | null;
+
+        /**
+         * 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';
+      }
+    }
+  }
 
-  /**
-   * Ending before this UUID for pagination
-   */
-  endingBefore?: string;
+  export interface SubscriptionEntitlement {
+    /**
+     * Feature ID
+     */
+    featureId: string;
+
+    usageLimit: number;
+
+    isGranted?: boolean;
+  }
 
   /**
-   * Items per page
+   * Trial period override settings
    */
-  limit?: number;
+  export 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 {
   /**
-   * Starting after this UUID for pagination
+   * Filter by customer ID
    */
-  startingAfter?: string;
+  customerId?: string;
 
   /**
-   * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-   * ACTIVE,IN_TRIAL)
+   * Filter by status (comma-separated)
    */
   status?: string;
 }
 
 export interface SubscriptionDelegateParams {
   /**
-   * The customer ID to delegate the subscription to
+   * 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 SubscriptionMigrateParams {
   /**
-   * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+   * When to migrate (immediate or period end)
    */
   subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
 }
@@ -1154,24 +3043,54 @@ export interface SubscriptionPreviewParams {
    */
   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 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';
 
   /**
@@ -1179,34 +3098,67 @@ export interface SubscriptionPreviewParams {
    */
   startDate?: string;
 
+  /**
+   * Trial period override settings
+   */
   trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
 
+  /**
+   * Unit quantity for per-unit pricing
+   */
   unitQuantity?: number;
 }
 
 export namespace SubscriptionPreviewParams {
+  /**
+   * Addon configuration
+   */
   export interface Addon {
     /**
      * Addon ID
      */
     addonId: string;
 
+    /**
+     * Number of addon instances
+     */
     quantity?: number;
   }
 
+  /**
+   * Coupon or discount to apply
+   */
   export 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;
   }
 
   export namespace AppliedCoupon {
+    /**
+     * Coupon timing configuration
+     */
     export interface Configuration {
       /**
        * Coupon start date
@@ -1214,23 +3166,47 @@ export namespace SubscriptionPreviewParams {
       startDate?: string;
     }
 
+    /**
+     * Ad-hoc discount configuration
+     */
     export 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;
     }
 
     export namespace Discount {
       export interface AmountsOff {
+        /**
+         * The price amount
+         */
         amount: number;
 
-        currency?:
+        /**
+         * The price currency
+         */
+        currency:
           | 'usd'
           | 'aed'
           | 'all'
@@ -1351,40 +3327,85 @@ export namespace SubscriptionPreviewParams {
     }
   }
 
+  /**
+   * Feature with quantity
+   */
   export interface BillableFeature {
     /**
      * Feature ID
      */
     featureId: string;
 
+    /**
+     * Quantity of feature units
+     */
     quantity: number;
   }
 
+  /**
+   * Billing and tax configuration
+   */
   export interface BillingInformation {
+    /**
+     * Billing address
+     */
     billingAddress?: BillingInformation.BillingAddress;
 
+    /**
+     * Connected account ID for platform billing
+     */
     chargeOnBehalfOfAccount?: string;
 
+    /**
+     * Billing integration ID
+     */
     integrationId?: string;
 
+    /**
+     * Days until invoice is due
+     */
     invoiceDaysUntilDue?: number;
 
+    /**
+     * Whether subscription is backdated
+     */
     isBackdated?: boolean;
 
+    /**
+     * Whether invoice is already paid
+     */
     isInvoicePaid?: boolean;
 
+    /**
+     * Additional billing metadata
+     */
     metadata?: unknown;
 
+    /**
+     * Proration behavior
+     */
     prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
 
+    /**
+     * Customer tax IDs
+     */
     taxIds?: Array<BillingInformation.TaxID>;
 
+    /**
+     * Tax percentage to apply
+     */
     taxPercentage?: number;
 
+    /**
+     * Tax rate IDs from billing provider
+     */
     taxRateIds?: Array<string>;
   }
 
   export namespace BillingInformation {
+    /**
+     * Billing address
+     */
     export interface BillingAddress {
       city?: string;
 
@@ -1399,27 +3420,54 @@ export namespace SubscriptionPreviewParams {
       state?: string;
     }
 
+    /**
+     * Tax exemption identifier
+     */
     export interface TaxID {
+      /**
+       * Tax exemption type (e.g., vat, gst)
+       */
       type: string;
 
+      /**
+       * Tax exemption identifier value
+       */
       value: string;
     }
   }
 
+  /**
+   * Charge item
+   */
   export interface Charge {
     /**
      * Charge ID
      */
     id: string;
 
+    /**
+     * Charge quantity
+     */
     quantity: number;
 
+    /**
+     * Charge type
+     */
     type: 'FEATURE' | 'CREDIT';
   }
 
+  /**
+   * Trial period override settings
+   */
   export interface TrialOverrideConfiguration {
+    /**
+     * Whether to start as trial
+     */
     isTrial: boolean;
 
+    /**
+     * Behavior when trial ends
+     */
     trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
 
     /**
@@ -1431,8 +3479,7 @@ export namespace SubscriptionPreviewParams {
 
 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;
 }
@@ -1448,6 +3495,7 @@ export declare namespace Subscriptions {
     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,