@metronome/sdk 3.6.0 → 3.8.0

package/resources/v1/contracts/contracts.d.mts

@@ -373,6 +373,47 @@ export declare class Contracts extends APIResource {
      * ```
      */
     getNetBalance(body: ContractGetNetBalanceParams, options?: RequestOptions): APIPromise<ContractGetNetBalanceResponse>;
+    /**
+     * Get the history of subscription seats schedule over time for a given
+     * `subscription_id`. This endpoint provides information about seat assignments and
+     * total quantities for different time periods, allowing you to track how seat
+     * assignments have changed over time.
+     *
+     * ### Use this endpoint to:
+     *
+     * - Track changes to seat assignments over time
+     * - Get seat schedule for a specific date using the `covering_date` parameter
+     * - Get seat schedule history with optional date range filtering using
+     *   `starting_at` and `ending_before`
+     *
+     * ### Key response fields:
+     *
+     * - data: array of seat schedule entries with time periods, quantity, and
+     *   assignments
+     * - next_page: cursor for pagination to retrieve additional results
+     *
+     * ### Usage guidelines:
+     *
+     * - Use `covering_date` to get the active seats for a specific point in time.
+     *   `covering_date` cannot be used with `starting_at` or `ending_before`.
+     * - Use `starting_at` and `ending_before` to filter results by time range.
+     *   `starting_at` and `ending_before` cannot be used with `covering_date`.
+     * - Maximum limit is 10 seat schedule entries per request
+     * - Results are ordered by `starting_at` timestamp
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.contracts.getSubscriptionSeatsHistory({
+     *     contract_id: 'd7abd0cd-4ae9-4db7-8676-e986a4ebd8dc',
+     *     customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+     *     subscription_id: '1a824d53-bde6-4d82-96d7-6347ff227d5c',
+     *     covering_date: '2024-01-15T00:00:00.000Z',
+     *     limit: 10,
+     *   });
+     * ```
+     */
+    getSubscriptionSeatsHistory(body: ContractGetSubscriptionSeatsHistoryParams, options?: RequestOptions): APIPromise<ContractGetSubscriptionSeatsHistoryResponse>;
     /**
      * Retrieve a comprehensive view of all available balances (commits and credits)
      * for a customer. This endpoint provides real-time visibility into prepaid funds,
@@ -599,7 +640,415 @@ export declare class Contracts extends APIResource {
 }
 export type ContractListBalancesResponsesBodyCursorPage = BodyCursorPage<ContractListBalancesResponse>;
 export interface ContractCreateResponse {
-    data: Shared.ID;
+    data: ContractCreateResponse.Data;
+}
+export declare namespace ContractCreateResponse {
+    interface Data {
+        id: string;
+        /**
+         * The created contract.
+         */
+        contract?: Data.Contract;
+    }
+    namespace Data {
+        /**
+         * The created contract.
+         */
+        interface Contract {
+            id: string;
+            commits: Array<Shared.Commit>;
+            created_at: string;
+            created_by: string;
+            customer_id: string;
+            overrides: Array<Shared.Override>;
+            scheduled_charges: Array<Shared.ScheduledCharge>;
+            starting_at: string;
+            transitions: Array<Contract.Transition>;
+            usage_filter: Array<Contract.UsageFilter>;
+            usage_statement_schedule: Contract.UsageStatementSchedule;
+            credits?: Array<Shared.Credit>;
+            /**
+             * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+             */
+            custom_fields?: {
+                [key: string]: string;
+            };
+            /**
+             * The billing provider configuration associated with the contract.
+             */
+            customer_billing_provider_configuration?: Contract.CustomerBillingProviderConfiguration;
+            ending_before?: string;
+            /**
+             * Indicates whether there are more items than the limit for this endpoint. Use the
+             * respective list endpoints to get the full lists.
+             */
+            has_more?: Contract.HasMore;
+            /**
+             * Either a **parent** configuration with a list of children or a **child**
+             * configuration with a single parent.
+             */
+            hierarchy_configuration?: Shared.HierarchyConfiguration;
+            /**
+             * Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list
+             * prices automatically. EXPLICIT prioritization requires specifying priorities for
+             * each multiplier; the one with the lowest priority value will be prioritized
+             * first.
+             */
+            multiplier_override_prioritization?: 'LOWEST_MULTIPLIER' | 'EXPLICIT';
+            name?: string;
+            net_payment_terms_days?: number;
+            /**
+             * ID of the package this contract was created from, if applicable.
+             */
+            package_id?: string;
+            prepaid_balance_threshold_configuration?: Shared.PrepaidBalanceThresholdConfiguration;
+            rate_card_id?: string;
+            recurring_commits?: Array<Contract.RecurringCommit>;
+            recurring_credits?: Array<Contract.RecurringCredit>;
+            /**
+             * Determines which scheduled and commit charges to consolidate onto the Contract's
+             * usage invoice. The charge's `timestamp` must match the usage invoice's
+             * `ending_before` date for consolidation to occur. This field cannot be modified
+             * after a Contract has been created. If this field is omitted, charges will appear
+             * on a separate invoice from usage charges.
+             */
+            scheduled_charges_on_usage_invoices?: 'ALL';
+            spend_threshold_configuration?: Shared.SpendThresholdConfiguration;
+            /**
+             * List of subscriptions on the contract.
+             */
+            subscriptions?: Array<Shared.Subscription>;
+            /**
+             * Optional uniqueness key to prevent duplicate contract creations.
+             */
+            uniqueness_key?: string;
+        }
+        namespace Contract {
+            interface Transition {
+                from_contract_id: string;
+                to_contract_id: string;
+                type: 'SUPERSEDE' | 'RENEWAL';
+            }
+            interface UsageFilter {
+                group_key: string;
+                group_values: Array<string>;
+                starting_at: string;
+                ending_before?: string;
+            }
+            interface UsageStatementSchedule {
+                /**
+                 * Contract usage statements follow a selected cadence based on this date.
+                 */
+                billing_anchor_date: string;
+                frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+            }
+            /**
+             * The billing provider configuration associated with the contract.
+             */
+            interface CustomerBillingProviderConfiguration {
+                id?: string;
+                billing_provider?: 'aws_marketplace' | 'stripe' | 'netsuite' | 'custom' | 'azure_marketplace' | 'quickbooks_online' | 'workday' | 'gcp_marketplace' | 'metronome';
+                delivery_method?: 'direct_to_billing_provider' | 'aws_sqs' | 'tackle' | 'aws_sns';
+            }
+            /**
+             * Indicates whether there are more items than the limit for this endpoint. Use the
+             * respective list endpoints to get the full lists.
+             */
+            interface HasMore {
+                /**
+                 * Whether there are more commits on this contract than the limit for this
+                 * endpoint. Use the /contracts/customerCommits/list endpoint to get the full list
+                 * of commits.
+                 */
+                commits: boolean;
+                /**
+                 * Whether there are more credits on this contract than the limit for this
+                 * endpoint. Use the /contracts/customerCredits/list endpoint to get the full list
+                 * of credits.
+                 */
+                credits: boolean;
+            }
+            interface RecurringCommit {
+                id: string;
+                /**
+                 * The amount of commit to grant.
+                 */
+                access_amount: RecurringCommit.AccessAmount;
+                /**
+                 * The amount of time the created commits will be valid for
+                 */
+                commit_duration: RecurringCommit.CommitDuration;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                priority: number;
+                product: RecurringCommit.Product;
+                /**
+                 * Whether the created commits will use the commit rate or list rate
+                 */
+                rate_type: 'COMMIT_RATE' | 'LIST_RATE';
+                /**
+                 * Determines the start time for the first commit
+                 */
+                starting_at: string;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                applicable_product_ids?: Array<string>;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                applicable_product_tags?: Array<string>;
+                contract?: RecurringCommit.Contract;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                description?: string;
+                /**
+                 * Determines when the contract will stop creating recurring commits. Optional
+                 */
+                ending_before?: string;
+                /**
+                 * Optional configuration for recurring commit/credit hierarchy access control
+                 */
+                hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
+                /**
+                 * The amount the customer should be billed for the commit. Not required.
+                 */
+                invoice_amount?: RecurringCommit.InvoiceAmount;
+                /**
+                 * Displayed on invoices. Will be passed through to the individual commits
+                 */
+                name?: string;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                netsuite_sales_order_id?: string;
+                /**
+                 * Determines whether the first and last commit will be prorated. If not provided,
+                 * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+                 */
+                proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+                /**
+                 * Rounding configuration for prorated recurring commit amounts.
+                 */
+                proration_rounding?: RecurringCommit.ProrationRounding | null;
+                /**
+                 * The frequency at which the recurring commits will be created. If not provided: -
+                 * The commits will be created on the usage invoice frequency. If provided: - The
+                 * period defined in the duration will correspond to this frequency. - Commits will
+                 * be created aligned with the recurring commit's starting_at rather than the usage
+                 * invoice dates.
+                 */
+                recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
+                /**
+                 * Will be passed down to the individual commits. This controls how much of an
+                 * individual unexpired commit will roll over upon contract transition. Must be
+                 * between 0 and 1.
+                 */
+                rollover_fraction?: number;
+                /**
+                 * List of filters that determine what kind of customer usage draws down a commit
+                 * or credit. A customer's usage needs to meet the condition of at least one of the
+                 * specifiers to contribute to a commit's or credit's drawdown.
+                 */
+                specifiers?: Array<Shared.CommitSpecifier>;
+                /**
+                 * Attach a subscription to the recurring commit/credit.
+                 */
+                subscription_config?: Shared.RecurringCommitSubscriptionConfig;
+            }
+            namespace RecurringCommit {
+                /**
+                 * The amount of commit to grant.
+                 */
+                interface AccessAmount {
+                    credit_type_id: string;
+                    unit_price: number;
+                    quantity?: number;
+                }
+                /**
+                 * The amount of time the created commits will be valid for
+                 */
+                interface CommitDuration {
+                    value: number;
+                    unit?: 'PERIODS';
+                }
+                interface Product {
+                    id: string;
+                    name: string;
+                }
+                interface Contract {
+                    id: string;
+                }
+                /**
+                 * The amount the customer should be billed for the commit. Not required.
+                 */
+                interface InvoiceAmount {
+                    credit_type_id: string;
+                    quantity: number;
+                    unit_price: number;
+                }
+                /**
+                 * Rounding configuration for prorated recurring commit amounts.
+                 */
+                interface ProrationRounding {
+                    access?: ProrationRounding.Access;
+                    invoice?: ProrationRounding.Invoice;
+                }
+                namespace ProrationRounding {
+                    interface Access {
+                        /**
+                         * Number of decimal places to round to. Applied directly to the stored monetary
+                         * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                         * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                         * dollar).
+                         */
+                        decimal_places: number;
+                        rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+                    }
+                    interface Invoice {
+                        /**
+                         * Number of decimal places to round to. Applied directly to the stored monetary
+                         * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                         * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                         * dollar).
+                         */
+                        decimal_places: number;
+                        rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+                    }
+                }
+            }
+            interface RecurringCredit {
+                id: string;
+                /**
+                 * The amount of commit to grant.
+                 */
+                access_amount: RecurringCredit.AccessAmount;
+                /**
+                 * The amount of time the created commits will be valid for
+                 */
+                commit_duration: RecurringCredit.CommitDuration;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                priority: number;
+                product: RecurringCredit.Product;
+                /**
+                 * Whether the created commits will use the commit rate or list rate
+                 */
+                rate_type: 'COMMIT_RATE' | 'LIST_RATE';
+                /**
+                 * Determines the start time for the first commit
+                 */
+                starting_at: string;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                applicable_product_ids?: Array<string>;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                applicable_product_tags?: Array<string>;
+                contract?: RecurringCredit.Contract;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                description?: string;
+                /**
+                 * Determines when the contract will stop creating recurring commits. Optional
+                 */
+                ending_before?: string;
+                /**
+                 * Optional configuration for recurring commit/credit hierarchy access control
+                 */
+                hierarchy_configuration?: Shared.CommitHierarchyConfiguration;
+                /**
+                 * Displayed on invoices. Will be passed through to the individual commits
+                 */
+                name?: string;
+                /**
+                 * Will be passed down to the individual commits
+                 */
+                netsuite_sales_order_id?: string;
+                /**
+                 * Determines whether the first and last commit will be prorated. If not provided,
+                 * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+                 */
+                proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+                /**
+                 * Rounding configuration for prorated recurring credit amounts.
+                 */
+                proration_rounding?: RecurringCredit.ProrationRounding | null;
+                /**
+                 * The frequency at which the recurring commits will be created. If not provided: -
+                 * The commits will be created on the usage invoice frequency. If provided: - The
+                 * period defined in the duration will correspond to this frequency. - Commits will
+                 * be created aligned with the recurring commit's starting_at rather than the usage
+                 * invoice dates.
+                 */
+                recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
+                /**
+                 * Will be passed down to the individual commits. This controls how much of an
+                 * individual unexpired commit will roll over upon contract transition. Must be
+                 * between 0 and 1.
+                 */
+                rollover_fraction?: number;
+                /**
+                 * List of filters that determine what kind of customer usage draws down a commit
+                 * or credit. A customer's usage needs to meet the condition of at least one of the
+                 * specifiers to contribute to a commit's or credit's drawdown.
+                 */
+                specifiers?: Array<Shared.CommitSpecifier>;
+                /**
+                 * Attach a subscription to the recurring commit/credit.
+                 */
+                subscription_config?: Shared.RecurringCommitSubscriptionConfig;
+            }
+            namespace RecurringCredit {
+                /**
+                 * The amount of commit to grant.
+                 */
+                interface AccessAmount {
+                    credit_type_id: string;
+                    unit_price: number;
+                    quantity?: number;
+                }
+                /**
+                 * The amount of time the created commits will be valid for
+                 */
+                interface CommitDuration {
+                    value: number;
+                    unit?: 'PERIODS';
+                }
+                interface Product {
+                    id: string;
+                    name: string;
+                }
+                interface Contract {
+                    id: string;
+                }
+                /**
+                 * Rounding configuration for prorated recurring credit amounts.
+                 */
+                interface ProrationRounding {
+                    access?: ProrationRounding.Access;
+                }
+                namespace ProrationRounding {
+                    interface Access {
+                        /**
+                         * Number of decimal places to round to. Applied directly to the stored monetary
+                         * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                         * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                         * dollar).
+                         */
+                        decimal_places: number;
+                        rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+                    }
+                }
+            }
+        }
+    }
 }
 export interface ContractRetrieveResponse {
     data: Shared.Contract;
@@ -633,6 +1082,33 @@ export declare namespace ContractGetNetBalanceResponse {
         credit_type_id: string;
     }
 }
