@openmeter/client 1.0.0-beta.230 → 1.0.0-beta.232

package/dist/models/types.d.ts

@@ -43,11 +43,11 @@ export interface CursorMetaPage {
     /** URI to the last page. */
     last?: string;
     /** URI to the next page. */
-    next?: string;
+    next: string | null;
     /** URI to the previous page. */
-    previous?: string;
+    previous: string | null;
     /** Requested page size. */
-    size?: number;
+    size: number;
 }
 /** Standard error response. */
 export interface BaseError {
@@ -188,6 +188,52 @@ export interface RateCardBooleanEntitlement {
     /** The type of the entitlement template. */
     type: 'boolean';
 }
+/**
+ * Labels store metadata of an entity that can be used for filtering an entity list
+ * or for searching across entity types.
+ *
+ * Keys must be of length 1-63 characters, and cannot start with "kong", "konnect",
+ * "mesh", "kic", or "\_".
+ */
+export type UpdateLabels = Record<string, string>;
+/** Model for installing an app from the catalog with an API key. */
+export interface InstallAppStripeWithApiKey {
+    /** Type of the app. */
+    type: 'stripe';
+    /** Name of the app. */
+    name: string;
+    /**
+     * If true, a billing profile will be created for the app. The Stripe app will be
+     * also set as the default billing profile if the current default is a Sandbox app.
+     */
+    createBillingProfile: boolean;
+    /** API key for the app. */
+    apiKey: string;
+}
+/** Base model for installing an app from the catalog. */
+export interface InstallAppSandbox {
+    /** Type of the app. */
+    type: 'sandbox';
+    /** Name of the app. */
+    name: string;
+    /**
+     * If true, a billing profile will be created for the app. The Stripe app will be
+     * also set as the default billing profile if the current default is a Sandbox app.
+     */
+    createBillingProfile: boolean;
+}
+/** Base model for installing an app from the catalog. */
+export interface InstallAppExternalInvoicing {
+    /** Type of the app. */
+    type: 'external_invoicing';
+    /** Name of the app. */
+    name: string;
+    /**
+     * If true, a billing profile will be created for the app. The Stripe app will be
+     * also set as the default billing profile if the current default is a Sandbox app.
+     */
+    createBillingProfile: boolean;
+}
 /**
  * BillingWorkflowCollectionAlignmentSubscription specifies the alignment for
  * collecting the pending line items into an invoice.
@@ -249,14 +295,6 @@ export interface InvoiceLineExternalReferences {
     /** The ID assigned by the external invoicing app. */
     invoicingId?: string;
 }
-/**
- * Labels store metadata of an entity that can be used for filtering an entity list
- * or for searching across entity types.
- *
- * Keys must be of length 1-63 characters, and cannot start with "kong", "konnect",
- * "mesh", "kic", or "\_".
- */
-export type UpdateLabels = Record<string, string>;
 /**
  * Invoice-level invoicing settings.
  *
@@ -484,6 +522,22 @@ export interface CurrencyFiat {
      * the currency, such as "$" for US Dollar or "€" for Euro.
      */
     symbol?: string;
+    /**
+     * The precision of the currency. It should be a number that represents the number
+     * of decimal places used for the currency, such as 2 for US Dollar or Euro.
+     */
+    precision: number;
+    /**
+     * The decimal mark for the currency. It should be a string that represents the
+     * decimal mark of the currency, such as "." for US Dollar or "," for Euro.
+     */
+    decimalMark: string;
+    /**
+     * The thousand separator for the currency. It should be a string that represents
+     * the thousand separator of the currency, such as "," for US Dollar or "." for
+     * Euro.
+     */
+    thousandSeparator: string;
     code: string;
 }
 /** Filter options for listing cost bases. */
@@ -491,6 +545,36 @@ export interface ListCostBasesParamsFilter {
     /** Filter cost bases by fiat currency code. */
     fiatCode?: string;
 }
