@metronome/sdk 2.2.0 → 3.4.1

package/src/resources/shared.ts

@@ -3,6 +3,23 @@
 import * as Shared from './shared';
 import { BodyCursorPage } from '../core/pagination';
 
+export interface BalanceFilter {
+  /**
+   * The balance type to filter by.
+   */
+  balance_types?: Array<'PREPAID_COMMIT' | 'POSTPAID_COMMIT' | 'CREDIT'>;
+
+  /**
+   * Custom fields to compute balance across. Must match all custom fields
+   */
+  custom_fields?: { [key: string]: string };
+
+  /**
+   * Specific IDs to compute balance across.
+   */
+  ids?: Array<string>;
+}
+
 export interface BaseThresholdCommit {
   /**
    * The commit product that will be used to generate the line item for commit
@@ -138,6 +155,12 @@ export interface Commit {
 
   rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
 
+  /**
+   * The ID of the recurring commit that this commit was generated from, if
+   * applicable.
+   */
+  recurring_commit_id?: string;
+
   rolled_over_from?: Commit.RolledOverFrom;
 
   rollover_fraction?: number;
@@ -154,6 +177,12 @@ export interface Commit {
    */
   specifiers?: Array<CommitSpecifier>;
 
+  /**
+   * The subscription configuration for this commit, if it was generated from a
+   * recurring commit with a subscription attached.
+   */
+  subscription_config?: Commit.SubscriptionConfig;
+
   /**
    * Prevents the creation of duplicates. If a request to create a commit or credit
    * is made with a uniqueness key that was previously used to create a commit or
@@ -344,6 +373,27 @@ export namespace Commit {
 
     contract_id: string;
   }
+
+  /**
+   * The subscription configuration for this commit, if it was generated from a
+   * recurring commit with a subscription attached.
+   */
+  export interface SubscriptionConfig {
+    allocation?: 'INDIVIDUAL' | 'POOLED';
+
+    apply_seat_increase_config?: SubscriptionConfig.ApplySeatIncreaseConfig;
+
+    subscription_id?: string;
+  }
+
+  export namespace SubscriptionConfig {
+    export interface ApplySeatIncreaseConfig {
+      /**
+       * Indicates whether a mid-period seat increase should be prorated.
+       */
+      is_prorated: boolean;
+    }
+  }
 }
 
 export interface CommitHierarchyConfiguration {
@@ -374,10 +424,12 @@ export namespace CommitHierarchyConfiguration {
  * list rate when consuming a credit or commit.
  */
 export interface CommitRate {
-  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
   /**
-   * Commit rate price. For FLAT rate_type, this must be >=0.
+   * Commit rate price. For FLAT rate_type, this must be >=0. For PERCENTAGE
+   * rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0
+   * and <=1.
    */
   price?: number;
 
@@ -405,8 +457,16 @@ export interface CommitSpecifier {
 }
 
 export interface CommitSpecifierInput {
+  /**
+   * If provided, the specifier will apply to product usage with these set of
+   * presentation group values.
+   */
   presentation_group_values?: { [key: string]: string };
 
+  /**
+   * If provided, the specifier will apply to product usage with these set of pricing
+   * group values.
+   */
   pricing_group_values?: { [key: string]: string };
 
   /**
@@ -448,12 +508,12 @@ export interface Contract {
    */
   customer_billing_provider_configuration?: Contract.CustomerBillingProviderConfiguration;
 
-  prepaid_balance_threshold_configuration?: PrepaidBalanceThresholdConfiguration;
-
   /**
-   * Priority of the contract.
+   * ID of the package this contract was created from, if applicable.
    */
-  priority?: number;
+  package_id?: string;
+
+  prepaid_balance_threshold_configuration?: PrepaidBalanceThresholdConfiguration;
 
   /**
    * Determines which scheduled and commit charges to consolidate onto the Contract's
@@ -808,6 +868,11 @@ export namespace ContractV2 {
 
     rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
 
+    /**
+     * The ID of the recurring commit that created this commit
+     */
+    recurring_commit_id?: string;
+
     rolled_over_from?: Commit.RolledOverFrom;
 
     rollover_fraction?: number;
@@ -1063,7 +1128,7 @@ export namespace ContractV2 {
     }
 
     export interface OverwriteRate {
-      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
       credit_type?: Shared.CreditTypeData;
 
@@ -1217,6 +1282,11 @@ export namespace ContractV2 {
      */
     priority?: number;
 
+    /**
+     * The ID of the recurring credit that created this credit
+     */
+    recurring_credit_id?: string;
+
     /**
      * This field's availability is dependent on your client's configuration.
      */
@@ -1390,8 +1460,8 @@ export namespace ContractV2 {
 
     export interface ParentBehavior {
       /**
-       * Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
-       * generated by the parent in a customer hierarchy
+       * Indicates the desired behavior of consolidated invoices generated by the parent
+       * in a customer hierarchy
        *
        * **CONCATENATE**: Statements on the invoices of child customers will be appended
        * to the consolidated invoice
@@ -1409,15 +1479,15 @@ export namespace ContractV2 {
     parent: ChildHierarchyConfigurationV2.Parent;
 
     /**
-     * Account hierarchy M3 - Indicates which customer should pay for the child's
-     * invoice charges **SELF**: The child pays for its own invoice charges **PARENT**:
-     * The parent pays for the child's invoice charges
+     * Indicates which customer should pay for the child's invoice charges **SELF**:
+     * The child pays for its own invoice charges **PARENT**: The parent pays for the
+     * child's invoice charges
      */
     payer?: 'SELF' | 'PARENT';
 
     /**
-     * Account hierarchy M3 - Indicates the behavior of the child's invoice statements
-     * on the parent's invoices.
+     * Indicates the behavior of the child's invoice statements on the parent's
+     * invoices.
      *
      * **CONSOLIDATE**: Child's invoice statements will be added to parent's
      * consolidated invoices
@@ -2265,6 +2335,12 @@ export interface Credit {
 
   rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
 
+  /**
+   * The ID of the recurring credit that this credit was generated from, if
+   * applicable.
+   */
+  recurring_credit_id?: string;
+
   /**
    * This field's availability is dependent on your client's configuration.
    */
@@ -2277,6 +2353,12 @@ export interface Credit {
    */
   specifiers?: Array<CommitSpecifier>;
 
+  /**
+   * The subscription configuration for this credit, if it was generated from a
+   * recurring credit with a subscription attached.
+   */
+  subscription_config?: Credit.SubscriptionConfig;
+
   /**
    * Prevents the creation of duplicates. If a request to create a commit or credit
    * is made with a uniqueness key that was previously used to create a commit or
@@ -2378,6 +2460,27 @@ export namespace Credit {
 
     type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
   }
+
+  /**
+   * The subscription configuration for this credit, if it was generated from a
+   * recurring credit with a subscription attached.
+   */
+  export interface SubscriptionConfig {
+    allocation?: 'INDIVIDUAL' | 'POOLED';
+
+    apply_seat_increase_config?: SubscriptionConfig.ApplySeatIncreaseConfig;
+
+    subscription_id?: string;
+  }
+
+  export namespace SubscriptionConfig {
+    export interface ApplySeatIncreaseConfig {
+      /**
+       * Indicates whether a mid-period seat increase should be prorated.
+       */
+      is_prorated: boolean;
+    }
+  }
 }
 
 export interface CreditTypeData {
@@ -2460,8 +2563,8 @@ export namespace HierarchyConfiguration {
 
     export interface ParentBehavior {
       /**
-       * Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
-       * generated by the parent in a customer hierarchy
+       * Indicates the desired behavior of consolidated invoices generated by the parent
+       * in a customer hierarchy
        *
        * **CONCATENATE**: Statements on the invoices of child customers will be appended
        * to the consolidated invoice
@@ -2479,8 +2582,7 @@ export namespace HierarchyConfiguration {
     parent: ChildHierarchyConfiguration.Parent;
 
     /**
-     * Account hierarchy M3 - Indicates which customer should pay for the child's
-     * invoice charges
+     * Indicates which customer should pay for the child's invoice charges
      *
      * **SELF**: The child pays for its own invoice charges
      *
@@ -2489,8 +2591,8 @@ export namespace HierarchyConfiguration {
     payer?: 'SELF' | 'PARENT';
 
     /**
-     * Account hierarchy M3 - Indicates the behavior of the child's invoice statements
-     * on the parent's invoices.
+     * Indicates the behavior of the child's invoice statements on the parent's
+     * invoices.
      *
      * **CONSOLIDATE**: Child's invoice statements will be added to parent's
      * consolidated invoices
@@ -2561,7 +2663,7 @@ export interface Override {
    */
   quantity?: number;
 
-  rate_type?: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+  rate_type?: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
   target?: 'COMMIT_RATE' | 'LIST_RATE';
 
@@ -2612,7 +2714,7 @@ export interface OverrideTier {
 }
 
 export interface OverwriteRate {
-  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
   credit_type?: CreditTypeData;
 
@@ -2669,7 +2771,7 @@ export interface PaymentGateConfig {
    * not wish Metronome to calculate tax on your behalf. Leaving this field blank
    * will default to NONE.
    */
-  tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
+  tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
 }
 
 export namespace PaymentGateConfig {
@@ -2731,7 +2833,7 @@ export interface PaymentGateConfigV2 {
    * not wish Metronome to calculate tax on your behalf. Leaving this field blank
    * will default to NONE.
    */
-  tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
+  tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
 }
 
 export namespace PaymentGateConfigV2 {
@@ -2950,7 +3052,7 @@ export interface ProService {
 }
 
 export interface Rate {
-  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'CUSTOM' | 'TIERED';
+  rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'CUSTOM' | 'TIERED' | 'TIERED_PERCENTAGE';
 
   credit_type?: CreditTypeData;
 
@@ -2987,13 +3089,6 @@ export interface Rate {
    * Only set for TIERED rate_type.
    */
   tiers?: Array<Tier>;
-
-  /**
-   * Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed
-   * using list prices rather than the standard rates for this product on the
-   * contract.
-   */
-  use_list_prices?: boolean;
 }
 
 export interface RecurringCommitSubscriptionConfig {

package/src/resources/v1/alerts.ts

@@ -5,6 +5,9 @@ import * as Shared from '../shared';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
+/**
+ * [Alerts](https://docs.metronome.com/connecting-metronome/alerts/) monitor customer spending, balances, and other billing factors. Use these endpoints to create, retrieve, and archive customer alerts. To view sample alert payloads by alert type, navigate [here.](https://docs.metronome.com/manage-product-access/create-manage-alerts/#webhook-notifications)
+ */
 export class Alerts extends APIResource {
   /**
    * Create a new threshold notification to monitor customer spending, balances, and

package/src/resources/v1/audit-logs.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../../core/resource';
 import { CursorPage, type CursorPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 
+/**
+ * [Security](https://docs.metronome.com/developer-resources/security/) endpoints allow you to retrieve security-related data.
+ */
 export class AuditLogs extends APIResource {
   /**
    * Get a comprehensive audit trail of all operations performed in your Metronome

package/src/resources/v1/billable-metrics.ts

@@ -7,6 +7,9 @@ import { CursorPage, type CursorPageParams, PagePromise } from '../../core/pagin
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * [Billable metrics](https://docs.metronome.com/understanding-metronome/how-metronome-works#billable-metrics) in Metronome represent the various consumption components that Metronome meters and aggregates.
+ */
 export class BillableMetrics extends APIResource {
   /**
    * Create billable metrics programmatically with this endpoint—an essential step in

package/src/resources/v1/contracts/contracts.ts

@@ -374,6 +374,79 @@ export class Contracts extends APIResource {
     return this._client.post('/v1/contracts/createHistoricalInvoices', { body, ...options });
   }
 
+  /**
+   * Retrieve the combined current balance across any grouping of credits and commits
+   * for a customer in a single API call.
+   *
+   * - Display real-time available balance to customers in billing dashboards
+   * - Build finance dashboards showing credit utilization across customer segments
+   * - Validate expected vs. actual balance during billing reconciliation
+   *
+   * ### Key response fields:
+   *
+   * - `balance`: The combined net balance available to use at this moment across all
+   *   matching commits and credits
+   * - `credit_type_id`: The credit type (fiat or custom pricing unit) the balance is
+   *   denominated in
+   *
+   * ### Filtering options:
+   *
+   * Balance filters allow you to scope the calculation to specific subsets of
+   * commits and credits. When using multiple filter objects, they are OR'd together
+   * — if a commit or credit matches any filter, it's included in the net balance.
+   * Within a single filter object, all specified conditions are AND'd together.
+   *
+   * - **Balance types**: Include any combination of `PREPAID_COMMIT`,
+   *   `POSTPAID_COMMIT`, and `CREDIT` (e.g., `["PREPAID_COMMIT", "CREDIT"]` to
+   *   exclude postpaid commits). If not specified, all balance types are included.
+   * - **Specific IDs**: Target exact commit or credit IDs for precise balance
+   *   queries
+   * - **Custom fields**: Filter by custom field key-value pairs; when multiple pairs
+   *   are provided, commits must match all of them
+   *
+   * **Example**: To get the balance of all free-trial credits OR all
+   * signup-promotion commits, you'd pass two filter objects — one filtering for
+   * CREDIT with custom field campaign: free-trial, and another filtering for
+   * PREPAID_COMMIT with custom field campaign: signup-promotion.
+   *
+   * ### Usage guidelines:
+   *
+   * - **Draft invoice handling**: Use `invoice_inclusion_mode` to control whether
+   *   pending draft invoice deductions are included (`FINALIZED_AND_DRAFT`, the
+   *   default) or excluded (`FINALIZED`) from the balance calculation
+   * - **Account hierarchies**: When querying a child customer, shared commits from
+   *   parent contracts are not included — query the parent customer directly to see
+   *   shared commit balances
+   * - **Negative balances**: Manual ledger entries can cause negative segment
+   *   balances; these are treated as zero when calculating the net balance
+   * - **Credit types**: If `credit_type_id` is not specified, the balance defaults
+   *   to USD (cents)
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.contracts.getNetBalance({
+   *   customer_id: '13117714-3f05-48e5-a6e9-a66093f13b4d',
+   *   credit_type_id: '2714e483-4ff1-48e4-9e25-ac732e8f24f2',
+   *   filters: [
+   *     {
+   *       balance_types: ['CREDIT'],
+   *       custom_fields: { campaign: 'free-trial' },
+   *     },
+   *     {
+   *       balance_types: ['PREPAID_COMMIT', 'POSTPAID_COMMIT'],
+   *       custom_fields: { campaign: 'signup-promotion' },
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  getNetBalance(
+    body: ContractGetNetBalanceParams,
+    options?: RequestOptions,
+  ): APIPromise<ContractGetNetBalanceResponse> {
+    return this._client.post('/v1/contracts/customerBalances/getNetBalance', { body, ...options });
+  }
+
   /**
    * Retrieve a comprehensive view of all available balances (commits and credits)
    * for a customer. This endpoint provides real-time visibility into prepaid funds,
@@ -624,6 +697,26 @@ export interface ContractCreateHistoricalInvoicesResponse {
   data: Array<InvoicesAPI.Invoice>;
 }
 
+export interface ContractGetNetBalanceResponse {
+  data: ContractGetNetBalanceResponse.Data;
+}
+
+export namespace ContractGetNetBalanceResponse {
+  export interface Data {
+    /**
+     * The combined net balance that the customer has access to use at this moment
+     * across all pertinent commits and credits.
+     */
+    balance: number;
+
+    /**
+     * The ID of the credit type (can be fiat or a custom pricing unit) that the
+     * balance is for.
+     */
+    credit_type_id: string;
+  }
+}
+
 export type ContractListBalancesResponse = Shared.Commit | Shared.Credit;
 
 export interface ContractRetrieveRateScheduleResponse {
@@ -763,12 +856,20 @@ export interface ContractCreateParams {
 
   overrides?: Array<ContractCreateParams.Override>;
 
-  prepaid_balance_threshold_configuration?: Shared.PrepaidBalanceThresholdConfiguration;
+  /**
+   * Selects the package linked to the specified alias as of the contract's start
+   * date. Mutually exclusive with package_id.
+   */
+  package_alias?: string;
 
   /**
-   * Priority of the contract.
+   * If provided, provisions a customer on a package instead of creating a
+   * traditional contract. When specified, only customer_id, starting_at, package_id,
+   * and uniqueness_key are allowed.
    */
-  priority?: number;
+  package_id?: string;
+
+  prepaid_balance_threshold_configuration?: Shared.PrepaidBalanceThresholdConfiguration;
 
   /**
    * This field's availability is dependent on your client's configuration.
@@ -1124,7 +1225,7 @@ export namespace ContractCreateParams {
        * not wish Metronome to calculate tax on your behalf. Leaving this field blank
        * will default to NONE.
        */
-      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
     }
 
     export namespace PaymentGateConfig {
@@ -1228,6 +1329,11 @@ export namespace ContractCreateParams {
 
     rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
 
+    /**
+     * Fraction of unused segments that will be rolled over. 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
@@ -1399,8 +1505,7 @@ export namespace ContractCreateParams {
     parent_behavior?: HierarchyConfiguration.ParentBehavior;
 
     /**
-     * Account hierarchy M3 - Indicates which customer should pay for the child's
-     * invoice charges
+     * Indicates which customer should pay for the child's invoice charges
      *
      * **SELF**: The child pays for its own invoice charges
      *
@@ -1409,8 +1514,8 @@ export namespace ContractCreateParams {
     payer?: 'SELF' | 'PARENT';
 
     /**
-     * Account hierarchy M3 - Indicates the behavior of the child's invoice statements
-     * on the parent's invoices.
+     * Indicates the behavior of the child's invoice statements on the parent's
+     * invoices.
      *
      * **CONSOLIDATE**: Child's invoice statements will be added to parent's
      * consolidated invoices
@@ -1430,8 +1535,8 @@ export namespace ContractCreateParams {
 
     export interface ParentBehavior {
       /**
-       * Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
-       * generated by the parent in a customer hierarchy
+       * Indicates the desired behavior of consolidated invoices generated by the parent
+       * in a customer hierarchy
        *
        * **CONCATENATE**: Statements on the invoices of child customers will be appended
        * to the consolidated invoice
@@ -1573,7 +1678,7 @@ export namespace ContractCreateParams {
      * Required for OVERWRITE type.
      */
     export interface OverwriteRate {
-      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
       credit_type_id?: string;
 
@@ -2754,7 +2859,7 @@ export namespace ContractAmendParams {
        * not wish Metronome to calculate tax on your behalf. Leaving this field blank
        * will default to NONE.
        */
-      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
     }
 
     export namespace PaymentGateConfig {
@@ -2858,6 +2963,11 @@ export namespace ContractAmendParams {
 
     rate_type?: 'COMMIT_RATE' | 'LIST_RATE';
 
+    /**
+     * Fraction of unused segments that will be rolled over. 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
@@ -3154,7 +3264,7 @@ export namespace ContractAmendParams {
      * Required for OVERWRITE type.
      */
     export interface OverwriteRate {
-      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'CUSTOM';
+      rate_type: 'FLAT' | 'PERCENTAGE' | 'SUBSCRIPTION' | 'TIERED' | 'TIERED_PERCENTAGE' | 'CUSTOM';
 
       credit_type_id?: string;
 
@@ -3483,6 +3593,32 @@ export namespace ContractCreateHistoricalInvoicesParams {
   }
 }
 
+export interface ContractGetNetBalanceParams {
+  /**
+   * The ID of the customer.
+   */
+  customer_id: string;
+
+  /**
+   * The ID of the credit type (can be fiat or a custom pricing unit) to get the
+   * balance for. Defaults to USD (cents) if not specified.
+   */
+  credit_type_id?: string;
+
+  /**
+   * Balance filters are OR'd together, so if a given commit or credit matches any of
+   * the filters, it will be included in the net balance.
+   */
+  filters?: Array<Shared.BalanceFilter>;
+
+  /**
+   * Controls which invoices are considered when calculating the remaining balance.
+   * `FINALIZED` considers only deductions from finalized invoices.
+   * `FINALIZED_AND_DRAFT` also includes deductions from pending draft invoices.
+   */
+  invoice_inclusion_mode?: 'FINALIZED' | 'FINALIZED_AND_DRAFT';
+}
+
 export interface ContractListBalancesParams extends BodyCursorPageParams {
   customer_id: string;
 
@@ -3729,6 +3865,7 @@ export declare namespace Contracts {
     type ContractAmendResponse as ContractAmendResponse,
     type ContractArchiveResponse as ContractArchiveResponse,
     type ContractCreateHistoricalInvoicesResponse as ContractCreateHistoricalInvoicesResponse,
+    type ContractGetNetBalanceResponse as ContractGetNetBalanceResponse,
     type ContractListBalancesResponse as ContractListBalancesResponse,
     type ContractRetrieveRateScheduleResponse as ContractRetrieveRateScheduleResponse,
     type ContractRetrieveSubscriptionQuantityHistoryResponse as ContractRetrieveSubscriptionQuantityHistoryResponse,
@@ -3742,6 +3879,7 @@ export declare namespace Contracts {
     type ContractAmendParams as ContractAmendParams,
     type ContractArchiveParams as ContractArchiveParams,
     type ContractCreateHistoricalInvoicesParams as ContractCreateHistoricalInvoicesParams,
+    type ContractGetNetBalanceParams as ContractGetNetBalanceParams,
     type ContractListBalancesParams as ContractListBalancesParams,
     type ContractRetrieveRateScheduleParams as ContractRetrieveRateScheduleParams,
     type ContractRetrieveSubscriptionQuantityHistoryParams as ContractRetrieveSubscriptionQuantityHistoryParams,

package/src/resources/v1/contracts/index.ts

@@ -8,6 +8,7 @@ export {
   type ContractAmendResponse,
   type ContractArchiveResponse,
   type ContractCreateHistoricalInvoicesResponse,
+  type ContractGetNetBalanceResponse,
   type ContractListBalancesResponse,
   type ContractRetrieveRateScheduleResponse,
   type ContractRetrieveSubscriptionQuantityHistoryResponse,
@@ -20,6 +21,7 @@ export {
   type ContractAmendParams,
   type ContractArchiveParams,
   type ContractCreateHistoricalInvoicesParams,
+  type ContractGetNetBalanceParams,
   type ContractListBalancesParams,
   type ContractRetrieveRateScheduleParams,
   type ContractRetrieveSubscriptionQuantityHistoryParams,

package/src/resources/v1/contracts/named-schedules.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 
+/**
+ * Named schedules are used for storing custom data that can change over time. Named schedules are often used in custom pricing logic.
+ */
 export class NamedSchedules extends APIResource {
   /**
    * Get a named schedule for the given rate card. This endpoint's availability is

package/src/resources/v1/contracts/products.ts

@@ -7,6 +7,9 @@ import { APIPromise } from '../../../core/api-promise';
 import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 
+/**
+ * Products are the items that customers purchase.
+ */
 export class Products extends APIResource {
   /**
    * Create a new product object. Products in Metronome represent your company's

package/src/resources/v1/contracts/rate-cards/named-schedules.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../../../core/api-promise';
 import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 
+/**
+ * Named schedules are used for storing custom data that can change over time. Named schedules are often used in custom pricing logic.
+ */
 export class NamedSchedules extends APIResource {
   /**
    * Get a named schedule for the given contract. This endpoint's availability is