+export interface ContractGetSubscriptionSeatsHistoryResponse {
+    data: Array<ContractGetSubscriptionSeatsHistoryResponse.Data>;
+    /**
+     * Cursor for the next page of results
+     */
+    next_page: string | null;
+}
+export declare namespace ContractGetSubscriptionSeatsHistoryResponse {
+    interface Data {
+        /**
+         * Array of seat IDs that are assigned in this period
+         */
+        assigned_seat_ids: Array<string>;
+        /**
+         * The end time of this seat schedule period (null if ongoing)
+         */
+        ending_before: string | null;
+        /**
+         * The start time of this seat schedule period
+         */
+        starting_at: string;
+        /**
+         * Total number of assigned and unassigned seats in this period
+         */
+        total_quantity: number;
+    }
+}
 export type ContractListBalancesResponse = Shared.Commit | Shared.Credit;
 export interface ContractListSeatBalancesResponse {
     data: Array<ContractListSeatBalancesResponse.Data>;
@@ -912,6 +1388,11 @@ export interface ContractCreateParams {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
     spend_threshold_configuration?: Shared.SpendThresholdConfiguration;
+    /**
+     * Spend trackers to attach to this contract. Aliases must be unique within a
+     * contract.
+     */
+    spend_trackers?: Array<ContractCreateParams.SpendTracker>;
     /**
      * Optional list of
      * [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/)
@@ -1024,6 +1505,10 @@ export declare namespace ContractCreateParams {
          * be used together with `applicable_product_ids` or `applicable_product_tags`.
          */
         specifiers?: Array<Shared.CommitSpecifierInput>;
+        /**
+         * Optional attributes for spend tracker integration. Immutable after creation.
+         */
+        spend_tracker_attributes?: Commit.SpendTrackerAttributes;
         /**
          * A temporary ID for the commit that can be used to reference the commit for
          * commit specific overrides.
@@ -1144,6 +1629,16 @@ export declare namespace ContractCreateParams {
                 unit_price?: number;
             }
         }
+        /**
+         * Optional attributes for spend tracker integration. Immutable after creation.
+         */
+        interface SpendTrackerAttributes {
+            /**
+             * If true, this commit will be included in spend trackers with discounted set to
+             * DISCOUNTED_ONLY
+             */
+            counts_as_discounted: boolean;
+        }
     }
     interface Credit {
         /**
@@ -1392,9 +1887,10 @@ export declare namespace ContractCreateParams {
         entitled?: boolean;
         /**
          * Indicates whether the override should only apply to commits. Defaults to
-         * `false`. If `true`, you can specify relevant commits in `override_specifiers` by
-         * passing `commit_ids`. if you do not specify `commit_ids`, then the override will
-         * apply when consuming any prepaid or postpaid commit.
+         * `false`. If `true` you can specify relevant commits in `override_specifiers` by
+         * passing `commit_ids`, `recurring_commit_ids`, or `any_commit_or_credit_ids`. If
+         * you do not specify any of these fields, the override will apply when consuming
+         * any prepaid commit, postpaid commit, or credit
          */
         is_commit_specific?: boolean;
         /**
@@ -1439,6 +1935,14 @@ export declare namespace ContractCreateParams {
     }
     namespace Override {
         interface OverrideSpecifier {
+            /**
+             * Can only be used for commit specific overrides. Must be used in conjunction with
+             * one of `product_id`, `product_tags`, `pricing_group_values`, or
+             * `presentation_group_values`. Must be used instead of both `commit_ids` and
+             * `recurring_commit_ids` If provided, the override will apply to any specified
+             * commit, credit, recurring commit or recurring credit IDs.
+             */
+            any_commit_or_credit_ids?: Array<string>;
             billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
             /**
              * Can only be used for commit specific overrides. Must be used in conjunction with
@@ -1600,6 +2104,10 @@ export declare namespace ContractCreateParams {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Optional rounding configuration for prorated recurring commit amounts.
+         */
+        proration_rounding?: RecurringCommit.ProrationRounding;
         /**
          * Whether the created commits will use the commit rate or list rate
          */
@@ -1611,7 +2119,7 @@ export declare namespace ContractCreateParams {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1665,6 +2173,35 @@ export declare namespace ContractCreateParams {
             quantity: number;
             unit_price: number;
         }
+        /**
+         * Optional rounding configuration for prorated recurring commit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+            invoice?: ProrationRounding.Invoice;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+            interface Invoice {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -1742,6 +2279,10 @@ export declare namespace ContractCreateParams {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Optional rounding configuration for prorated recurring credit amounts.
+         */
+        proration_rounding?: RecurringCredit.ProrationRounding;
         /**
          * Whether the created commits will use the commit rate or list rate
          */
@@ -1753,7 +2294,7 @@ export declare namespace ContractCreateParams {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1799,6 +2340,24 @@ export declare namespace ContractCreateParams {
             value: number;
             unit?: 'PERIODS';
         }
+        /**
+         * Optional rounding configuration for prorated recurring credit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -1982,10 +2541,30 @@ export declare namespace ContractCreateParams {
             }
         }
     }
+    interface SpendTracker {
+        /**
+         * Human-readable identifier, unique per contract.
+         */
+        alias: string;
+        applicable_spend_specifiers: Array<SpendTracker.ApplicableSpendSpecifier>;
+        credit_type_id: string;
+        reset_frequency: 'BILLING_PERIOD';
+    }
+    namespace SpendTracker {
+        interface ApplicableSpendSpecifier {
+            sources: Array<'THRESHOLD_RECHARGE' | 'MANUAL'>;
+            spend_type: 'COMMIT_PURCHASE';
+            /**
+             * Filter by whether the spend was discounted. Defaults to ANY if omitted.
+             */
+            discounted?: 'ANY' | 'DISCOUNTED_ONLY' | 'UNDISCOUNTED_ONLY';
+        }
+    }
     interface Subscription {
         collection_schedule: 'ADVANCE' | 'ARREARS';
         proration: Subscription.Proration;
         subscription_rate: Subscription.SubscriptionRate;
+        billing_cycle_config?: Subscription.BillingCycleConfig;
         /**
          * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
          */
@@ -2042,6 +2621,19 @@ export declare namespace ContractCreateParams {
              * Indicates if the partial period will be prorated or charged a full amount.
              */
             is_prorated?: boolean;
+            rounding?: Proration.Rounding;
+        }
+        namespace Proration {
+            interface Rounding {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
         }
         interface SubscriptionRate {
             /**
@@ -2054,6 +2646,18 @@ export declare namespace ContractCreateParams {
              */
             product_id: string;
         }
+        interface BillingCycleConfig {
+            /**
+             * The date to anchor the billing cycle to. If omitted, defaults to the contract's
+             * usage invoice billing cycle anchor date.
+             */
+            anchor_date?: string;
+            /**
+             * Controls whether this subscription consolidates onto usage invoices or gets its
+             * own scheduled invoice. Defaults to ON_USAGE_INVOICE if omitted.
+             */
+            invoice_placement?: 'ON_SCHEDULED_INVOICE' | 'ON_USAGE_INVOICE';
+        }
         interface SeatConfig {
             /**
              * The initial assigned seats on this subscription.
@@ -2315,6 +2919,10 @@ export declare namespace ContractAmendParams {
          * be used together with `applicable_product_ids` or `applicable_product_tags`.
          */
         specifiers?: Array<Shared.CommitSpecifierInput>;
+        /**
+         * Optional attributes for spend tracker integration. Immutable after creation.
+         */
+        spend_tracker_attributes?: Commit.SpendTrackerAttributes;
         /**
          * A temporary ID for the commit that can be used to reference the commit for
          * commit specific overrides.
@@ -2435,6 +3043,16 @@ export declare namespace ContractAmendParams {
                 unit_price?: number;
             }
         }
+        /**
+         * Optional attributes for spend tracker integration. Immutable after creation.
+         */
+        interface SpendTrackerAttributes {
+            /**
+             * If true, this commit will be included in spend trackers with discounted set to
+             * DISCOUNTED_ONLY
+             */
+            counts_as_discounted: boolean;
+        }
     }
     interface Credit {
         /**
@@ -2642,9 +3260,10 @@ export declare namespace ContractAmendParams {
         entitled?: boolean;
         /**
          * Indicates whether the override should only apply to commits. Defaults to
-         * `false`. If `true`, you can specify relevant commits in `override_specifiers` by
-         * passing `commit_ids`. if you do not specify `commit_ids`, then the override will
-         * apply when consuming any prepaid or postpaid commit.
+         * `false`. If `true` you can specify relevant commits in `override_specifiers` by
+         * passing `commit_ids`, `recurring_commit_ids`, or `any_commit_or_credit_ids`. If
+         * you do not specify any of these fields, the override will apply when consuming
+         * any prepaid commit, postpaid commit, or credit
          */
         is_commit_specific?: boolean;
         /**
@@ -2689,6 +3308,14 @@ export declare namespace ContractAmendParams {
     }
     namespace Override {
         interface OverrideSpecifier {
+            /**
+             * Can only be used for commit specific overrides. Must be used in conjunction with
+             * one of `product_id`, `product_tags`, `pricing_group_values`, or
+             * `presentation_group_values`. Must be used instead of both `commit_ids` and
+             * `recurring_commit_ids` If provided, the override will apply to any specified
+             * commit, credit, recurring commit or recurring credit IDs.
+             */
+            any_commit_or_credit_ids?: Array<string>;
             billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
             /**
              * Can only be used for commit specific overrides. Must be used in conjunction with
@@ -3019,6 +3646,38 @@ export interface ContractGetNetBalanceParams {
      */
     invoice_inclusion_mode?: 'FINALIZED' | 'FINALIZED_AND_DRAFT';
 }
+export interface ContractGetSubscriptionSeatsHistoryParams {
+    contract_id: string;
+    customer_id: string;
+    subscription_id: string;
+    /**
+     * Get the seats history segment for the covering date. Cannot be used with
+     * `starting_at` or `ending_before`.
+     */
+    covering_date?: string | null;
+    /**
+     * Cursor for pagination. Use the value from the `next_page` field of the previous
+     * response to retrieve the next page of results.
+     */
+    cursor?: string | null;
+    /**
+     * Include seats history segments that are active at or before this timestamp. Use
+     * with `starting_at` to get a specific time range. If not set, there's no upper
+     * bound.
+     */
+    ending_before?: string | null;
+    /**
+     * Maximum number of seat schedule entries to return. Defaults to 10. Required
+     * range: 1 <= x <= 10.
+     */
+    limit?: number | null;
+    /**
+     * Include seats history segments that are active at or after this timestamp. Use
+     * with `ending_before` to get a specific time range. If not set, there's no lower
+     * bound.
+     */
+    starting_at?: string | null;
+}
 export interface ContractListBalancesParams extends BodyCursorPageParams {
     customer_id: string;
     id?: string;
@@ -3103,6 +3762,11 @@ export interface ContractListSeatBalancesParams {
      * Optional filter to only include specific seats.
      */
     seat_ids?: Array<string>;
+    /**
+     * When true, any seat_ids not found in contract subscriptions will be silently
+     * omitted from the response instead of returning a 400 error.
+     */
+    skip_missing_seat_ids?: boolean;
     /**
      * Include only commits or credits with access effective on or after this date
      * (cannot be used with covering_date).
@@ -3269,7 +3933,7 @@ export interface ContractUpdateEndDateParams {
     ending_before?: string;
 }
 export declare namespace Contracts {
-    export { type ContractCreateResponse as ContractCreateResponse, type ContractRetrieveResponse as ContractRetrieveResponse, type ContractListResponse as ContractListResponse, type ContractAmendResponse as ContractAmendResponse, type ContractArchiveResponse as ContractArchiveResponse, type ContractCreateHistoricalInvoicesResponse as ContractCreateHistoricalInvoicesResponse, type ContractGetNetBalanceResponse as ContractGetNetBalanceResponse, type ContractListBalancesResponse as ContractListBalancesResponse, type ContractListSeatBalancesResponse as ContractListSeatBalancesResponse, type ContractRetrieveRateScheduleResponse as ContractRetrieveRateScheduleResponse, type ContractRetrieveSubscriptionQuantityHistoryResponse as ContractRetrieveSubscriptionQuantityHistoryResponse, type ContractScheduleProServicesInvoiceResponse as ContractScheduleProServicesInvoiceResponse, type ContractUpdateEndDateResponse as ContractUpdateEndDateResponse, type ContractListBalancesResponsesBodyCursorPage as ContractListBalancesResponsesBodyCursorPage, type ContractCreateParams as ContractCreateParams, type ContractRetrieveParams as ContractRetrieveParams, type ContractListParams as ContractListParams, type ContractAddManualBalanceEntryParams as ContractAddManualBalanceEntryParams, type ContractAmendParams as ContractAmendParams, type ContractArchiveParams as ContractArchiveParams, type ContractCreateHistoricalInvoicesParams as ContractCreateHistoricalInvoicesParams, type ContractGetNetBalanceParams as ContractGetNetBalanceParams, type ContractListBalancesParams as ContractListBalancesParams, type ContractListSeatBalancesParams as ContractListSeatBalancesParams, type ContractRetrieveRateScheduleParams as ContractRetrieveRateScheduleParams, type ContractRetrieveSubscriptionQuantityHistoryParams as ContractRetrieveSubscriptionQuantityHistoryParams, type ContractScheduleProServicesInvoiceParams as ContractScheduleProServicesInvoiceParams, type ContractSetUsageFilterParams as ContractSetUsageFilterParams, type ContractUpdateEndDateParams as ContractUpdateEndDateParams, };
+    export { type ContractCreateResponse as ContractCreateResponse, type ContractRetrieveResponse as ContractRetrieveResponse, type ContractListResponse as ContractListResponse, type ContractAmendResponse as ContractAmendResponse, type ContractArchiveResponse as ContractArchiveResponse, type ContractCreateHistoricalInvoicesResponse as ContractCreateHistoricalInvoicesResponse, type ContractGetNetBalanceResponse as ContractGetNetBalanceResponse, type ContractGetSubscriptionSeatsHistoryResponse as ContractGetSubscriptionSeatsHistoryResponse, type ContractListBalancesResponse as ContractListBalancesResponse, type ContractListSeatBalancesResponse as ContractListSeatBalancesResponse, type ContractRetrieveRateScheduleResponse as ContractRetrieveRateScheduleResponse, type ContractRetrieveSubscriptionQuantityHistoryResponse as ContractRetrieveSubscriptionQuantityHistoryResponse, type ContractScheduleProServicesInvoiceResponse as ContractScheduleProServicesInvoiceResponse, type ContractUpdateEndDateResponse as ContractUpdateEndDateResponse, type ContractListBalancesResponsesBodyCursorPage as ContractListBalancesResponsesBodyCursorPage, type ContractCreateParams as ContractCreateParams, type ContractRetrieveParams as ContractRetrieveParams, type ContractListParams as ContractListParams, type ContractAddManualBalanceEntryParams as ContractAddManualBalanceEntryParams, type ContractAmendParams as ContractAmendParams, type ContractArchiveParams as ContractArchiveParams, type ContractCreateHistoricalInvoicesParams as ContractCreateHistoricalInvoicesParams, type ContractGetNetBalanceParams as ContractGetNetBalanceParams, type ContractGetSubscriptionSeatsHistoryParams as ContractGetSubscriptionSeatsHistoryParams, type ContractListBalancesParams as ContractListBalancesParams, type ContractListSeatBalancesParams as ContractListSeatBalancesParams, type ContractRetrieveRateScheduleParams as ContractRetrieveRateScheduleParams, type ContractRetrieveSubscriptionQuantityHistoryParams as ContractRetrieveSubscriptionQuantityHistoryParams, type ContractScheduleProServicesInvoiceParams as ContractScheduleProServicesInvoiceParams, type ContractSetUsageFilterParams as ContractSetUsageFilterParams, type ContractUpdateEndDateParams as ContractUpdateEndDateParams, };
     export { Products as Products, type ProductListItemState as ProductListItemState, type QuantityConversion as QuantityConversion, type QuantityRounding as QuantityRounding, type ProductCreateResponse as ProductCreateResponse, type ProductRetrieveResponse as ProductRetrieveResponse, type ProductUpdateResponse as ProductUpdateResponse, type ProductListResponse as ProductListResponse, type ProductArchiveResponse as ProductArchiveResponse, type ProductListResponsesCursorPage as ProductListResponsesCursorPage, type ProductCreateParams as ProductCreateParams, type ProductRetrieveParams as ProductRetrieveParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, type ProductArchiveParams as ProductArchiveParams, };
     export { RateCards as RateCards, type RateCardCreateResponse as RateCardCreateResponse, type RateCardRetrieveResponse as RateCardRetrieveResponse, type RateCardUpdateResponse as RateCardUpdateResponse, type RateCardListResponse as RateCardListResponse, type RateCardArchiveResponse as RateCardArchiveResponse, type RateCardRetrieveRateScheduleResponse as RateCardRetrieveRateScheduleResponse, type RateCardListResponsesCursorPage as RateCardListResponsesCursorPage, type RateCardCreateParams as RateCardCreateParams, type RateCardRetrieveParams as RateCardRetrieveParams, type RateCardUpdateParams as RateCardUpdateParams, type RateCardListParams as RateCardListParams, type RateCardArchiveParams as RateCardArchiveParams, type RateCardRetrieveRateScheduleParams as RateCardRetrieveRateScheduleParams, };
     export { NamedSchedules as NamedSchedules, type NamedScheduleRetrieveResponse as NamedScheduleRetrieveResponse, type NamedScheduleRetrieveParams as NamedScheduleRetrieveParams, type NamedScheduleUpdateParams as NamedScheduleUpdateParams, };