@openmeter/client 1.0.0-beta-1e01089e8f75 → 1.0.0-beta-19a1f6bdbcd5

package/dist/models/types.d.ts

@@ -587,18 +587,6 @@ export interface PriceFlat {
     /** The amount of the flat price. */
     amount: string;
 }
-/**
- * Unit price.
- *
- * Charges a fixed rate per billing unit. When UnitConfig is present on the rate
- * card, billing units are the converted quantities (e.g. GB instead of bytes).
- */
-export interface PriceUnit {
-    /** The type of the price. */
-    type: 'unit';
-    /** The amount of the unit price. */
-    amount: string;
-}
 /** Discount configuration for a rate card. */
 export interface RateCardDiscounts {
     /** Percentage discount applied to the price (0–100). */
@@ -630,8 +618,20 @@ export interface Totals {
     total: string;
 }
 /**
- * Spend commitments for a rate card. The customer is committed to spend at least
- * the minimum amount and at most the maximum amount.
+ * Unit price.
+ *
+ * Charges a fixed rate per billing unit. When UnitConfig is present on the object,
+ * billing units are the converted quantities (e.g. GB instead of bytes).
+ */
+export interface PriceUnit {
+    /** The type of the price. */
+    type: 'unit';
+    /** The amount of the unit price. */
+    amount: string;
+}
+/**
+ * Spend commitments for a usage-based price. The customer is committed to spend at
+ * least the minimum amount and at most the maximum amount.
  */
 export interface SpendCommitments {
     /** The customer is committed to spend at least the amount. */
@@ -672,8 +672,8 @@ export interface UpdatePriceFlat {
 /**
  * Unit price.
  *
- * Charges a fixed rate per billing unit. When UnitConfig is present on the rate
- * card, billing units are the converted quantities (e.g. GB instead of bytes).
+ * Charges a fixed rate per billing unit. When UnitConfig is present on the object,
+ * billing units are the converted quantities (e.g. GB instead of bytes).
  */
 export interface UpdatePriceUnit {
     /** The type of the price. */
@@ -1778,52 +1778,12 @@ export interface SubscriptionProRatingConfig {
     /** How pro-rating is calculated when enabled. */
     mode: 'no_proration' | 'prorate_prices';
 }
-/** Subscription create request. */
-export interface SubscriptionCreate {
-    labels?: Labels;
-    /**
-     * Settlement mode for billing.
-     *
-     * Values:
-     *
-     * - `credit_then_invoice`: Credits are applied first, then any remainder is
-     * invoiced.
-     * - `credit_only`: Usage is settled exclusively against credits.
-     */
-    settlementMode?: 'credit_then_invoice' | 'credit_only';
-    /** The customer to create the subscription for. */
-    customer: {
-        id?: string;
-        key?: string;
-    };
-    /** The plan reference of the subscription. */
-    plan: {
-        id?: string;
-        key?: string;
-        version?: number;
-    };
-    /**
-     * A billing anchor is the fixed point in time that determines the subscription's
-     * recurring billing cycle. It affects when charges occur and how prorations are
-     * calculated. Common anchors:
-     *
-     * - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
-     * - Subscription anniversary (day customer signed up)
-     * - Custom date (customer-specified day)
-     *
-     * If not provided, the subscription will be created with the subscription's
-     * creation time as the billing anchor.
-     */
-    billingAnchor?: Date;
-    /** Controls how custom-currency cost bases are selected for the subscription. */
-    costBasisMode: 'dynamic' | 'pinned';
-}
 /**
  * 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.
+ * entitlement evaluation. Stored with a resource's rating configuration so the
+ * same metered feature can be billed in different units across plans and charges.
  *
  * Examples:
  *
@@ -1876,6 +1836,46 @@ export interface UnitConfig {
      */
     displayUnit?: string;
 }
+/** Subscription create request. */
+export interface SubscriptionCreate {
+    labels?: Labels;
+    /**
+     * Settlement mode for billing.
+     *
+     * Values:
+     *
+     * - `credit_then_invoice`: Credits are applied first, then any remainder is
+     * invoiced.
+     * - `credit_only`: Usage is settled exclusively against credits.
+     */
+    settlementMode?: 'credit_then_invoice' | 'credit_only';
+    /** The customer to create the subscription for. */
+    customer: {
+        id?: string;
+        key?: string;
+    };
+    /** The plan reference of the subscription. */
+    plan: {
+        id?: string;
+        key?: string;
+        version?: number;
+    };
+    /**
+     * A billing anchor is the fixed point in time that determines the subscription's
+     * recurring billing cycle. It affects when charges occur and how prorations are
+     * calculated. Common anchors:
+     *
+     * - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
+     * - Subscription anniversary (day customer signed up)
+     * - Custom date (customer-specified day)
+     *
+     * If not provided, the subscription will be created with the subscription's
+     * creation time as the billing anchor.
+     */
+    billingAnchor?: Date;
+    /** Controls how custom-currency cost bases are selected for the subscription. */
+    costBasisMode: 'dynamic' | 'pinned';
+}
 /** Mapping of app types to tax codes. */
 export interface TaxCodeAppMapping {
     /** The app type that the tax code is associated with. */
@@ -2244,12 +2244,27 @@ export interface CreditTransaction {
         after: string;
     };
 }
+/**
+ * The totals of a charge.
+ *
+ * RealTime is only expanded when the `real_time_usage` expand is used.
+ */
+export interface ChargeTotals {
+    /** The amount of the charge already booked to the internal accounting system. */
+    booked: Totals;
+    /**
+     * The realtime amount of the charge.
+     *
+     * Requires the `realtime_usage` expand.
+     */
+    realtime?: Totals;
+}
 /**
  * A price tier used in graduated and volume pricing.
  *
  * At least one price component (flat_price or unit_price) must be set. When
- * UnitConfig is present on the rate card, up_to_amount is expressed in converted
- * billing units.
+ * UnitConfig is present on the containing resource, up_to_amount is expressed in
+ * converted billing units.
  */
 export interface PriceTier {
     /**
@@ -2262,27 +2277,12 @@ export interface PriceTier {
     /** The unit price component of the tier. Charged per billing unit within the tier. */
     unitPrice?: PriceUnit;
 }
-/**
- * The totals of a change.
- *
- * RealTime is only expanded when the `real_time_usage` expand is used.
- */
-export interface ChargeTotals {
-    /** The amount of the charge already booked to the internal accounting system. */
-    booked: Totals;
-    /**
-     * The realtime amount of the charge.
-     *
-     * Requires the `realtime_usage` expand.
-     */
-    realtime?: Totals;
-}
 /**
  * A price tier used in graduated and volume pricing.
  *
  * At least one price component (flat_price or unit_price) must be set. When
- * UnitConfig is present on the rate card, up_to_amount is expressed in converted
- * billing units.
+ * UnitConfig is present on the containing resource, up_to_amount is expressed in
+ * converted billing units.
  */
 export interface UpdatePriceTier {
     /**
@@ -3211,8 +3211,8 @@ export interface CreditTransactionPaginatedResponse {
  * Each tier's rate applies only to the usage within that tier. Pricing can change
  * as cumulative usage crosses tier boundaries.
  *
- * When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are
- * expressed in converted billing units.
+ * When UnitConfig is present on the containing resource, tier boundaries
+ * (up_to_amount) are expressed in converted billing units.
  */
 export interface PriceGraduated {
     /** The type of the price. */
@@ -3226,8 +3226,8 @@ export interface PriceGraduated {
  * The maximum quantity within a period determines the per-unit price for all units
  * in that period.
  *
- * When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are
- * expressed in converted billing units.
+ * When UnitConfig is present on the containing resource, tier boundaries
+ * (up_to_amount) are expressed in converted billing units.
  */
 export interface PriceVolume {
     /** The type of the price. */
@@ -3241,8 +3241,8 @@ export interface PriceVolume {
  * Each tier's rate applies only to the usage within that tier. Pricing can change
  * as cumulative usage crosses tier boundaries.
  *
- * When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are
- * expressed in converted billing units.
+ * When UnitConfig is present on the containing resource, tier boundaries
+ * (up_to_amount) are expressed in converted billing units.
  */
 export interface UpdatePriceGraduated {
     /** The type of the price. */
@@ -3256,8 +3256,8 @@ export interface UpdatePriceGraduated {
  * The maximum quantity within a period determines the per-unit price for all units
  * in that period.
  *
- * When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are
- * expressed in converted billing units.
+ * When UnitConfig is present on the containing resource, tier boundaries
+ * (up_to_amount) are expressed in converted billing units.
  */
 export interface UpdatePriceVolume {
     /** The type of the price. */
@@ -3656,6 +3656,86 @@ export interface AppStripeCreateCheckoutSessionRequestOptions {
     /** Configuration for collecting tax IDs during checkout. */
     taxIdCollection?: AppStripeCreateCheckoutSessionTaxIdCollection;
 }
+/** A flat fee charge for a customer. */
+export interface ChargeFlatFee {
+    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 type of the charge. */
+    type: 'flat_fee';
+    /** The customer owning the charge. */
+    customer: BillingCustomerReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by OpenMeter or manually
+     * overridden by the API user.
+     */
+    lifecycleController: 'system' | 'manual';
+    /**
+     * The subscription that originated the charge, when the charge was created from a
+     * subscription item.
+     */
+    subscription?: SubscriptionReference;
+    /** The currency of the charge. */
+    currency: string;
+    /** The lifecycle status of the charge. */
+    status: 'created' | 'active' | 'final' | 'deleted';
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoiceAt: Date;
+    /** The effective service period covered by the charge. */
+    servicePeriod: ClosedPeriod;
+    /** The full, unprorated service period of the charge. */
+    fullServicePeriod: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billingPeriod: ClosedPeriod;
+    /**
+     * The earliest time when the charge should be advanced again by background
+     * processing.
+     */
+    advanceAfter?: Date;
+    /** Unique reference ID of the charge. */
+    uniqueReferenceId?: string;
+    /** Settlement mode of the charge. */
+    settlementMode: 'credit_then_invoice' | 'credit_only';
+    /** Tax configuration of the charge. */
+    taxConfig?: TaxConfig;
+    /** Payment term of the flat fee charge. */
+    paymentTerm: PricePaymentTerm;
+    /** The discounts applied to the charge. */
+    discounts?: ChargeFlatFeeDiscounts;
+    /** The feature associated with the charge, when applicable. */
+    featureKey?: string;
+    /** The feature ID associated with the charge. */
+    featureId?: string;
+    /** The proration configuration of the charge. */
+    prorationConfiguration: RateCardProrationConfiguration;
+    /** The amount after proration of the charge. */
+    amountAfterProration: CurrencyAmount;
+    /** The price of the charge. */
+    price: PriceFlat;
+    /**
+     * Current intent from the system lifecycle controller for a charge that has an
+     * active manual override. The top-level charge fields remain the effective
+     * customer-facing intent.
+     */
+    systemIntent?: ChargeFlatFeeSystemIntent;
+}
 /** Page paginated response. */
 export interface TaxCodePagePaginatedResponse {
     data: TaxCode[];
@@ -4208,9 +4288,11 @@ export interface EntitlementAccessQueryResponse {
      */
     meta: CursorMeta;
 }
-/** A flat fee charge for a customer. */
-export interface ChargeFlatFee {
-    id: string;
+/**
+ * Usage-based intent fields from the system lifecycle controller shadowed by a
+ * manual override.
+ */
+export interface ChargeUsageBasedSystemIntent {
     /**
      * Display name of the resource.
      *
@@ -4224,30 +4306,6 @@ export interface ChargeFlatFee {
      */
     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 type of the charge. */
-    type: 'flat_fee';
-    /** The customer owning the charge. */
-    customer: BillingCustomerReference;
-    /**
-     * Indicates whether the charge lifecycle is controlled by OpenMeter or manually
-     * overridden by the API user.
-     */
-    lifecycleController: 'system' | 'manual';
-    /**
-     * The subscription that originated the charge, when the charge was created from a
-     * subscription item.
-     */
-    subscription?: SubscriptionReference;
-    /** The currency of the charge. */
-    currency: string;
-    /** The lifecycle status of the charge. */
-    status: 'created' | 'active' | 'final' | 'deleted';
     /** The timestamp when the charge is intended to be invoiced. */
     invoiceAt: Date;
     /** The effective service period covered by the charge. */
@@ -4256,68 +4314,23 @@ export interface ChargeFlatFee {
     fullServicePeriod: ClosedPeriod;
     /** The billing period the charge belongs to. */
     billingPeriod: ClosedPeriod;
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The price of the charge. */
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
     /**
-     * The earliest time when the charge should be advanced again by background
-     * processing.
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
      */
-    advanceAfter?: Date;
-    /** Unique reference ID of the charge. */
-    uniqueReferenceId?: string;
-    /** Settlement mode of the charge. */
-    settlementMode: 'credit_then_invoice' | 'credit_only';
-    /** Tax configuration of the charge. */
-    taxConfig?: TaxConfig;
-    /** Payment term of the flat fee charge. */
-    paymentTerm: PricePaymentTerm;
-    /** The discounts applied to the charge. */
-    discounts?: ChargeFlatFeeDiscounts;
-    /** The feature associated with the charge, when applicable. */
-    featureKey?: string;
-    /** The feature ID associated with the charge. */
-    featureId?: string;
-    /** The proration configuration of the charge. */
-    prorationConfiguration: RateCardProrationConfiguration;
-    /** The amount after proration of the charge. */
-    amountAfterProration: CurrencyAmount;
-    /** The price of the charge. */
-    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
-     * customer-facing intent.
-     */
-    systemIntent?: ChargeFlatFeeSystemIntent;
-}
-/**
- * Usage-based intent fields from the system lifecycle controller shadowed by a
- * manual override.
- */
-export interface ChargeUsageBasedSystemIntent {
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
-    /**
-     * Optional description of the resource.
-     *
-     * Maximum 1024 characters.
-     */
-    description?: string;
-    labels?: Labels;
-    /** The timestamp when the charge is intended to be invoiced. */
-    invoiceAt: Date;
-    /** The effective service period covered by the charge. */
-    servicePeriod: ClosedPeriod;
-    /** The full, unprorated service period of the charge. */
-    fullServicePeriod: ClosedPeriod;
-    /** The billing period the charge belongs to. */
-    billingPeriod: ClosedPeriod;
-    /** Discounts applied to the usage-based charge. */
-    discounts?: RateCardDiscounts;
-    /** The price of the charge. */
-    price: Price;
+    unitConfig?: UnitConfig;
     /**
      * The timestamp when the system lifecycle controller intent was deleted. The
      * effective charge can remain visible while a manual override is active.
@@ -4358,7 +4371,20 @@ export interface CreateChargeUsageBasedRequest {
     /** The feature ID associated with the charge. */
     featureId: string;
     /** The price of the charge. */
-    price: Price;
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
+    /**
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfig;
     /** The full, unprorated service period of the charge. */
     fullServicePeriod?: ClosedPeriod;
     /** The billing period the charge belongs to. */
@@ -4550,7 +4576,20 @@ export interface ChargeUsageBased {
     /** Aggregated booked and realtime totals for the charge. */
     totals: ChargeTotals;
     /** The price of the charge. */
-    price: Price;
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
+    /**
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfig;
     /**
      * Current intent from the system lifecycle controller for a charge that has an
      * active manual override. The top-level charge fields remain the effective
@@ -5473,6 +5512,13 @@ export type Currency = CurrencyFiat | CurrencyCustom;
  * arrears items).
  */
 export type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+/**
+ * Usage-based price types for a rate card or charge.
+ *
+ * When UnitConfig is present on the object, these price types operate on billing
+ * units (i.e. post-conversion quantities), not raw metered units.
+ */
+export type PriceUsageBased = PriceUnit | PriceGraduated | PriceVolume;
 /** Price. */
 export type Price = PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
 /** Price. */
@@ -5777,52 +5823,12 @@ export interface VoidCreditGrantRequestInput {
      */
     paymentAdjustment?: 'none';
 }
-/** Subscription create request. */
-export interface SubscriptionCreateInput {
-    labels?: Labels;
-    /**
-     * Settlement mode for billing.
-     *
-     * Values:
-     *
-     * - `credit_then_invoice`: Credits are applied first, then any remainder is
-     * invoiced.
-     * - `credit_only`: Usage is settled exclusively against credits.
-     */
-    settlementMode?: 'credit_then_invoice' | 'credit_only';
-    /** The customer to create the subscription for. */
-    customer: {
-        id?: string;
-        key?: string;
-    };
-    /** The plan reference of the subscription. */
-    plan: {
-        id?: string;
-        key?: string;
-        version?: number;
-    };
-    /**
-     * A billing anchor is the fixed point in time that determines the subscription's
-     * recurring billing cycle. It affects when charges occur and how prorations are
-     * calculated. Common anchors:
-     *
-     * - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
-     * - Subscription anniversary (day customer signed up)
-     * - Custom date (customer-specified day)
-     *
-     * If not provided, the subscription will be created with the subscription's
-     * creation time as the billing anchor.
-     */
-    billingAnchor?: Date;
-    /** Controls how custom-currency cost bases are selected for the subscription. */
-    costBasisMode?: 'dynamic' | 'pinned';
-}
 /**
  * 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.
+ * entitlement evaluation. Stored with a resource's rating configuration so the
+ * same metered feature can be billed in different units across plans and charges.
  *
  * Examples:
  *
@@ -5875,6 +5881,46 @@ export interface UnitConfigInput {
      */
     displayUnit?: string;
 }
+/** Subscription create request. */
+export interface SubscriptionCreateInput {
+    labels?: Labels;
+    /**
+     * Settlement mode for billing.
+     *
+     * Values:
+     *
+     * - `credit_then_invoice`: Credits are applied first, then any remainder is
+     * invoiced.
+     * - `credit_only`: Usage is settled exclusively against credits.
+     */
+    settlementMode?: 'credit_then_invoice' | 'credit_only';
+    /** The customer to create the subscription for. */
+    customer: {
+        id?: string;
+        key?: string;
+    };
+    /** The plan reference of the subscription. */
+    plan: {
+        id?: string;
+        key?: string;
+        version?: number;
+    };
+    /**
+     * A billing anchor is the fixed point in time that determines the subscription's
+     * recurring billing cycle. It affects when charges occur and how prorations are
+     * calculated. Common anchors:
+     *
+     * - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
+     * - Subscription anniversary (day customer signed up)
+     * - Custom date (customer-specified day)
+     *
+     * If not provided, the subscription will be created with the subscription's
+     * creation time as the billing anchor.
+     */
+    billingAnchor?: Date;
+    /** Controls how custom-currency cost bases are selected for the subscription. */
+    costBasisMode?: 'dynamic' | 'pinned';
+}
 /** Invoice settings for a billing workflow. */
 export interface WorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draftPeriod has passed. */
@@ -6376,6 +6422,108 @@ export interface WorkflowCollectionSettingsInput {
      */
     interval?: string;
 }
+/**
+ * Usage-based intent fields from the system lifecycle controller shadowed by a
+ * manual override.
+ */
+export interface ChargeUsageBasedSystemIntentInput {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoiceAt: Date;
+    /** The effective service period covered by the charge. */
+    servicePeriod: ClosedPeriod;
+    /** The full, unprorated service period of the charge. */
+    fullServicePeriod: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billingPeriod: ClosedPeriod;
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The price of the charge. */
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
+    /**
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfigInput;
+    /**
+     * The timestamp when the system lifecycle controller intent was deleted. The
+     * effective charge can remain visible while a manual override is active.
+     */
+    deletedAt?: Date;
+}
+/** Usage-based charge create request. */
+export interface CreateChargeUsageBasedRequestInput {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    /** The type of the charge. */
+    type: 'usage_based';
+    /** The currency of the charge. */
+    currency: string;
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoiceAt: Date;
+    /** The effective service period covered by the charge. */
+    servicePeriod: ClosedPeriod;
+    /** Unique reference ID of the charge. */
+    uniqueReferenceId?: string;
+    /** Settlement mode of the charge. */
+    settlementMode: 'credit_then_invoice' | 'credit_only';
+    /** Tax configuration of the charge. */
+    taxConfig?: TaxConfig;
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The feature ID associated with the charge. */
+    featureId: string;
+    /** The price of the charge. */
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
+    /**
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfigInput;
+    /** The full, unprorated service period of the charge. */
+    fullServicePeriod?: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billingPeriod?: ClosedPeriod;
+}
 /** A rate card defines the pricing and entitlement of a feature or service. */
 export interface RateCardInput {
     /**
@@ -6464,6 +6612,95 @@ export interface WorkflowInput {
     /** The tax settings for this workflow */
     tax?: WorkflowTaxSettingsInput;
 }
+/** A usage-based charge for a customer. */
+export interface ChargeUsageBasedInput {
+    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 type of the charge. */
+    type: 'usage_based';
+    /** The customer owning the charge. */
+    customer: BillingCustomerReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by OpenMeter or manually
+     * overridden by the API user.
+     */
+    lifecycleController: 'system' | 'manual';
+    /**
+     * The subscription that originated the charge, when the charge was created from a
+     * subscription item.
+     */
+    subscription?: SubscriptionReference;
+    /** The currency of the charge. */
+    currency: string;
+    /** The lifecycle status of the charge. */
+    status: 'created' | 'active' | 'final' | 'deleted';
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoiceAt: Date;
+    /** The effective service period covered by the charge. */
+    servicePeriod: ClosedPeriod;
+    /** The full, unprorated service period of the charge. */
+    fullServicePeriod: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billingPeriod: ClosedPeriod;
+    /**
+     * The earliest time when the charge should be advanced again by background
+     * processing.
+     */
+    advanceAfter?: Date;
+    /** Unique reference ID of the charge. */
+    uniqueReferenceId?: string;
+    /** Settlement mode of the charge. */
+    settlementMode: 'credit_then_invoice' | 'credit_only';
+    /** Tax configuration of the charge. */
+    taxConfig?: TaxConfig;
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The feature associated with the charge. */
+    featureKey: string;
+    /** The feature ID associated with the charge. */
+    featureId: string;
+    /** Aggregated booked and realtime totals for the charge. */
+    totals: ChargeTotals;
+    /** The price of the charge. */
+    price: PriceUsageBased;
+    /** Spend commitments for the charge. */
+    commitments?: SpendCommitments;
+    /**
+     * Unit conversion configuration for the charge.
+     *
+     * Synthesized on read for charges created from v1 dynamic or package prices:
+     * dynamic prices map to a unit price with a multiply unit config, and package
+     * prices map to a unit price with a divide unit config.
+     *
+     * Accepted on create only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfigInput;
+    /**
+     * Current intent from the system lifecycle controller for a charge that has an
+     * active manual override. The top-level charge fields remain the effective
+     * customer-facing intent.
+     */
+    systemIntent?: ChargeUsageBasedSystemIntentInput;
+}
 /** A subscription item pins a rate card to a cadence within a subscription phase. */
 export interface SubscriptionItemInput {
     /** The unique identifier of the subscription item instance. */
@@ -7013,6 +7250,11 @@ export interface ProfilePagePaginatedResponseInput {
     data: ProfileInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
+export interface ChargePagePaginatedResponseInput {
+    data: ChargeInput[];
+    meta: PaginatedMeta;
+}
 /** Subscription. */
 export interface SubscriptionInput {
     id: string;
@@ -7247,6 +7489,10 @@ export type UpdateBillingWorkflowPaymentSettingsInput = UpdateBillingWorkflowPay
  * rate card itself, so it is omitted here.
  */
 export type RateCardEntitlementInput = RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/** Customer charge. */
+export type CreateChargeRequestInput = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequestInput;
+/** Customer charge. */
+export type ChargeInput = ChargeFlatFee | ChargeUsageBasedInput;
 /**
  * A top-level line item on an invoice.
  *