+/** CurrencyCustom create request. */
+export interface CreateCurrencyCustomRequest {
+    /**
+     * The name of the currency. It should be a human-readable string that represents
+     * the name of the currency, such as "US Dollar" or "Euro".
+     */
+    name: string;
+    /**
+     * The symbol of the currency. It should be a string that represents the symbol of
+     * the currency, such as "$" for US Dollar or "€" for Euro.
+     */
+    symbol?: string;
+    /**
+     * The precision of the currency. It should be a number that represents the number
+     * of decimal places used for the currency, such as 2 for US Dollar or Euro.
+     */
+    precision: number;
+    /**
+     * The decimal mark for the currency. It should be a string that represents the
+     * decimal mark of the currency, such as "." for US Dollar or "," for Euro.
+     */
+    decimalMark: string;
+    /**
+     * The thousand separator for the currency. It should be a string that represents
+     * the thousand separator of the currency, such as "," for US Dollar or "." for
+     * Euro.
+     */
+    thousandSeparator: string;
+    code: string;
+}
 /** Monetary amount in a specific currency. */
 export interface CurrencyAmount {
     amount: string;
@@ -650,99 +734,22 @@ export interface CursorPaginationQuery {
 /** Filter options for listing meters. */
 export interface ListMetersParamsFilter {
     /** Filter meters by key. */
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    key?: StringFieldFilter;
     /** Filter meters by name. */
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    name?: StringFieldFilter;
 }
 /** Filter options for listing LLM cost prices. */
 export interface ListLlmCostPricesParamsFilter {
     /** Filter by provider. e.g. ?filter[provider][eq]=openai */
-    provider?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    provider?: StringFieldFilter;
     /** Filter by model ID. e.g. ?filter[model_id][eq]=gpt-4 */
-    modelId?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    modelId?: StringFieldFilter;
     /** Filter by model name. e.g. ?filter[model_name][contains]=gpt */
-    modelName?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    modelName?: StringFieldFilter;
     /** Filter by currency code. e.g. ?filter[currency][eq]=USD */
-    currency?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    currency?: StringFieldFilter;
     /** Filter by source. e.g. ?filter[source][eq]=system */
-    source?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    source?: StringFieldFilter;
 }
 /**
  * Filters on the resource's `labels` field.
@@ -752,18 +759,7 @@ export interface ListLlmCostPricesParamsFilter {
  * `filter[labels][key]=value` (nested) and `filter[labels.key]=value`
  * (dot-notation).
  */
-export type LabelsFieldFilter = Record<string, string | {
-    eq?: string;
-    neq?: string;
-    contains?: string;
-    ocontains?: string[];
-    oeq?: string[];
-    gt?: string;
-    gte?: string;
-    lt?: string;
-    lte?: string;
-    exists?: boolean;
-}>;
+export type LabelsFieldFilter = Record<string, StringFieldFilter>;
 /** Customer reference. */
 export interface CustomerReference {
     id: string;
@@ -1293,7 +1289,7 @@ export interface CreateMeterRequest {
     labels?: Labels;
     key: string;
     /** The aggregation type to use for the meter. */
-    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    aggregation: MeterAggregation;
     /** The event type to include in the aggregation. */
     eventType: string;
     /**
@@ -1343,7 +1339,7 @@ export interface Meter {
     deletedAt?: Date;
     key: string;
     /** The aggregation type to use for the meter. */
-    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    aggregation: MeterAggregation;
     /** The event type to include in the aggregation. */
     eventType: string;
     /**
@@ -1602,9 +1598,10 @@ export interface CreateCreditGrantPurchase {
     /**
      * Cost basis per credit unit used to calculate the purchase amount.
      *
-     * If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge
-     * is $50.00. The value must be greater than 0. If the cost basis is 0, use
-     * `funding_method=none` instead.
+     * If `per_unit_cost_basis` is 0.50 and credit amount is
+     * $100.00, the total
+     * charge is $50.00. The value must be greater than 0. If the
+     * cost basis is 0, use `funding_method=none` instead.
      *
      * Defaults to 1.0.
      */
@@ -1652,9 +1649,10 @@ export interface CreditGrantPurchase {
     /**
      * Cost basis per credit unit used to calculate the purchase amount.
      *
-     * If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge
-     * is $50.00. The value must be greater than 0. If the cost basis is 0, use
-     * `funding_method=none` instead.
+     * If `per_unit_cost_basis` is 0.50 and credit amount is
+     * $100.00, the total
+     * charge is $50.00. The value must be greater than 0. If the
+     * cost basis is 0, use `funding_method=none` instead.
      *
      * Defaults to 1.0.
      */
@@ -1685,43 +1683,17 @@ export interface ListCreditGrantsParamsFilter {
     /** Filter credit grants by currency. */
     currency?: string;
     /** Filter credit grants by key. */
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    key?: StringFieldFilter;
 }
 /** Filter options for getting a credit balance. */
 export interface GetCreditBalanceParamsFilter {
     /** Filter credit balance by currency. */
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    currency?: StringFieldFilterExact;
     /**
      * Filter credit balance by feature key. Omit to return the total portfolio value.
      * Use `exists=false` to return only unrestricted balance.
      */
-    featureKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    featureKey?: StringFieldFilter;
 }
 /** Filter options for listing charges. */
 export interface ListChargesParamsFilter {
@@ -1737,48 +1709,25 @@ export interface ListChargesParamsFilter {
      *
      * If omitted, all statuses are returned except for `deleted`.
      */
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    status?: StringFieldFilterExact;
 }
 /** Filter options for listing plans. */
 export interface ListPlansParamsFilter {
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    status?: StringFieldFilterExact;
+    currency?: StringFieldFilterExact;
+}
+/** Request body for voiding a credit grant. */
+export interface VoidCreditGrantRequest {
+    /**
+     * How voiding adjusts payment state related to the grant.
+     *
+     * Currently only `none` is supported: voiding does not adjust invoices, payment
+     * authorization, settlement, payment intents, or external collection state. If
+     * payment later completes, the original invoiced amount may still be collected.
+     */
+    paymentAdjustment: 'none';
 }
 /** Subscription create request. */
 export interface SubscriptionCreate {
@@ -1918,20 +1867,6 @@ export interface UnitConfig {
      */
     displayUnit?: string;
 }
-/**
- * Available apps for billing integrations to connect with third-party services.
- * Apps can have various capabilities like syncing data from or to external
- * systems, integrating with third-party services for tax calculation, delivery of
- * invoices, collection of payments, etc.
- */
-export interface AppCatalogItem {
-    /** Type of the app. */
-    type: 'sandbox' | 'stripe' | 'external_invoicing';
-    /** Name of the app. */
-    name: string;
-    /** Description of the app. */
-    description: string;
-}
 /** Mapping of app types to tax codes. */
 export interface TaxCodeAppMapping {
     /** The app type that the tax code is associated with. */
@@ -1939,6 +1874,97 @@ export interface TaxCodeAppMapping {
     /** Tax code. */
     taxCode: string;
 }
+/** App capability describes a function that an App can perform. */
+export interface AppCapability {
+    /** Type of the capability. */
+    type: 'report_usage' | 'report_events' | 'calculate_tax' | 'invoice_customers' | 'collect_payments';
+    /** Key of the capability. */
+    key: string;
+    /** Name of the capability. */
+    name: string;
+    /** Description of the capability. */
+    description: string;
+}
+/** AppStripe update request. */
+export interface UpdateAppStripeRequest {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: UpdateLabels;
+    /** The app type. */
+    type: 'stripe';
+    /** The Stripe secret API key used to authenticate API requests. */
+    secretApiKey?: string;
+}
+/** AppSandbox update request. */
+export interface UpdateAppSandboxRequest {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: UpdateLabels;
+    /** The app type. */
+    type: 'sandbox';
+}
+/** AppExternalInvoicing update request. */
+export interface UpdateAppExternalInvoicingRequest {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: UpdateLabels;
+    /** The app type. */
+    type: 'external_invoicing';
+    /**
+     * Enable draft synchronization hook.
+     *
+     * When enabled, invoices will pause at the draft state and wait for the
+     * integration to call the draft synchronized endpoint before progressing to the
+     * issuing state. This allows the external system to validate and prepare the
+     * invoice data.
+     *
+     * When disabled, invoices automatically progress through the draft state based on
+     * the configured workflow timing.
+     */
+    enableDraftSyncHook: boolean;
+    /**
+     * Enable issuing synchronization hook.
+     *
+     * When enabled, invoices will pause at the issuing state and wait for the
+     * integration to call the issuing synchronized endpoint before progressing to the
+     * issued state. This ensures the external invoicing system has successfully
+     * created and finalized the invoice before it is marked as issued.
+     *
+     * When disabled, invoices automatically progress through the issuing state and are
+     * immediately marked as issued.
+     */
+    enableIssuingSyncHook: boolean;
+}
 /**
  * Identity stores the details required to identify an entity for tax purposes in a
  * specific country.
@@ -2047,51 +2073,7 @@ export interface InvoiceLineBaseDiscount {
 /** Filter options for listing currencies. */
 export interface ListCurrenciesParamsFilter {
     type?: 'fiat' | 'custom';
-    code?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-}
-/** Describes custom currency. */
-export interface CurrencyCustom {
-    /** The type of the currency. */
-    type: 'custom';
-    /**
-     * The name of the currency. It should be a human-readable string that represents
-     * the name of the currency, such as "US Dollar" or "Euro".
-     */
-    name: string;
-    /**
-     * The symbol of the currency. It should be a string that represents the symbol of
-     * the currency, such as "$" for US Dollar or "€" for Euro.
-     */
-    symbol?: string;
-    id: string;
-    code: string;
-    /** An ISO-8601 timestamp representation of the custom currency creation date. */
-    createdAt: Date;
-}
-/** CurrencyCustom create request. */
-export interface CreateCurrencyCustomRequest {
-    /**
-     * The name of the currency. It should be a human-readable string that represents
-     * the name of the currency, such as "US Dollar" or "Euro".
-     */
-    name: string;
-    /**
-     * The symbol of the currency. It should be a string that represents the symbol of
-     * the currency, such as "$" for US Dollar or "€" for Euro.
-     */
-    symbol?: string;
-    code: string;
+    code?: StringFieldFilter;
 }
 /** Query to evaluate feature access for a list of customers. */
 export interface GovernanceQueryRequest {
@@ -2164,8 +2146,13 @@ export interface CreditAdjustment {
 }
 /** The credit balance by currency. */
 export interface CreditBalance {
-    currency: string;
-    /** Credits available after applying currently live charge impacts. */
+    currency: BillingCurrencyCode;
+    /**
+     * Credits available after applying currently live charge impacts.
+     *
+     * Always zero for historical balance queries using the `timestamp` parameter
+     * because live charge impacts cannot be reconstructed historically.
+     */
     live: string;
     /** Credits that have been booked on the ledger as of the balance timestamp. */
     settled: string;
@@ -2191,33 +2178,22 @@ export interface CreateCreditAdjustmentRequest {
     description?: string;
     labels?: Labels;
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
 }
 /** Filter options for listing credit transactions. */
 export interface ListCreditTransactionsParamsFilter {
     /** Filter credit transactions by type. */
-    type?: 'funded' | 'consumed' | 'expired';
+    type?: 'funded' | 'consumed' | 'expired' | 'voided';
     /** Filter credit transactions by currency. */
-    currency?: string;
+    currency?: BillingCurrencyCode;
     /**
      * Filter credit transactions by feature key. Omit to return all credit
      * transactions. Use `exists=false` to return only unrestricted credit
      * transactions.
      */
-    featureKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    featureKey?: StringFieldFilter;
 }
 /**
  * A credit transaction represents a single credit movement on the customer's
@@ -2245,9 +2221,9 @@ export interface CreditTransaction {
     /** The date and time the transaction was booked. */
     bookedAt: Date;
     /** The type of credit transaction. */
-    type: 'funded' | 'consumed' | 'expired';
+    type: 'funded' | 'consumed' | 'expired' | 'voided';
     /** Currency of the balance affected by the transaction. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * Signed amount of the credit movement. Positive values add balance, negative
      * values reduce balance.
@@ -2405,173 +2381,34 @@ export interface LlmCostOverrideCreate {
 }
 /** Filter options for listing customers. */
 export interface ListCustomersParamsFilter {
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    primaryEmail?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    usageAttributionSubjectKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    planKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    billingProfileId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    primaryEmail?: StringFieldFilter;
+    usageAttributionSubjectKey?: StringFieldFilter;
+    planKey?: StringFieldFilter;
+    billingProfileId?: UlidFieldFilter;
 }
 /** Filter options for listing subscriptions. */
 export interface ListSubscriptionsParamsFilter {
-    id?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    planId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    planKey?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    id?: UlidFieldFilter;
+    customerId?: UlidFieldFilter;
+    status?: StringFieldFilterExact;
+    planId?: UlidFieldFilter;
+    planKey?: StringFieldFilterExact;
 }
 /** Filter options for listing features. */
 export interface ListFeatureParamsFilter {
-    meterId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    meterId?: UlidFieldFilter;
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
 }
 /** Filter options for listing add-ons. */
 export interface ListAddonsParamsFilter {
-    id?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    id?: UlidFieldFilter;
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    status?: StringFieldFilterExact;
+    currency?: StringFieldFilterExact;
 }
 /**
  * Tax configuration for a credit grant.
@@ -2742,164 +2579,43 @@ export interface UpdateRateCardTaxConfig {
 /** Filter options for listing ingested events. */
 export interface ListEventsParamsFilter {
     /** Filter events by ID. */
-    id?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    id?: StringFieldFilter;
     /** Filter events by source. */
-    source?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    source?: StringFieldFilter;
     /** Filter events by subject. */
-    subject?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    subject?: StringFieldFilter;
     /** Filter events by type. */
-    type?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    type?: StringFieldFilter;
     /** Filter events by the associated customer ID. */
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    customerId?: UlidFieldFilter;
     /** Filter events by event time. */
-    time?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    time?: DateTimeFieldFilter;
     /** Filter events by the time the event was ingested. */
-    ingestedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    ingestedAt?: DateTimeFieldFilter;
     /** Filter events by the time the event was stored. */
-    storedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    storedAt?: DateTimeFieldFilter;
 }
 /** Filter options for listing invoices. */
 export interface ListInvoicesParamsFilter {
     /** Filter by invoice status. */
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    status?: StringFieldFilterExact;
     /** Filter by customer ID. */
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    customerId?: UlidFieldFilter;
     /** Filter by the time the invoice was issued. */
-    issuedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    issuedAt?: DateTimeFieldFilter;
     /** Filter by service period start. */
-    servicePeriodStart?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    servicePeriodStart?: DateTimeFieldFilter;
     /** Filter by invoice creation time. */
-    createdAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    createdAt?: DateTimeFieldFilter;
 }
 /** Resource filters. */
 export interface ResourceFilters {
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    name?: StringFieldFilter;
     labels?: LabelsFieldFilter;
     publicLabels?: LabelsFieldFilter;
-    createdAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
-    updatedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
-    deletedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    createdAt?: DateTimeFieldFilter;
+    updatedAt?: DateTimeFieldFilter;
+    deletedAt?: DateTimeFieldFilter;
 }
 /** Field filters with all supported types. */
 export interface FieldFilters {
@@ -2915,35 +2631,10 @@ export interface FieldFilters {
         gt?: number;
         gte?: number;
     };
-    string?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    stringExact?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    ulid?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    datetime?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    string?: StringFieldFilter;
+    stringExact?: StringFieldFilterExact;
+    ulid?: UlidFieldFilter;
+    datetime?: DateTimeFieldFilter;
     labels?: LabelsFieldFilter;
 }
 /** An ingested metering event with ingestion metadata. */
@@ -2968,6 +2659,46 @@ export interface MeterQueryResult {
     /** The usage data. If no data is available, an empty array is returned. */
     data: MeterQueryRow[];
 }
+/** Describes custom currency. */
+export interface CurrencyCustom {
+    /** The type of the currency. */
+    type: 'custom';
+    /**
+     * The name of the currency. It should be a human-readable string that represents
+     * the name of the currency, such as "US Dollar" or "Euro".
+     */
+    name: string;
+    /**
+     * The symbol of the currency. It should be a string that represents the symbol of
+     * the currency, such as "$" for US Dollar or "€" for Euro.
+     */
+    symbol?: string;
+    /**
+     * The precision of the currency. It should be a number that represents the number
+     * of decimal places used for the currency, such as 2 for US Dollar or Euro.
+     */
+    precision: number;
+    /**
+     * The decimal mark for the currency. It should be a string that represents the
+     * decimal mark of the currency, such as "." for US Dollar or "," for Euro.
+     */
+    decimalMark: string;
+    /**
+     * The thousand separator for the currency. It should be a string that represents
+     * the thousand separator of the currency, such as "," for US Dollar or "." for
+     * Euro.
+     */
+    thousandSeparator: string;
+    id: string;
+    code: string;
+    /** An ISO-8601 timestamp representation of the custom currency creation date. */
+    createdAt: Date;
+    /**
+     * The list of active and scheduled cost bases for the custom currency. Expired and
+     * deleted cost bases are excluded.
+     */
+    costBasis?: CostBasis[];
+}
 /** Result of a feature cost query. */
 export interface FeatureCostQueryResult {
     /** Start of the queried period. */
@@ -3200,7 +2931,7 @@ export interface ChargeFlatFeeSystemIntent {
     /** The billing period the charge belongs to. */
     billingPeriod: ClosedPeriod;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The proration configuration of the charge. */
@@ -3228,7 +2959,7 @@ export interface SubscriptionChangeResponse {
 /** Request for canceling a subscription. */
 export interface SubscriptionCancel {
     /** If not provided the subscription is canceled immediately. */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /** Request for changing a subscription. */
 export interface SubscriptionChange {
@@ -3272,7 +3003,7 @@ export interface SubscriptionChange {
      * changing a subscription, the accepted values depend on the subscription
      * configuration.
      */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /** SubscriptionAddon create request. */
 export interface CreateSubscriptionAddonRequest {
@@ -3285,7 +3016,7 @@ export interface CreateSubscriptionAddonRequest {
      * The timing of the operation. After the create or update, a new entry will be
      * created in the timeline.
      */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /**
  * Usage quantity details on an invoice line item when UnitConfig is in effect.
@@ -3310,141 +3041,6 @@ export interface InvoiceUsageQuantityDetail {
      */
     appliedUnitConfig: UnitConfig;
 }
-/** Stripe app. */
-export interface AppStripe {
-    id: string;
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
-    /**
-     * Optional description of the resource.
-     *
-     * Maximum 1024 characters.
-     */
-    description?: string;
-    labels?: Labels;
-    /** An ISO-8601 timestamp representation of entity creation date. */
-    createdAt: Date;
-    /** An ISO-8601 timestamp representation of entity last update date. */
-    updatedAt: Date;
-    /** An ISO-8601 timestamp representation of entity deletion date. */
-    deletedAt?: Date;
-    /** The app type. */
-    type: 'stripe';
-    /** The app catalog definition that this installed app is based on. */
-    definition: AppCatalogItem;
-    /** Status of the app connection. */
-    status: 'ready' | 'unauthorized';
-    /** The Stripe account ID associated with the connected Stripe account. */
-    accountId: string;
-    /** Indicates whether the app is connected to a live Stripe account. */
-    livemode: boolean;
-    /** The masked Stripe API key that only exposes the first and last few characters. */
-    maskedApiKey: string;
-}
-/** Sandbox app can be used for testing billing features. */
-export interface AppSandbox {
-    id: string;
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
-    /**
-     * Optional description of the resource.
-     *
-     * Maximum 1024 characters.
-     */
-    description?: string;
-    labels?: Labels;
-    /** An ISO-8601 timestamp representation of entity creation date. */
-    createdAt: Date;
-    /** An ISO-8601 timestamp representation of entity last update date. */
-    updatedAt: Date;
-    /** An ISO-8601 timestamp representation of entity deletion date. */
-    deletedAt?: Date;
-    /** The app type. */
-    type: 'sandbox';
-    /** The app catalog definition that this installed app is based on. */
-    definition: AppCatalogItem;
-    /** Status of the app connection. */
-    status: 'ready' | 'unauthorized';
-}
-/**
- * External Invoicing app enables integration with third-party invoicing or payment
- * system.
- *
- * The app supports a bi-directional synchronization pattern where OpenMeter
- * Billing manages the invoice lifecycle while the external system handles invoice
- * presentation and payment collection.
- *
- * Integration workflow:
- *
- * 1. The billing system creates invoices and transitions them through lifecycle
- * states (draft → issuing → issued)
- * 2. The integration receives webhook notifications about invoice state changes
- * 3. The integration calls back to provide external system IDs and metadata
- * 4. The integration reports payment events back via the payment status API
- *
- * State synchronization is controlled by hooks that pause invoice progression
- * until the external system confirms synchronization via API callbacks.
- */
-export interface AppExternalInvoicing {
-    id: string;
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
-    /**
-     * Optional description of the resource.
-     *
-     * Maximum 1024 characters.
-     */
-    description?: string;
-    labels?: Labels;
-    /** An ISO-8601 timestamp representation of entity creation date. */
-    createdAt: Date;
-    /** An ISO-8601 timestamp representation of entity last update date. */
-    updatedAt: Date;
-    /** An ISO-8601 timestamp representation of entity deletion date. */
-    deletedAt?: Date;
-    /** The app type. */
-    type: 'external_invoicing';
-    /** The app catalog definition that this installed app is based on. */
-    definition: AppCatalogItem;
-    /** Status of the app connection. */
-    status: 'ready' | 'unauthorized';
-    /**
-     * Enable draft synchronization hook.
-     *
-     * When enabled, invoices will pause at the draft state and wait for the
-     * integration to call the draft synchronized endpoint before progressing to the
-     * issuing state. This allows the external system to validate and prepare the
-     * invoice data.
-     *
-     * When disabled, invoices automatically progress through the draft state based on
-     * the configured workflow timing.
-     */
-    enableDraftSyncHook: boolean;
-    /**
-     * Enable issuing synchronization hook.
-     *
-     * When enabled, invoices will pause at the issuing state and wait for the
-     * integration to call the issuing synchronized endpoint before progressing to the
-     * issued state. This ensures the external invoicing system has successfully
-     * created and finalized the invoice before it is marked as issued.
-     *
-     * When disabled, invoices automatically progress through the issuing state and are
-     * immediately marked as issued.
-     */
-    enableIssuingSyncHook: boolean;
-}
 /** TaxCode create request. */
 export interface CreateTaxCodeRequest {
     /**
@@ -3508,6 +3104,24 @@ export interface UpsertTaxCodeRequest {
     /** Mapping of app types to tax codes. */
     appMappings: TaxCodeAppMapping[];
 }
+/**
+ * Available apps for billing integrations to connect with third-party services.
+ * Apps can have various capabilities like syncing data from or to external
+ * systems, integrating with third-party services for tax calculation, delivery of
+ * invoices, collection of payments, etc.
+ */
+export interface AppCatalogItem {
+    /** Type of the app. */
+    type: 'sandbox' | 'stripe' | 'external_invoicing';
+    /** Name of the app. */
+    name: string;
+    /** Description of the app. */
+    description: string;
+    /** Capabilities of the app. */
+    capabilities: AppCapability[];
+    /** Available install methods of the app. */
+    installMethods: ('with_oauth2' | 'with_api_key' | 'no_credentials_required')[];
+}
 /**
  * Invoice-level snapshot of the workflow configuration.
  *
@@ -3519,7 +3133,7 @@ export interface InvoiceWorkflow {
     /** Invoicing settings for this invoice. */
     invoicing?: InvoiceWorkflowInvoicingSettings;
     /** Payment settings for this invoice. */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+    payment?: WorkflowPaymentSettings;
 }
 /** Detailed status information for a standard invoice. */
 export interface InvoiceStatusDetails {
@@ -3553,7 +3167,7 @@ export interface UpdateBillingInvoiceWorkflow {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettings;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
+    payment?: UpdateBillingWorkflowPaymentSettings;
 }
 /** Access status for a single feature. */
 export interface GovernanceFeatureAccess {
@@ -3689,7 +3303,7 @@ export interface CreateCreditGrantRequest {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: CreateCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -3721,8 +3335,9 @@ export interface CreateCreditGrantRequest {
     /**
      * Idempotency key for the credit grant creation request.
      *
-     * When provided, reusing the same key returns an HTTP 409 Conflict instead of
-     * creating a duplicate grant, which makes create requests safe to retry.
+     * Unique per customer: reusing the same key for the same customer returns an HTTP
+     * 409 Conflict instead of creating a duplicate grant, which makes create requests
+     * safe to retry. The same key may be reused across different customers.
      */
     key?: string;
 }
@@ -3756,7 +3371,7 @@ export interface CreditGrant {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -3784,8 +3399,9 @@ export interface CreditGrant {
     /**
      * Idempotency key for the credit grant creation request.
      *
-     * When provided, reusing the same key returns an HTTP 409 Conflict instead of
-     * creating a duplicate grant, which makes create requests safe to retry.
+     * Unique per customer: reusing the same key for the same customer returns an HTTP
+     * 409 Conflict instead of creating a duplicate grant, which makes create requests
+     * safe to retry. The same key may be reused across different customers.
      */
     key?: string;
     /**
@@ -3829,7 +3445,7 @@ export interface CreateChargeFlatFeeRequest {
     /** Tax configuration of the charge. */
     taxConfig?: TaxConfig;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The feature associated with the charge, when applicable. */
@@ -3878,7 +3494,7 @@ export interface IngestedEventPaginatedResponse {
     meta: CursorMeta;
 }
 /** The list of parameters that failed validation. */
-export type InvalidParameters = (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+export type InvalidParameters = InvalidParameter[];
 /** A meter query request. */
 export interface MeterQueryRequest {
     /** The start of the period the usage is queried from. */
@@ -3889,7 +3505,7 @@ export interface MeterQueryRequest {
      * The size of the time buckets to group the usage into. If not specified, the
      * usage is aggregated over the entire period.
      */
-    granularity?: 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+    granularity?: MeterQueryGranularity;
     /**
      * The value is the name of the time zone as defined in the IANA Time Zone Database
      * (http://www.iana.org/time-zones). The time zone is used to determine the start
@@ -4060,6 +3676,146 @@ export interface TaxCodePagePaginatedResponse {
     data: TaxCode[];
     meta: PaginatedMeta;
 }
+/** Stripe app. */
+export interface AppStripe {
+    id: string;
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    createdAt: Date;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updatedAt: Date;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deletedAt?: Date;
+    /** The app type. */
+    type: 'stripe';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+    /** The Stripe account ID associated with the connected Stripe account. */
+    accountId: string;
+    /** Indicates whether the app is connected to a live Stripe account. */
+    livemode: boolean;
+    /** The masked Stripe API key that only exposes the first and last few characters. */
+    maskedApiKey: string;
+}
+/** Sandbox app can be used for testing billing features. */
+export interface AppSandbox {
+    id: string;
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    createdAt: Date;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updatedAt: Date;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deletedAt?: Date;
+    /** The app type. */
+    type: 'sandbox';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+}
+/**
+ * External Invoicing app enables integration with third-party invoicing or payment
+ * system.
+ *
+ * The app supports a bi-directional synchronization pattern where OpenMeter
+ * Billing manages the invoice lifecycle while the external system handles invoice
+ * presentation and payment collection.
+ *
+ * Integration workflow:
+ *
+ * 1. The billing system creates invoices and transitions them through lifecycle
+ * states (draft → issuing → issued)
+ * 2. The integration receives webhook notifications about invoice state changes
+ * 3. The integration calls back to provide external system IDs and metadata
+ * 4. The integration reports payment events back via the payment status API
+ *
+ * State synchronization is controlled by hooks that pause invoice progression
+ * until the external system confirms synchronization via API callbacks.
+ */
+export interface AppExternalInvoicing {
+    id: string;
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    createdAt: Date;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updatedAt: Date;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deletedAt?: Date;
+    /** The app type. */
+    type: 'external_invoicing';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+    /**
+     * Enable draft synchronization hook.
+     *
+     * When enabled, invoices will pause at the draft state and wait for the
+     * integration to call the draft synchronized endpoint before progressing to the
+     * issuing state. This allows the external system to validate and prepare the
+     * invoice data.
+     *
+     * When disabled, invoices automatically progress through the draft state based on
+     * the configured workflow timing.
+     */
+    enableDraftSyncHook: boolean;
+    /**
+     * Enable issuing synchronization hook.
+     *
+     * When enabled, invoices will pause at the issuing state and wait for the
+     * integration to call the issuing synchronized endpoint before progressing to the
+     * issued state. This ensures the external invoicing system has successfully
+     * created and finalized the invoice before it is marked as issued.
+     *
+     * When disabled, invoices automatically progress through the issuing state and are
+     * immediately marked as issued.
+     */
+    enableIssuingSyncHook: boolean;
+}
+/** Page paginated response. */
+export interface AppCatalogItemPagePaginatedResponse {
+    data: AppCatalogItem[];
+    meta: PaginatedMeta;
+}
 /** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface InvoiceWorkflowSettings {
     /** The apps that will be used to orchestrate the invoice's workflow. */
@@ -4132,11 +3888,6 @@ export interface UpdateInvoiceWorkflowSettings {
      */
     workflow: UpdateBillingInvoiceWorkflow;
 }
-/** Page paginated response. */
-export interface CurrencyPagePaginatedResponse {
-    data: (CurrencyFiat | CurrencyCustom)[];
-    meta: PaginatedMeta;
-}
 /** Access evaluation result for a single resolved customer. */
 export interface GovernanceQueryResult {
     /**
@@ -4196,7 +3947,7 @@ export interface Feature {
      * "llm" to look up cost from the LLM cost database based on meter group-by
      * properties.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+    unitCost?: FeatureUnitCost;
 }
 /** Feature create request. */
 export interface CreateFeatureRequest {
@@ -4224,7 +3975,7 @@ export interface CreateFeatureRequest {
      * "llm" to look up cost from the LLM cost database based on meter group-by
      * properties.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+    unitCost?: FeatureUnitCost;
 }
 /**
  * Request body for updating a feature. Currently only the unit_cost field can be
@@ -4237,17 +3988,22 @@ export interface UpdateFeatureRequest {
      * properties. Set to `null` to clear the existing unit cost; omit to leave it
      * unchanged.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost | null;
+    unitCost?: FeatureUnitCost | null;
 }
 /** Page paginated response. */
 export interface CreditGrantPagePaginatedResponse {
     data: CreditGrant[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
+export interface CurrencyPagePaginatedResponse {
+    data: Currency[];
+    meta: PaginatedMeta;
+}
 /** Bad Request. */
 export interface BadRequest extends BaseError {
     /** The list of parameters that failed validation. */
-    invalidParameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+    invalidParameters: InvalidParameter[];
 }
 /**
  * Base fields shared by all invoice types.
@@ -4322,7 +4078,7 @@ export interface CustomerStripeCreateCheckoutSessionRequest {
  */
 export interface WorkflowCollectionSettings {
     /** The alignment for collecting the pending line items into an invoice. */
-    alignment: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    alignment: WorkflowCollectionAlignment;
     /**
      * This grace period can be used to delay the collection of the pending line items
      * specified in alignment.
@@ -4332,20 +4088,6 @@ export interface WorkflowCollectionSettings {
      */
     interval: string;
 }
-/** Page paginated response. */
-export interface AppPagePaginatedResponse {
-    data: (AppStripe | AppSandbox | AppExternalInvoicing)[];
-    meta: PaginatedMeta;
-}
-/** Applications used by a billing profile. */
-export interface ProfileApps {
-    /** The tax app used for this workflow. */
-    tax: AppStripe | AppSandbox | AppExternalInvoicing;
-    /** The invoicing app used for this workflow. */
-    invoicing: AppStripe | AppSandbox | AppExternalInvoicing;
-    /** The payment app used for this workflow. */
-    payment: AppStripe | AppSandbox | AppExternalInvoicing;
-}
 /** Response of the governance query. */
 export interface GovernanceQueryResponse {
     /** Access evaluation results, one entry per resolved customer. */
@@ -4418,7 +4160,7 @@ export interface ChargeFlatFee {
     /** Tax configuration of the charge. */
     taxConfig?: TaxConfig;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The feature associated with the charge, when applicable. */
@@ -4428,7 +4170,7 @@ export interface ChargeFlatFee {
     /** The amount after proration of the charge. */
     amountAfterProration: CurrencyAmount;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Current intent from the system lifecycle controller for a charge that has an
      * active manual override. The top-level charge fields remain the effective
@@ -4465,7 +4207,7 @@ export interface ChargeUsageBasedSystemIntent {
     /** Discounts applied to the usage-based charge. */
     discounts?: RateCardDiscounts;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * The timestamp when the system lifecycle controller intent was deleted. The
      * effective charge can remain visible while a manual override is active.
@@ -4506,7 +4248,7 @@ export interface CreateChargeUsageBasedRequest {
     /** The feature associated with the charge. */
     featureKey: string;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /** The full, unprorated service period of the charge. */
     fullServicePeriod?: ClosedPeriod;
     /** The billing period the charge belongs to. */
@@ -4530,13 +4272,18 @@ export interface RateCard {
     key: string;
     /** The feature associated with the rate card. */
     feature?: FeatureReference;
+    /**
+     * Overrides the containing plan or add-on currency for this rate card. When
+     * omitted, the containing resource currency applies.
+     */
+    currency?: BillingCurrencyCode;
     /**
      * The billing cadence of the rate card. When null, the charge is one-time
      * (non-recurring). Only valid for flat prices.
      */
     billingCadence?: string;
     /** The price of the rate card. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Unit conversion configuration for the rate card.
      *
@@ -4552,7 +4299,7 @@ export interface RateCard {
      * The payment term of the rate card. In advance payment term can only be used for
      * flat prices.
      */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /**
      * Spend commitments for this rate card. Only applicable to usage-based prices
      * (unit, graduated, volume).
@@ -4566,23 +4313,28 @@ export interface RateCard {
      * The entitlement template granted to subscribers of a plan or addon containing
      * this rate card. Requires `feature` to be set.
      */
-    entitlement?: RateCardMeteredEntitlement | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+    entitlement?: RateCardEntitlement;
 }
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface InvoiceLineRateCard {
     /** The price definition used to calculate charges for this line. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /** Tax configuration snapshot for this line. */
     taxConfig?: RateCardTaxConfig;
     /** The feature key associated with this line's rate card. */
     featureKey?: string;
     /** Discount configuration from the rate card. */
     discounts?: RateCardDiscounts;
+    /**
+     * Unit config snapshot applied when this line was billed, converting the raw
+     * metered quantity into the billed quantity. Frozen at billing time; read-only.
+     */
+    unitConfig?: UnitConfig;
 }
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface UpdateInvoiceLineRateCard {
     /** The price definition used to calculate charges for this line. */
-    price: UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
+    price: UpdatePrice;
     /** Tax configuration snapshot for this line. */
     taxConfig?: UpdateRateCardTaxConfig;
     /** The feature key associated with this line's rate card. */
@@ -4602,10 +4354,29 @@ export interface Workflow {
     /** The invoicing settings for this workflow */
     invoicing?: WorkflowInvoicingSettings;
     /** The payment settings for this workflow */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+    payment?: WorkflowPaymentSettings;
     /** The tax settings for this workflow */
     tax?: WorkflowTaxSettings;
 }
+/** Page paginated response. */
+export interface AppPagePaginatedResponse {
+    data: App[];
+    meta: PaginatedMeta;
+}
+/** Response of the app install. */
+export interface BillingInstallAppResponse {
+    app: App;
+    defaultForCapabilityTypes: ('report_usage' | 'report_events' | 'calculate_tax' | 'invoice_customers' | 'collect_payments')[];
+}
+/** Applications used by a billing profile. */
+export interface ProfileApps {
+    /** The tax app used for this workflow. */
+    tax: App;
+    /** The invoicing app used for this workflow. */
+    invoicing: App;
+    /** The payment app used for this workflow. */
+    payment: App;
+}
 /** A usage-based charge for a customer. */
 export interface ChargeUsageBased {
     id: string;
@@ -4672,7 +4443,7 @@ export interface ChargeUsageBased {
     /** Aggregated booked and realtime totals for the charge. */
     totals: ChargeTotals;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Current intent from the system lifecycle controller for a charge that has an
      * active manual override. The top-level charge fields remain the effective
@@ -4750,7 +4521,7 @@ export interface Addon {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * The date and time when the add-on becomes effective. When not specified, the
      * add-on is a draft.
@@ -4799,7 +4570,7 @@ export interface CreateAddonRequest {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The rate cards of the add-on. */
     rateCards: RateCard[];
 }
@@ -5099,7 +4870,7 @@ export interface Plan {
      */
     version: number;
     /** The currency code of the plan. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The billing cadence for subscriptions using this plan. */
     billingCadence: string;
     /** Whether pro-rating is enabled for this plan. */
@@ -5167,7 +4938,7 @@ export interface CreatePlanRequest {
      */
     key: string;
     /** The currency code of the plan. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The billing cadence for subscriptions using this plan. */
     billingCadence: string;
     /** Whether pro-rating is enabled for this plan. */
@@ -5213,7 +4984,7 @@ export interface ProfilePagePaginatedResponse {
 }
 /** Page paginated response. */
 export interface ChargePagePaginatedResponse {
-    data: (ChargeFlatFee | ChargeUsageBased)[];
+    data: Charge[];
     meta: PaginatedMeta;
 }
 /** Page paginated response. */
@@ -5305,7 +5076,7 @@ export interface InvoiceStandard {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLine[];
+    lines?: InvoiceLine[];
 }
 /** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequest {
@@ -5336,19 +5107,156 @@ export interface UpdateInvoiceStandardRequest {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponse {
-    data: InvoiceStandard[];
+    data: Invoice[];
     meta: PaginatedMeta;
 }
+/**
+ * Filters on the given string field value by either exact or fuzzy match. All
+ * properties are optional; provide exactly one to specify the comparison.
+ */
+export type StringFieldFilter = string | {
+    eq?: string;
+    neq?: string;
+    contains?: string;
+    ocontains?: string[];
+    oeq?: string[];
+    gt?: string;
+    gte?: string;
+    lt?: string;
+    lte?: string;
+    exists?: boolean;
+};
+/** The aggregation type to use for the meter. */
+export type MeterAggregation = 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+/**
+ * The granularity of the time grouping. Time durations are specified in ISO 8601
+ * format.
+ */
+export type MeterQueryGranularity = 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+/**
+ * Filters on the given string field value by exact match. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type StringFieldFilterExact = string | {
+    eq?: string;
+    oeq?: string[];
+    neq?: string;
+};
+/** The payment term of a flat price. */
+export type PricePaymentTerm = 'in_advance' | 'in_arrears';
+/** Fiat or custom currency code. */
+export type BillingCurrencyCode = string | string;
+/** Fiat or custom currency code. */
+export type CreateCurrencyCode = string | string;
+/**
+ * Filters on the given ULID field value by exact match. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type UlidFieldFilter = string | {
+    eq?: string;
+    oeq?: string[];
+    neq?: string;
+};
+/**
+ * Filters on the given datetime (RFC-3339) field value. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type DateTimeFieldFilter = Date | {
+    eq?: Date;
+    lt?: Date;
+    lte?: Date;
+    gt?: Date;
+    gte?: Date;
+};
+/**
+ * Subscription edit timing defined when the changes should take effect. If the
+ * provided configuration is not supported by the subscription, an error will be
+ * returned.
+ */
+export type SubscriptionEditTiming = 'immediate' | 'next_billing_cycle' | Date;
+/** Request to install an app from the catalog. */
+export type InstallAppRequest = InstallAppStripeWithApiKey | InstallAppSandbox | InstallAppExternalInvoicing;
+/** Payment settings for a billing workflow. */
+export type WorkflowPaymentSettings = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettings = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
+/** A parameter that failed validation. */
+export type InvalidParameter = InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem;
+/**
+ * Entitlement template configured on a rate card. The feature is taken from the
+ * rate card itself, so it is omitted here.
+ */
+export type RateCardEntitlement = RateCardMeteredEntitlement | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/** Request to update an installed app. */
+export type UpdateAppRequest = UpdateAppStripeRequest | UpdateAppSandboxRequest | UpdateAppExternalInvoicingRequest;
+/**
+ * Per-unit cost configuration for a feature. Either a fixed manual amount or a
+ * dynamic LLM cost lookup.
+ */
+export type FeatureUnitCost = FeatureManualUnitCost | FeatureLlmUnitCost;
+/** Fiat or custom currency. */
+export type Currency = CurrencyFiat | CurrencyCustom;
+/**
+ * The alignment for collecting the pending line items into an invoice.
+ *
+ * Defaults to subscription, which means that we are to create a new invoice every
+ * time the a subscription period starts (for in advance items) or ends (for in
+ * arrears items).
+ */
+export type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+/** Price. */
+export type Price = PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+/** Price. */
+export type UpdatePrice = UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
+/** Installed application. */
+export type App = AppStripe | AppSandbox | AppExternalInvoicing;
+/** Customer charge. */
+export type CreateChargeRequest = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequest;
+/** Customer charge. */
+export type Charge = ChargeFlatFee | ChargeUsageBased;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLine = InvoiceStandardLine;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type UpdateInvoiceLine = UpdateInvoiceStandardLine;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type Invoice = InvoiceStandard;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequest = UpdateInvoiceStandardRequest;
+/**
+ * Sort query.
+ *
+ * The `asc` suffix is optional as the default sort order is ascending. The `desc`
+ * suffix is used to specify a descending order.
+ */
 export interface SortQueryInput {
     /** The attribute to sort by. */
     by: string;
     /** The sort order. `asc` for ascending, `desc` for descending. */
     order?: 'asc' | 'desc';
 }
+/** Standard error response. */
 export interface BaseErrorInput {
     /** Type contains a URI that identifies the problem type. */
     type?: string;
@@ -5365,6 +5273,10 @@ export interface BaseErrorInput {
     instance: string;
     [key: string]: unknown;
 }
+/**
+ * Payment settings for a billing workflow when the collection method is send
+ * invoice.
+ */
 export interface WorkflowPaymentSendInvoiceSettingsInput {
     /** The collection method for the invoice. */
     collectionMethod: 'send_invoice';
@@ -5374,6 +5286,13 @@ export interface WorkflowPaymentSendInvoiceSettingsInput {
      */
     dueAfter?: string;
 }
+/**
+ * Invoice-level invoicing settings.
+ *
+ * A subset of BillingWorkflowInvoicingSettings limited to fields that are
+ * meaningful per-invoice. progressive_billing is omitted as it is a gather-time /
+ * profile-level decision.
+ */
 export interface InvoiceWorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draft_period has passed. */
     autoAdvance?: boolean;
@@ -5382,12 +5301,23 @@ export interface InvoiceWorkflowInvoicingSettingsInput {
     /** The period after which the invoice is considered overdue if not paid. */
     dueAfter?: string;
 }
+/**
+ * Invoice-level invoicing settings.
+ *
+ * A subset of BillingWorkflowInvoicingSettings limited to fields that are
+ * meaningful per-invoice. progressive_billing is omitted as it is a gather-time /
+ * profile-level decision.
+ */
 export interface UpdateBillingInvoiceWorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draft_period has passed. */
     autoAdvance?: boolean;
     /** The period for the invoice to be kept in draft status for manual reviews. */
     draftPeriod?: string;
 }
+/**
+ * Payment settings for a billing workflow when the collection method is send
+ * invoice.
+ */
 export interface UpdateBillingWorkflowPaymentSendInvoiceSettingsInput {
     /** The collection method for the invoice. */
     collectionMethod: 'send_invoice';
@@ -5397,6 +5327,7 @@ export interface UpdateBillingWorkflowPaymentSendInvoiceSettingsInput {
      */
     dueAfter?: string;
 }
+/** Metering event following the CloudEvents specification. */
 export interface EventInput {
     /** Identifies the event. */
     id: string;
@@ -5426,30 +5357,43 @@ export interface EventInput {
     /** The event payload. Optional, if present it must be a JSON object. */
     data?: Record<string, unknown> | null;
 }
+/** Unauthorized. */
 export interface UnauthorizedInput extends BaseErrorInput {
 }
+/** Forbidden. */
 export interface ForbiddenInput extends BaseErrorInput {
 }
+/** Not Found. */
 export interface NotFoundInput extends BaseErrorInput {
 }
+/** Gone. */
 export interface GoneInput extends BaseErrorInput {
 }
+/** Conflict. */
 export interface ConflictInput extends BaseErrorInput {
 }
+/** Payload Too Large. */
 export interface PayloadTooLargeInput extends BaseErrorInput {
 }
+/** Unsupported Media Type. */
 export interface UnsupportedMediaTypeInput extends BaseErrorInput {
 }
+/** Unprocessable Content. */
 export interface UnprocessableContentInput extends BaseErrorInput {
 }
+/** Too Many Requests. */
 export interface TooManyRequestsInput extends BaseErrorInput {
 }
+/** Internal Server Error. */
 export interface InternalInput extends BaseErrorInput {
 }
+/** Not Implemented. */
 export interface NotImplementedInput extends BaseErrorInput {
 }
+/** Not Available. */
 export interface NotAvailableInput extends BaseErrorInput {
 }
+/** Controls which customer fields can be updated by the checkout session. */
 export interface AppStripeCreateCheckoutSessionCustomerUpdateInput {
     /**
      * Whether to save the billing address to customer.address.
@@ -5470,6 +5414,7 @@ export interface AppStripeCreateCheckoutSessionCustomerUpdateInput {
      */
     shipping?: 'auto' | 'never';
 }
+/** Tax ID collection configuration for checkout sessions. */
 export interface AppStripeCreateCheckoutSessionTaxIdCollectionInput {
     /**
      * Enable tax ID collection during checkout.
@@ -5484,15 +5429,17 @@ export interface AppStripeCreateCheckoutSessionTaxIdCollectionInput {
      */
     required?: 'if_supported' | 'never';
 }
+/** Purchase and payment terms of the grant. */
 export interface CreateCreditGrantPurchaseInput {
     /** Currency of the purchase amount. */
     currency: string;
     /**
      * Cost basis per credit unit used to calculate the purchase amount.
      *
-     * If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge
-     * is $50.00. The value must be greater than 0. If the cost basis is 0, use
-     * `funding_method=none` instead.
+     * If `per_unit_cost_basis` is 0.50 and credit amount is
+     * $100.00, the total
+     * charge is $50.00. The value must be greater than 0. If the
+     * cost basis is 0, use `funding_method=none` instead.
      *
      * Defaults to 1.0.
      */
@@ -5504,6 +5451,7 @@ export interface CreateCreditGrantPurchaseInput {
      */
     availabilityPolicy?: 'on_creation';
 }
+/** The entitlement template of a metered entitlement. */
 export interface RateCardMeteredEntitlementInput {
     /** The type of the entitlement template. */
     type: 'metered';
@@ -5525,15 +5473,17 @@ export interface RateCardMeteredEntitlementInput {
      */
     usagePeriod?: string;
 }
+/** Purchase and payment terms of the grant. */
 export interface CreditGrantPurchaseInput {
     /** Currency of the purchase amount. */
     currency: string;
     /**
      * Cost basis per credit unit used to calculate the purchase amount.
      *
-     * If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge
-     * is $50.00. The value must be greater than 0. If the cost basis is 0, use
-     * `funding_method=none` instead.
+     * If `per_unit_cost_basis` is 0.50 and credit amount is
+     * $100.00, the total
+     * charge is $50.00. The value must be greater than 0. If the
+     * cost basis is 0, use `funding_method=none` instead.
      *
      * Defaults to 1.0.
      */
@@ -5549,6 +5499,41 @@ export interface CreditGrantPurchaseInput {
     /** Current payment settlement status. */
     settlementStatus?: 'pending' | 'authorized' | 'settled';
 }
+/** Request body for voiding a credit grant. */
+export interface VoidCreditGrantRequestInput {
+    /**
+     * How voiding adjusts payment state related to the grant.
+     *
+     * Currently only `none` is supported: voiding does not adjust invoices, payment
+     * authorization, settlement, payment intents, or external collection state. If
+     * payment later completes, the original invoiced amount may still be collected.
+     */
+    paymentAdjustment?: 'none';
+}
+/**
+ * Unit conversion configuration.
+ *
+ * Transforms raw metered quantities into billing-ready units before pricing and
+ * entitlement evaluation. Applied at the rate card level so the same feature can
+ * be billed in different units across plans.
+ *
+ * Examples:
+ *
+ * - Meter bytes, bill GB: operation=divide, conversionFactor=1e9,
+ * rounding=ceiling, displayUnit="GB"
+ * - Meter seconds, bill hours: operation=divide, conversionFactor=3600,
+ * rounding=ceiling, displayUnit="hours"
+ * - Cost + 20% margin: operation=multiply, conversionFactor=1.2
+ * - Bill per million tokens: operation=divide, conversionFactor=1e6,
+ * rounding=ceiling, displayUnit="M"
+ *
+ * v1 equivalents:
+ *
+ * - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier +
+ * UnitPrice(amount=1)
+ * - PackagePrice(amount, quantityPerPkg): operation=divide,
+ * conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)
+ */
 export interface UnitConfigInput {
     /** The arithmetic operation to apply to the raw metered quantity. */
     operation: 'divide' | 'multiply';
@@ -5583,6 +5568,7 @@ export interface UnitConfigInput {
      */
     displayUnit?: string;
 }
+/** Invoice settings for a billing workflow. */
 export interface WorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draftPeriod has passed. */
     autoAdvance?: boolean;
@@ -5593,6 +5579,7 @@ export interface WorkflowInvoicingSettingsInput {
     /** Controls how subscription-ending shortened service periods are billed. */
     subscriptionEndProrationMode?: 'bill_full_period' | 'bill_actual_period';
 }
+/** Query to evaluate feature access for a list of customers. */
 export interface GovernanceQueryRequestInput {
     /**
      * Whether to include credit balance availability for each resolved customer. When
@@ -5604,6 +5591,7 @@ export interface GovernanceQueryRequestInput {
     customer: GovernanceQueryRequestCustomers;
     feature?: GovernanceQueryRequestFeatures;
 }
+/** An ingested metering event with ingestion metadata. */
 export interface IngestedEventInput {
     /** The original event ingested. */
     event: EventInput;
@@ -5616,10 +5604,16 @@ export interface IngestedEventInput {
     /** The validation errors of the ingested event. */
     validationErrors?: IngestedEventValidationError[];
 }
+/** Request for canceling a subscription. */
 export interface SubscriptionCancelInput {
     /** If not provided the subscription is canceled immediately. */
-    timing?: 'immediate' | 'next_billing_cycle' | Date;
+    timing?: SubscriptionEditTiming;
 }
+/**
+ * Usage quantity details on an invoice line item when UnitConfig is in effect.
+ *
+ * Provides the full audit trail from raw meter output to the invoiced amount.
+ */
 export interface InvoiceUsageQuantityDetailInput {
     /** The raw quantity as reported by the meter (native units). */
     rawQuantity: string;
@@ -5638,18 +5632,33 @@ export interface InvoiceUsageQuantityDetailInput {
      */
     appliedUnitConfig: UnitConfigInput;
 }
+/**
+ * Invoice-level snapshot of the workflow configuration.
+ *
+ * Contains only the settings that are meaningful for an already-created invoice:
+ * invoicing behaviour and payment settings. Collection alignment and tax policy
+ * are gather-time / profile-wide concerns and are not included.
+ */
 export interface InvoiceWorkflowInput {
     /** Invoicing settings for this invoice. */
     invoicing?: InvoiceWorkflowInvoicingSettingsInput;
     /** Payment settings for this invoice. */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+    payment?: WorkflowPaymentSettingsInput;
 }
+/**
+ * Invoice-level snapshot of the workflow configuration.
+ *
+ * Contains only the settings that are meaningful for an already-created invoice:
+ * invoicing behaviour and payment settings. Collection alignment and tax policy
+ * are gather-time / profile-wide concerns and are not included.
+ */
 export interface UpdateBillingInvoiceWorkflowInput {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettingsInput;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
+    payment?: UpdateBillingWorkflowPaymentSettingsInput;
 }
+/** CreditGrant create request. */
 export interface CreateCreditGrantRequestInput {
     /**
      * Display name of the resource.
@@ -5667,7 +5676,7 @@ export interface CreateCreditGrantRequestInput {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: CreateCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -5699,11 +5708,18 @@ export interface CreateCreditGrantRequestInput {
     /**
      * Idempotency key for the credit grant creation request.
      *
-     * When provided, reusing the same key returns an HTTP 409 Conflict instead of
-     * creating a duplicate grant, which makes create requests safe to retry.
+     * Unique per customer: reusing the same key for the same customer returns an HTTP
+     * 409 Conflict instead of creating a duplicate grant, which makes create requests
+     * safe to retry. The same key may be reused across different customers.
      */
     key?: string;
 }
+/**
+ * A credit grant allocates credits to a customer.
+ *
+ * Credits are drawn down against charges according to the settlement mode
+ * configured on the rate card.
+ */
 export interface CreditGrantInput {
     id: string;
     /**
@@ -5728,7 +5744,7 @@ export interface CreditGrantInput {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -5756,8 +5772,9 @@ export interface CreditGrantInput {
     /**
      * Idempotency key for the credit grant creation request.
      *
-     * When provided, reusing the same key returns an HTTP 409 Conflict instead of
-     * creating a duplicate grant, which makes create requests safe to retry.
+     * Unique per customer: reusing the same key for the same customer returns an HTTP
+     * 409 Conflict instead of creating a duplicate grant, which makes create requests
+     * safe to retry. The same key may be reused across different customers.
      */
     key?: string;
     /**
@@ -5771,6 +5788,7 @@ export interface CreditGrantInput {
     /** Current lifecycle status of the grant. */
     status: 'pending' | 'active' | 'expired' | 'voided';
 }
+/** Tax settings for a billing workflow. */
 export interface WorkflowTaxSettingsInput {
     /**
      * Enable automatic tax calculation when tax is supported by the app. For example,
@@ -5794,10 +5812,12 @@ export interface WorkflowTaxSettingsInput {
      */
     defaultTaxConfig?: TaxConfig;
 }
+/** Cursor paginated response. */
 export interface IngestedEventPaginatedResponseInput {
     data: IngestedEventInput[];
     meta: CursorMeta;
 }
+/** A meter query request. */
 export interface MeterQueryRequestInput {
     /** The start of the period the usage is queried from. */
     from?: Date;
@@ -5807,7 +5827,7 @@ export interface MeterQueryRequestInput {
      * The size of the time buckets to group the usage into. If not specified, the
      * usage is aggregated over the entire period.
      */
-    granularity?: 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+    granularity?: MeterQueryGranularity;
     /**
      * The value is the name of the time zone as defined in the IANA Time Zone Database
      * (http://www.iana.org/time-zones). The time zone is used to determine the start
@@ -5819,6 +5839,12 @@ export interface MeterQueryRequestInput {
     /** Filters to apply to the query. */
     filters?: MeterQueryFilters;
 }
+/**
+ * Configuration options for creating a Stripe Checkout Session.
+ *
+ * Based on Stripe's
+ * [Checkout Session API parameters](https://docs.stripe.com/api/checkout/sessions/create).
+ */
 export interface AppStripeCreateCheckoutSessionRequestOptionsInput {
     /**
      * Whether to collect the customer's billing address.
@@ -5906,6 +5932,7 @@ export interface AppStripeCreateCheckoutSessionRequestOptionsInput {
     /** Configuration for collecting tax IDs during checkout. */
     taxIdCollection?: AppStripeCreateCheckoutSessionTaxIdCollectionInput;
 }
+/** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface InvoiceWorkflowSettingsInput {
     /** The apps that will be used to orchestrate the invoice's workflow. */
     apps?: InvoiceWorkflowAppsReferences;
@@ -5921,6 +5948,12 @@ export interface InvoiceWorkflowSettingsInput {
      */
     workflow: InvoiceWorkflowInput;
 }
+/**
+ * A detailed (child) sub-line belonging to a parent invoice line.
+ *
+ * Detailed lines represent the individual flat-fee components that make up a
+ * usage-based parent line after quantity snapshotting.
+ */
 export interface InvoiceDetailedLineInput {
     id: string;
     /**
@@ -5959,6 +5992,7 @@ export interface InvoiceDetailedLineInput {
     /** The unit price of the detailed line. */
     unitPrice: string;
 }
+/** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface UpdateInvoiceWorkflowSettingsInput {
     /**
      * The workflow configuration that was active when the invoice was created.
@@ -5970,14 +6004,23 @@ export interface UpdateInvoiceWorkflowSettingsInput {
      */
     workflow: UpdateBillingInvoiceWorkflowInput;
 }
+/** Page paginated response. */
 export interface CreditGrantPagePaginatedResponseInput {
     data: CreditGrantInput[];
     meta: PaginatedMeta;
 }
+/** Bad Request. */
 export interface BadRequestInput extends BaseErrorInput {
     /** The list of parameters that failed validation. */
-    invalidParameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+    invalidParameters: InvalidParameter[];
 }
+/**
+ * Request to create a Stripe Checkout Session for the customer.
+ *
+ * Checkout Sessions are used to collect payment method information from customers
+ * in a secure, Stripe-hosted interface. This integration uses setup mode to
+ * collect payment methods that can be charged later for subscription billing.
+ */
 export interface CustomerStripeCreateCheckoutSessionRequestInput {
     /**
      * Options for configuring the Stripe Checkout Session.
@@ -5987,9 +6030,13 @@ export interface CustomerStripeCreateCheckoutSessionRequestInput {
      */
     stripeOptions: AppStripeCreateCheckoutSessionRequestOptionsInput;
 }
+/**
+ * Workflow collection specifies how to collect the pending line items for an
+ * invoice.
+ */
 export interface WorkflowCollectionSettingsInput {
     /** The alignment for collecting the pending line items into an invoice. */
-    alignment?: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    alignment?: WorkflowCollectionAlignment;
     /**
      * This grace period can be used to delay the collection of the pending line items
      * specified in alignment.
@@ -5999,6 +6046,7 @@ export interface WorkflowCollectionSettingsInput {
      */
     interval?: string;
 }
+/** A rate card defines the pricing and entitlement of a feature or service. */
 export interface RateCardInput {
     /**
      * Display name of the resource.
@@ -6016,13 +6064,18 @@ export interface RateCardInput {
     key: string;
     /** The feature associated with the rate card. */
     feature?: FeatureReference;
+    /**
+     * Overrides the containing plan or add-on currency for this rate card. When
+     * omitted, the containing resource currency applies.
+     */
+    currency?: BillingCurrencyCode;
     /**
      * The billing cadence of the rate card. When null, the charge is one-time
      * (non-recurring). Only valid for flat prices.
      */
     billingCadence?: string;
     /** The price of the rate card. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Unit conversion configuration for the rate card.
      *
@@ -6038,7 +6091,7 @@ export interface RateCardInput {
      * The payment term of the rate card. In advance payment term can only be used for
      * flat prices.
      */
-    paymentTerm?: 'in_advance' | 'in_arrears';
+    paymentTerm?: PricePaymentTerm;
     /**
      * Spend commitments for this rate card. Only applicable to usage-based prices
      * (unit, graduated, volume).
@@ -6052,24 +6105,46 @@ export interface RateCardInput {
      * The entitlement template granted to subscribers of a plan or addon containing
      * this rate card. Requires `feature` to be set.
      */
-    entitlement?: RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+    entitlement?: RateCardEntitlementInput;
+}
+/** Rate card configuration snapshot for a usage-based invoice line. */
+export interface InvoiceLineRateCardInput {
+    /** The price definition used to calculate charges for this line. */
+    price: Price;
+    /** Tax configuration snapshot for this line. */
+    taxConfig?: RateCardTaxConfig;
+    /** The feature key associated with this line's rate card. */
+    featureKey?: string;
+    /** Discount configuration from the rate card. */
+    discounts?: RateCardDiscounts;
+    /**
+     * Unit config snapshot applied when this line was billed, converting the raw
+     * metered quantity into the billed quantity. Frozen at billing time; read-only.
+     */
+    unitConfig?: UnitConfigInput;
 }
+/** Billing workflow settings. */
 export interface WorkflowInput {
     /** The collection settings for this workflow */
     collection?: WorkflowCollectionSettingsInput;
     /** The invoicing settings for this workflow */
     invoicing?: WorkflowInvoicingSettingsInput;
     /** The payment settings for this workflow */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+    payment?: WorkflowPaymentSettingsInput;
     /** The tax settings for this workflow */
     tax?: WorkflowTaxSettingsInput;
 }
+/** A rate card for a subscription add-on. */
 export interface SubscriptionAddonRateCardInput {
     /** The rate card. */
     rateCard: RateCardInput;
     /** The IDs of the subscription items that this rate card belongs to. */
     affectedSubscriptionItemIds: string[];
 }
+/**
+ * The plan phase or pricing ramp allows changing a plan's rate cards over time as
+ * a subscription progresses.
+ */
 export interface PlanPhaseInput {
     /**
      * Display name of the resource.
@@ -6093,6 +6168,10 @@ export interface PlanPhaseInput {
     /** The rate cards of the plan. */
     rateCards: RateCardInput[];
 }
+/**
+ * Add-on allows extending subscriptions with compatible plans with additional
+ * ratecards.
+ */
 export interface AddonInput {
     id: string;
     /**
@@ -6125,7 +6204,7 @@ export interface AddonInput {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * The date and time when the add-on becomes effective. When not specified, the
      * add-on is a draft.
@@ -6150,6 +6229,7 @@ export interface AddonInput {
     /** List of validation errors. */
     validationErrors?: ProductCatalogValidationError[];
 }
+/** Addon create request. */
 export interface CreateAddonRequestInput {
     /**
      * Display name of the resource.
@@ -6173,10 +6253,11 @@ export interface CreateAddonRequestInput {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The rate cards of the add-on. */
     rateCards: RateCardInput[];
 }
+/** Addon upsert request. */
 export interface UpsertAddonRequestInput {
     /**
      * Display name of the resource.
@@ -6196,6 +6277,13 @@ export interface UpsertAddonRequestInput {
     /** The rate cards of the add-on. */
     rateCards: RateCardInput[];
 }
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
 export interface InvoiceStandardLineInput {
     /**
      * Display name of the resource.
@@ -6250,7 +6338,7 @@ export interface InvoiceStandardLineInput {
     /** Reference to the subscription item that generated this line. */
     subscription?: SubscriptionReference;
     /** The rate card configuration snapshot used to price this line item. */
-    rateCard: InvoiceLineRateCard;
+    rateCard: InvoiceLineRateCardInput;
     /**
      * Detailed sub-lines that this line has been broken down into.
      *
@@ -6260,6 +6348,10 @@ export interface InvoiceStandardLineInput {
     /** Reference to the charge associated with this line item. */
     charge?: ChargeReference;
 }
+/**
+ * Billing profiles contain the settings for billing and controls invoice
+ * generation.
+ */
 export interface ProfileInput {
     id: string;
     /**
@@ -6293,6 +6385,7 @@ export interface ProfileInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** BillingProfile create request. */
 export interface CreateBillingProfileRequestInput {
     /**
      * Display name of the resource.
@@ -6319,6 +6412,7 @@ export interface CreateBillingProfileRequestInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** BillingProfile upsert request. */
 export interface UpsertBillingProfileRequestInput {
     /**
      * Display name of the resource.
@@ -6343,6 +6437,7 @@ export interface UpsertBillingProfileRequestInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** Addon purchased with a subscription. */
 export interface SubscriptionAddonInput {
     id: string;
     labels?: Labels;
@@ -6382,6 +6477,7 @@ export interface SubscriptionAddonInput {
     /** The rate cards of the add-on. */
     rateCards: SubscriptionAddonRateCardInput[];
 }
+/** Plans provide a template for subscriptions. */
 export interface PlanInput {
     id: string;
     /**
@@ -6415,7 +6511,7 @@ export interface PlanInput {
      */
     version?: number;
     /** The currency code of the plan. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The billing cadence for subscriptions using this plan. */
     billingCadence: string;
     /** Whether pro-rating is enabled for this plan. */
@@ -6461,6 +6557,7 @@ export interface PlanInput {
      */
     validationErrors?: ProductCatalogValidationError[];
 }
+/** Plan create request. */
 export interface CreatePlanRequestInput {
     /**
      * Display name of the resource.
@@ -6482,7 +6579,7 @@ export interface CreatePlanRequestInput {
      */
     key: string;
     /** The currency code of the plan. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The billing cadence for subscriptions using this plan. */
     billingCadence: string;
     /** Whether pro-rating is enabled for this plan. */
@@ -6493,6 +6590,7 @@ export interface CreatePlanRequestInput {
      */
     phases: PlanPhaseInput[];
 }
+/** Plan upsert request. */
 export interface UpsertPlanRequestInput {
     /**
      * Display name of the resource.
@@ -6515,22 +6613,27 @@ export interface UpsertPlanRequestInput {
      */
     phases: PlanPhaseInput[];
 }
+/** Page paginated response. */
 export interface AddonPagePaginatedResponseInput {
     data: AddonInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface ProfilePagePaginatedResponseInput {
     data: ProfileInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface SubscriptionAddonPagePaginatedResponseInput {
     data: SubscriptionAddonInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface PlanPagePaginatedResponseInput {
     data: PlanInput[];
     meta: PaginatedMeta;
 }
+/** A standard invoice for charges owed by the customer. */
 export interface InvoiceStandardInput {
     id: string;
     /**
@@ -6609,8 +6712,9 @@ export interface InvoiceStandardInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLineInput[];
+    lines?: InvoiceLineInput[];
 }
+/** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequestInput {
     /**
      * Optional description of the resource.
@@ -6639,10 +6743,37 @@ export interface UpdateInvoiceStandardRequestInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
+/** Page paginated response. */
 export interface InvoicePagePaginatedResponseInput {
-    data: InvoiceStandardInput[];
+    data: InvoiceInput[];
     meta: PaginatedMeta;
 }
-//# sourceMappingURL=types.d.ts.map
+/** Payment settings for a billing workflow. */
+export type WorkflowPaymentSettingsInput = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettingsInput = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
+/**
+ * Entitlement template configured on a rate card. The feature is taken from the
+ * rate card itself, so it is omitted here.
+ */
+export type RateCardEntitlementInput = RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLineInput = InvoiceStandardLineInput;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type InvoiceInput = InvoiceStandardInput;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequestInput = UpdateInvoiceStandardRequestInput;