@openmeter/client 1.0.0-beta-19a1f6bdbcd5 → 1.0.0-beta-d512c81f78a3

package/dist/models/types.d.ts

@@ -147,26 +147,6 @@ export interface AppStripeCreateCustomerPortalSessionOptions {
  * "mesh", "kic", or "\_".
  */
 export type CreateLabels = Record<string, string>;
-/** The tax config for Stripe. */
-export interface TaxConfigStripe {
-    /** Product [tax code](https://docs.stripe.com/tax/tax-codes). */
-    code: string;
-}
-/** External invoicing tax config. */
-export interface TaxConfigExternalInvoicing {
-    /** The tax code should be interpreted by the external invoicing provider. */
-    code: string;
-}
-/**
- * Discounts applicable to flat fee charges.
- *
- * This is the same as `ProductCatalog.Discounts` but without the `usage` field,
- * which is not applicable to flat fee charges.
- */
-export interface ChargeFlatFeeDiscounts {
-    /** Percentage discount applied to the price (0–100). */
-    percentage?: number;
-}
 /** Free price. */
 export interface PriceFree {
     /** The type of the price. */
@@ -188,6 +168,74 @@ export interface RateCardBooleanEntitlement {
     /** The type of the entitlement template. */
     type: 'boolean';
 }
+/** The tax config for Stripe. */
+export interface TaxConfigStripe {
+    /** Product [tax code](https://docs.stripe.com/tax/tax-codes). */
+    code: string;
+}
+/** External invoicing tax config. */
+export interface TaxConfigExternalInvoicing {
+    /** The tax code should be interpreted by the external invoicing provider. */
+    code: string;
+}
+/** External identifiers assigned to an invoice by third-party systems. */
+export interface InvoiceExternalReferences {
+    /** The ID assigned by the external invoicing app (e.g. Stripe invoice ID). */
+    invoicingId?: string;
+    /** The ID assigned by the external payment app (e.g. Stripe payment intent ID). */
+    paymentId?: string;
+}
+/** Details about an available invoice action including the resulting state. */
+export interface InvoiceAvailableActionDetails {
+    /** The extended status the invoice will transition to after performing this action. */
+    resultingState: 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 InvoiceWorkflowInvoicingSettings {
+    /** 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;
+    /** The period after which the invoice is considered overdue if not paid. */
+    dueAfter?: string;
+}
+/**
+ * Payment settings for a billing workflow when the collection method is charge
+ * automatically.
+ */
+export interface WorkflowPaymentChargeAutomaticallySettings {
+    /** The collection method for the invoice. */
+    collectionMethod: 'charge_automatically';
+}
+/**
+ * Payment settings for a billing workflow when the collection method is send
+ * invoice.
+ */
+export interface WorkflowPaymentSendInvoiceSettings {
+    /** The collection method for the invoice. */
+    collectionMethod: 'send_invoice';
+    /**
+     * The period after which the invoice is due. With some payment solutions it's only
+     * applicable for manual collection method.
+     */
+    dueAfter: string;
+}
+/**
+ * Discounts applicable to flat fee charges.
+ *
+ * This is the same as `ProductCatalog.Discounts` but without the `usage` field,
+ * which is not applicable to flat fee charges.
+ */
+export interface ChargeFlatFeeDiscounts {
+    /** Percentage discount applied to the price (0–100). */
+    percentage?: number;
+}
 /**
  * Labels store metadata of an entity that can be used for filtering an entity list
  * or for searching across entity types.
@@ -242,54 +290,6 @@ export interface WorkflowCollectionAlignmentSubscription {
     /** The type of alignment. */
     type: 'subscription';
 }
-/**
- * Payment settings for a billing workflow when the collection method is charge
- * automatically.
- */
-export interface WorkflowPaymentChargeAutomaticallySettings {
-    /** The collection method for the invoice. */
-    collectionMethod: 'charge_automatically';
-}
-/**
- * Payment settings for a billing workflow when the collection method is send
- * invoice.
- */
-export interface WorkflowPaymentSendInvoiceSettings {
-    /** The collection method for the invoice. */
-    collectionMethod: 'send_invoice';
-    /**
-     * The period after which the invoice is due. With some payment solutions it's only
-     * applicable for manual collection method.
-     */
-    dueAfter: string;
-}
-/** External identifiers assigned to an invoice by third-party systems. */
-export interface InvoiceExternalReferences {
-    /** The ID assigned by the external invoicing app (e.g. Stripe invoice ID). */
-    invoicingId?: string;
-    /** The ID assigned by the external payment app (e.g. Stripe payment intent ID). */
-    paymentId?: string;
-}
-/** Details about an available invoice action including the resulting state. */
-export interface InvoiceAvailableActionDetails {
-    /** The extended status the invoice will transition to after performing this action. */
-    resultingState: 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 InvoiceWorkflowInvoicingSettings {
-    /** 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;
-    /** The period after which the invoice is considered overdue if not paid. */
-    dueAfter?: string;
-}
 /** External identifiers for an invoice line item assigned by third-party systems. */
 export interface InvoiceLineExternalReferences {
     /** The ID assigned by the external invoicing app. */
@@ -575,11 +575,6 @@ export interface CreateCurrencyCustomRequest {
     thousandSeparator: string;
     code: string;
 }
-/** Monetary amount in a specific currency. */
-export interface CurrencyAmount {
-    amount: string;
-    currency: string;
-}
 /** Flat price. */
 export interface PriceFlat {
     /** The type of the price. */
@@ -587,6 +582,28 @@ 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 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. */
+    minimumAmount?: string;
+    /** The customer is limited to spend at most the amount. */
+    maximumAmount?: string;
+}
 /** Discount configuration for a rate card. */
 export interface RateCardDiscounts {
     /** Percentage discount applied to the price (0–100). */
@@ -617,27 +634,56 @@ export interface Totals {
     /** The final total value of the resource after taxes, discounts and commitments. */
     total: string;
 }
-/**
- * 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. */
+/** A credit allocation applied to a charge realization detailed line. */
+export interface ChargeRealizationDetailedLineCreditApplied {
+    /** The monetary amount credited. */
     amount: string;
+    /** Human-readable description of the credit allocation. */
+    description?: string;
+    /** The ID of the credit realization (allocation) this credit was applied from. */
+    creditRealizationId: 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. */
-    minimumAmount?: string;
-    /** The customer is limited to spend at most the amount. */
-    maximumAmount?: string;
+/** A discount applied to a charge realization detailed line. */
+export interface ChargeRealizationAmountDiscount {
+    /** The amount of the discount applied to the charge. */
+    amount: string;
+    /** The reason for the discount applied to the charge. */
+    reason: string;
+    /** Optional human-readable description of the discount. */
+    description?: string;
+    /**
+     * The discount amount applied to the charge, rounded to the nearest cent (or
+     * currency equivalent) and adjusted to compensate for rounding errors across
+     * multiple discounted detail lines.
+     */
+    roundingAmount?: string;
+    /** Unique reference ID of the discount applied to the charge. */
+    childUniqueReferenceId: string;
+}
+/** A fixed per-unit cost amount. */
+export interface FeatureManualUnitCost {
+    /** The type discriminator for manual unit cost. */
+    type: 'manual';
+    /** Fixed per-unit cost amount in USD. */
+    amount: string;
+}
+/** Resolved per-token pricing from the LLM cost database. */
+export interface FeatureLlmUnitCostPricing {
+    /** Cost per input token in USD. */
+    inputPerToken: string;
+    /** Cost per output token in USD. */
+    outputPerToken: string;
+    /** Cost per cache read token in USD. */
+    cacheReadPerToken?: string;
+    /** Cost per reasoning token in USD. */
+    reasoningPerToken?: string;
+    /** Cost per cache write token in USD. */
+    cacheWritePerToken?: string;
+}
+/** Monetary amount in a specific currency. */
+export interface CurrencyAmount {
+    amount: string;
+    currency: string;
 }
 /** A credit allocation applied to an invoice line item. */
 export interface InvoiceLineCreditsApplied {
@@ -692,26 +738,6 @@ export interface UpdateDiscounts {
      */
     usage?: string;
 }
-/** A fixed per-unit cost amount. */
-export interface FeatureManualUnitCost {
-    /** The type discriminator for manual unit cost. */
-    type: 'manual';
-    /** Fixed per-unit cost amount in USD. */
-    amount: string;
-}
-/** Resolved per-token pricing from the LLM cost database. */
-export interface FeatureLlmUnitCostPricing {
-    /** Cost per input token in USD. */
-    inputPerToken: string;
-    /** Cost per output token in USD. */
-    outputPerToken: string;
-    /** Cost per cache read token in USD. */
-    cacheReadPerToken?: string;
-    /** Cost per reasoning token in USD. */
-    reasoningPerToken?: string;
-    /** Cost per cache write token in USD. */
-    cacheWritePerToken?: string;
-}
 /** Token pricing for an LLM model, denominated per token. */
 export interface LlmCostModelPricing {
     /** Input price per token (USD). */
@@ -802,9 +828,17 @@ export interface CreditGrantInvoiceReference {
         id: string;
     };
 }
-/** Customer reference. */
-export interface BillingCustomerReference {
-    /** The ID of the customer. */
+/** A cost basis pinned to a custom-currency pair for the subscription. */
+export interface SubscriptionCostBasisPin {
+    /** The managed custom currency ID. */
+    customCurrencyId: string;
+    /** The fiat currency in which the subscription is invoiced. */
+    invoiceCurrency: string;
+    /** The pinned cost basis resource ID. */
+    costBasisId: string;
+}
+/** Feature reference. */
+export interface FeatureReference {
     id: string;
 }
 /**
@@ -814,6 +848,13 @@ export interface BillingCustomerReference {
 export interface SubscriptionReference {
     /** The ID of the subscription. */
     id: string;
+    /**
+     * The display name of the subscription.
+     *
+     * Only populated where the referencing endpoint documents a `subscription` expand
+     * that resolves it.
+     */
+    name?: string;
     /** The phase of the subscription. */
     phase: {
         id: string;
@@ -822,28 +863,19 @@ export interface SubscriptionReference {
         };
     };
 }
-/** A cost basis pinned to a custom-currency pair for the subscription. */
-export interface SubscriptionCostBasisPin {
-    /** The managed custom currency ID. */
-    customCurrencyId: string;
-    /** The fiat currency in which the subscription is invoiced. */
-    invoiceCurrency: string;
-    /** The pinned cost basis resource ID. */
-    costBasisId: string;
+/** App reference. */
+export interface AppReference {
+    /** The ID of the app. */
+    id: string;
 }
-/** Feature reference. */
-export interface FeatureReference {
+/** ChargeRealizationInvoice reference. */
+export interface ChargeRealizationInvoiceReference {
     id: string;
 }
 /** Addon reference. */
 export interface AddonReference {
     id: string;
 }
-/** App reference. */
-export interface AppReference {
-    /** The ID of the app. */
-    id: string;
-}
 /** Reference to a charge associated with an invoice line. */
 export interface ChargeReference {
     /** Unique identifier for the charge. */
@@ -853,6 +885,41 @@ export interface ChargeReference {
 export interface UpdateResourceReference {
     id: string;
 }
+/** Customer reference. */
+export interface BillingCustomerReference {
+    /** The ID of the customer. */
+    id: string;
+    /**
+     * The display name of the customer.
+     *
+     * Only populated where the referencing endpoint documents a `customer` expand that
+     * resolves it.
+     */
+    name?: string;
+}
+/**
+ * The feature associated with a charge.
+ *
+ * `key` is always present and is set at charge creation time. `id` and `name` are
+ * only resolved with the `feature` expand, since resolving them requires an
+ * additional lookup against the feature catalog.
+ */
+export interface ChargeFeature {
+    /** The ID of the feature. */
+    id: string;
+    /**
+     * The key of the feature.
+     *
+     * Requires the `feature` expand.
+     */
+    key?: string;
+    /**
+     * The display name of the feature.
+     *
+     * Requires the `feature` expand.
+     */
+    name?: string;
+}
 /** Metering event following the CloudEvents specification. */
 export interface Event {
     /** Identifies the event. */
@@ -1732,22 +1799,6 @@ export interface GetCreditBalanceParamsFilter {
      */
     featureKey?: StringFieldFilter;
 }
-/** Filter options for listing charges. */
-export interface ListChargesParamsFilter {
-    /**
-     * Filter charges by status.
-     *
-     * Supported statuses are:
-     *
-     * - `created`
-     * - `active`
-     * - `final`
-     * - `deleted`
-     *
-     * If omitted, all statuses are returned except for `deleted`.
-     */
-    status?: StringFieldFilterExact;
-}
 /** Filter options for listing plans. */
 export interface ListPlansParamsFilter {
     key?: StringFieldFilter;
@@ -1766,11 +1817,6 @@ export interface VoidCreditGrantRequest {
      */
     paymentAdjustment: 'none';
 }
-/** The proration configuration of the rate card. */
-export interface RateCardProrationConfiguration {
-    /** The proration mode of the rate card. */
-    mode: 'no_proration' | 'prorate_prices';
-}
 /** The pro-rating configuration of a subscription. */
 export interface SubscriptionProRatingConfig {
     /** Whether pro-rating is enabled. */
@@ -1778,6 +1824,51 @@ export interface SubscriptionProRatingConfig {
     /** How pro-rating is calculated when enabled. */
     mode: 'no_proration' | 'prorate_prices';
 }
+/** The proration configuration of the rate card. */
+export interface RateCardProrationConfiguration {
+    /** The proration mode of the rate card. */
+    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.
  *
@@ -1836,45 +1927,67 @@ 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;
-    };
+/**
+ * Identity stores the details required to identify an entity for tax purposes in a
+ * specific country.
+ */
+export interface PartyTaxIdentity {
+    /** Normalized tax identification code shown on the original identity document. */
+    code?: string;
+}
+/**
+ * Identity stores the details required to identify an entity for tax purposes in a
+ * specific country.
+ */
+export interface UpdateBillingPartyTaxIdentity {
+    /** Normalized tax identification code shown on the original identity document. */
+    code?: string;
+}
+/**
+ * A validation issue found during invoice processing.
+ *
+ * Converges on the same structure used by plan and subscription validation errors:
+ * a machine-readable `code`, a human-readable `message`, optional structured
+ * `attributes`, plus a `severity` and optional `field` path.
+ */
+export interface InvoiceValidationIssue {
+    /** Machine-readable error code. */
+    code: string;
+    /** Human-readable description of the error. */
+    message: string;
+    /** Additional structured context. */
+    attributes?: Record<string, unknown>;
+    /** Severity of the validation issue. */
+    severity: 'critical' | 'warning';
     /**
-     * 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)
+     * JSON path to the field that caused this validation issue, if applicable.
      *
-     * If not provided, the subscription will be created with the subscription's
-     * creation time as the billing anchor.
+     * For example: `lines/0/rate_card/price`.
      */
-    billingAnchor?: Date;
-    /** Controls how custom-currency cost bases are selected for the subscription. */
-    costBasisMode: 'dynamic' | 'pinned';
+    field?: string;
+}
+/**
+ * The set of state-transition actions available for an invoice in its current
+ * status.
+ *
+ * A field is present only when that action is permitted from the current state.
+ */
+export interface InvoiceAvailableActions {
+    /** Advance the invoice to the next workflow step. */
+    advance?: InvoiceAvailableActionDetails;
+    /** Approve the invoice for issuance. */
+    approve?: InvoiceAvailableActionDetails;
+    /** Delete the invoice. */
+    delete?: InvoiceAvailableActionDetails;
+    /** Retry a failed workflow step. */
+    retry?: InvoiceAvailableActionDetails;
+    /** Snapshot the current usage quantities. */
+    snapshotQuantities?: InvoiceAvailableActionDetails;
+}
+/** Payment state of a charge realization. */
+export interface ChargeRealizationPayment {
+    /** The settlement status of the payment. */
+    status: 'authorized' | 'settled';
 }
 /** Mapping of app types to tax codes. */
 export interface TaxCodeAppMapping {
@@ -1974,22 +2087,6 @@ export interface UpdateAppExternalInvoicingRequest {
      */
     enableIssuingSyncHook: boolean;
 }
-/**
- * Identity stores the details required to identify an entity for tax purposes in a
- * specific country.
- */
-export interface PartyTaxIdentity {
-    /** Normalized tax identification code shown on the original identity document. */
-    code?: string;
-}
-/**
- * Identity stores the details required to identify an entity for tax purposes in a
- * specific country.
- */
-export interface UpdateBillingPartyTaxIdentity {
-    /** Normalized tax identification code shown on the original identity document. */
-    code?: string;
-}
 /** Invoice settings for a billing workflow. */
 export interface WorkflowInvoicingSettings {
     /** Whether to automatically issue the invoice after the draftPeriod has passed. */
@@ -2001,47 +2098,6 @@ export interface WorkflowInvoicingSettings {
     /** Controls how subscription-ending shortened service periods are billed. */
     subscriptionEndProrationMode: 'bill_full_period' | 'bill_actual_period';
 }
-/**
- * A validation issue found during invoice processing.
- *
- * Converges on the same structure used by plan and subscription validation errors:
- * a machine-readable `code`, a human-readable `message`, optional structured
- * `attributes`, plus a `severity` and optional `field` path.
- */
-export interface InvoiceValidationIssue {
-    /** Machine-readable error code. */
-    code: string;
-    /** Human-readable description of the error. */
-    message: string;
-    /** Additional structured context. */
-    attributes?: Record<string, unknown>;
-    /** Severity of the validation issue. */
-    severity: 'critical' | 'warning';
-    /**
-     * JSON path to the field that caused this validation issue, if applicable.
-     *
-     * For example: `lines/0/rate_card/price`.
-     */
-    field?: string;
-}
-/**
- * The set of state-transition actions available for an invoice in its current
- * status.
- *
- * A field is present only when that action is permitted from the current state.
- */
-export interface InvoiceAvailableActions {
-    /** Advance the invoice to the next workflow step. */
-    advance?: InvoiceAvailableActionDetails;
-    /** Approve the invoice for issuance. */
-    approve?: InvoiceAvailableActionDetails;
-    /** Delete the invoice. */
-    delete?: InvoiceAvailableActionDetails;
-    /** Retry a failed workflow step. */
-    retry?: InvoiceAvailableActionDetails;
-    /** Snapshot the current usage quantities. */
-    snapshotQuantities?: InvoiceAvailableActionDetails;
-}
 /** A monetary amount discount applied to an invoice line item. */
 export interface InvoiceLineAmountDiscount {
     /** Unique identifier for the discount. */
@@ -2245,26 +2301,11 @@ export interface CreditTransaction {
     };
 }
 /**
- * The totals of a charge.
+ * A price tier used in graduated and volume pricing.
  *
- * 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 containing resource, up_to_amount is expressed in
- * converted billing units.
+ * At least one price component (flat_price or unit_price) must be set. When
+ * UnitConfig is present on the containing resource, up_to_amount is expressed in
+ * converted billing units.
  */
 export interface PriceTier {
     /**
@@ -2278,22 +2319,22 @@ export interface PriceTier {
     unitPrice?: PriceUnit;
 }
 /**
- * A price tier used in graduated and volume pricing.
+ * The totals of a charge.
  *
- * At least one price component (flat_price or unit_price) must be set. When
- * UnitConfig is present on the containing resource, up_to_amount is expressed in
- * converted billing units.
+ * `realtime` is only populated when the `real_time_usage` expand is used.
  */
-export interface UpdatePriceTier {
+export interface ChargeTotals {
+    /** The amount of the charge already booked to the internal accounting system. */
+    booked: Totals;
     /**
-     * Up to and including this quantity will be contained in the tier. If undefined,
-     * the tier is open-ended (the last tier).
+     * The realtime amount of the charge, i.e. the whole usage rated at the charge's
+     * price for its full service period, ignoring what has already been booked to a
+     * realization. This differs from the `usage` of a realization with type
+     * `outstanding`, which only covers the quantity not yet booked.
+     *
+     * Requires the `real_time_usage` expand.
      */
-    upToAmount?: string;
-    /** The flat price component of the tier. Charged once when the tier is entered. */
-    flatPrice?: UpdatePriceFlat;
-    /** The unit price component of the tier. Charged per billing unit within the tier. */
-    unitPrice?: UpdatePriceUnit;
+    realtime?: Totals;
 }
 /**
  * LLM cost lookup configuration. Each dimension (provider, model, token type) can
@@ -2341,6 +2382,24 @@ export interface FeatureLlmUnitCost {
      */
     pricing?: FeatureLlmUnitCostPricing;
 }
+/**
+ * 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 containing resource, up_to_amount is expressed in
+ * converted billing units.
+ */
+export interface UpdatePriceTier {
+    /**
+     * Up to and including this quantity will be contained in the tier. If undefined,
+     * the tier is open-ended (the last tier).
+     */
+    upToAmount?: string;
+    /** The flat price component of the tier. Charged once when the tier is entered. */
+    flatPrice?: UpdatePriceFlat;
+    /** The unit price component of the tier. Charged per billing unit within the tier. */
+    unitPrice?: UpdatePriceUnit;
+}
 /**
  * An LLM cost price record, representing the cost per token for a specific model
  * from a specific provider.
@@ -2452,6 +2511,11 @@ export interface CreditGrantTaxConfig {
     /** Tax code applied to the invoice line item. */
     taxCode?: TaxCodeReference;
 }
+/** The tax config of the rate card. */
+export interface RateCardTaxConfig {
+    behavior?: 'inclusive' | 'exclusive';
+    code: TaxCodeReference;
+}
 /** Set of provider specific tax configs. */
 export interface TaxConfig {
     /**
@@ -2476,11 +2540,6 @@ export interface TaxConfig {
      */
     taxCode?: TaxCodeReference;
 }
-/** The tax config of the rate card. */
-export interface RateCardTaxConfig {
-    behavior?: 'inclusive' | 'exclusive';
-    code: TaxCodeReference;
-}
 /**
  * Organization-level default tax code references.
  *
@@ -2504,6 +2563,27 @@ export interface UpdateOrganizationDefaultTaxCodesRequest {
     /** Default tax code for credit grants. */
     creditGrantTaxCode?: TaxCodeReference;
 }
+/**
+ * BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps
+ * used by a billing profile
+ */
+export interface InvoiceWorkflowAppsReferences {
+    /** The tax app used for this workflow */
+    tax: AppReference;
+    /** The invoicing app used for this workflow */
+    invoicing: AppReference;
+    /** The payment app used for this workflow */
+    payment: AppReference;
+}
+/** References to the applications used by a billing profile. */
+export interface ProfileAppReferences {
+    /** The tax app used for this workflow. */
+    tax: AppReference;
+    /** The invoicing app used for this workflow. */
+    invoicing: AppReference;
+    /** The payment app used for this workflow. */
+    payment: AppReference;
+}
 /**
  * PlanAddon represents an association between a plan and an add-on, controlling
  * which add-ons are available for purchase within a plan.
@@ -2568,27 +2648,6 @@ export interface CreatePlanAddonRequest {
      */
     maxQuantity?: number;
 }
-/** References to the applications used by a billing profile. */
-export interface ProfileAppReferences {
-    /** The tax app used for this workflow. */
-    tax: AppReference;
-    /** The invoicing app used for this workflow. */
-    invoicing: AppReference;
-    /** The payment app used for this workflow. */
-    payment: AppReference;
-}
-/**
- * BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps
- * used by a billing profile
- */
-export interface InvoiceWorkflowAppsReferences {
-    /** The tax app used for this workflow */
-    tax: AppReference;
-    /** The invoicing app used for this workflow */
-    invoicing: AppReference;
-    /** The payment app used for this workflow */
-    payment: AppReference;
-}
 /** The tax config of the rate card. */
 export interface UpdateRateCardTaxConfig {
     behavior?: 'inclusive' | 'exclusive';
@@ -2613,6 +2672,44 @@ export interface ListEventsParamsFilter {
     /** Filter events by the time the event was stored. */
     storedAt?: DateTimeFieldFilter;
 }
+/** Filter options for listing charges. */
+export interface ListChargesParamsFilter {
+    /**
+     * Filter charges by status.
+     *
+     * Supported statuses are:
+     *
+     * - `created`
+     * - `active`
+     * - `final`
+     * - `deleted`
+     *
+     * If omitted, all statuses are returned except for `deleted`.
+     */
+    status?: StringFieldFilterExact;
+    /** Filter charges by the ID of their associated feature. */
+    featureId?: UlidFieldFilter;
+    /** Filter charges by the key of their associated feature. */
+    featureKey?: StringFieldFilterExact;
+    /**
+     * Filter charges by the start of their service period.
+     *
+     * Combine with `service_period_to` to match charges whose service period falls
+     * within a given window: `filter[service_period_from][gte]=<from>` together with
+     * `filter[service_period_to][lt]=<to>` returns charges whose service period lies
+     * within `[from, to)`.
+     */
+    servicePeriodFrom?: DateTimeFieldFilter;
+    /**
+     * Filter charges by the end of their service period.
+     *
+     * Combine with `service_period_from` to match charges whose service period falls
+     * within a given window: `filter[service_period_from][gte]=<from>` together with
+     * `filter[service_period_to][lt]=<to>` returns charges whose service period lies
+     * within `[from, to)`.
+     */
+    servicePeriodTo?: DateTimeFieldFilter;
+}
 /** Filter options for listing invoices. */
 export interface ListInvoicesParamsFilter {
     /** Filter by invoice status. */
@@ -2677,6 +2774,61 @@ export interface MeterQueryResult {
     /** The usage data. If no data is available, an empty array is returned. */
     data: MeterQueryRow[];
 }
+/** A detailed line produced by a flat fee charge's realization run. */
+export interface ChargeRealizationDetailedLineFlatFee {
+    id: string;
+    /** 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 the realization belongs to. */
+    type: 'flat_fee';
+    /** The service period covered by this detailed line. */
+    servicePeriod: ClosedPeriod;
+    /** Aggregated financial totals for the detailed line. */
+    totals: Totals;
+    /** The cost category of this detailed line. */
+    category: 'regular' | 'commitment';
+    /** Credits applied to this detailed line. */
+    creditsApplied?: ChargeRealizationDetailedLineCreditApplied[];
+    /** The unit price of the detailed line. */
+    unitPrice: string;
+    /** The amount discounts applied to the detailed line. */
+    amountDiscounts: ChargeRealizationAmountDiscount[];
+}
+/** A detailed line produced by a usage-based charge's realization run. */
+export interface ChargeRealizationDetailedLineUsageBased {
+    id: string;
+    /** 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 the realization belongs to. */
+    type: 'usage_based';
+    /** The service period covered by this detailed line. */
+    servicePeriod: ClosedPeriod;
+    /** Aggregated financial totals for the detailed line. */
+    totals: Totals;
+    /** The cost category of this detailed line. */
+    category: 'regular' | 'commitment';
+    /** Credits applied to this detailed line. */
+    creditsApplied?: ChargeRealizationDetailedLineCreditApplied[];
+    /** The unit price of the detailed line. */
+    unitPrice: string;
+    /** The amount discounts applied to the detailed line. */
+    amountDiscounts: ChargeRealizationAmountDiscount[];
+    /** The quantity of the detailed line. */
+    quantity: string;
+    /**
+     * The ID of a prior realization run this detailed line corrects. Only set if the
+     * detailed line's totals are negative.
+     */
+    correctsRunId?: string;
+}
 /** Describes custom currency. */
 export interface CurrencyCustom {
     /** The type of the currency. */
@@ -2962,6 +3114,33 @@ export interface ChargeFlatFeeSystemIntent {
      */
     deletedAt?: Date;
 }
+/** Detailed status information for a standard invoice. */
+export interface InvoiceStatusDetails {
+    /** Whether the invoice is immutable (i.e. cannot be modified or deleted). */
+    immutable: boolean;
+    /** Whether the invoice is in a failed state. */
+    failed: boolean;
+    /**
+     * Fine-grained internal status string providing additional workflow detail beyond
+     * the top-level status enum.
+     */
+    extendedStatus: string;
+    /** The set of state-transition actions currently available for this invoice. */
+    availableActions: InvoiceAvailableActions;
+}
+/**
+ * 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 InvoiceWorkflow {
+    /** Invoicing settings for this invoice. */
+    invoicing?: InvoiceWorkflowInvoicingSettings;
+    /** Payment settings for this invoice. */
+    payment?: WorkflowPaymentSettings;
+}
 /** Request for canceling a subscription. */
 export interface SubscriptionCancel {
     /** If not provided the subscription is canceled immediately. */
@@ -3107,33 +3286,6 @@ export interface AppCatalogItem {
     /** Available install methods of the app. */
     installMethods: ('with_oauth2' | 'with_api_key' | 'no_credentials_required')[];
 }
-/**
- * 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 InvoiceWorkflow {
-    /** Invoicing settings for this invoice. */
-    invoicing?: InvoiceWorkflowInvoicingSettings;
-    /** Payment settings for this invoice. */
-    payment?: WorkflowPaymentSettings;
-}
-/** Detailed status information for a standard invoice. */
-export interface InvoiceStatusDetails {
-    /** Whether the invoice is immutable (i.e. cannot be modified or deleted). */
-    immutable: boolean;
-    /** Whether the invoice is in a failed state. */
-    failed: boolean;
-    /**
-     * Fine-grained internal status string providing additional workflow detail beyond
-     * the top-level status enum.
-     */
-    extendedStatus: string;
-    /** The set of state-transition actions currently available for this invoice. */
-    availableActions: InvoiceAvailableActions;
-}
 /** Discounts applied to an invoice line item. */
 export interface InvoiceLineDiscounts {
     /** Monetary amount discounts (e.g. from maximum spend commitments). */
@@ -3433,12 +3585,12 @@ export interface CreateChargeFlatFeeRequest {
     paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
-    /** The feature ID associated with the charge. */
-    featureId?: string;
     /** The proration configuration of the charge. */
     prorationConfiguration: RateCardProrationConfiguration;
     /** The amount before proration of the charge. */
     amountBeforeProration: CurrencyAmount;
+    /** A reference to the feature associated with the charge, when applicable. */
+    feature?: FeatureReference;
     /** The full, unprorated service period of the charge. */
     fullServicePeriod?: ClosedPeriod;
     /** The billing period the charge belongs to. */
@@ -3507,22 +3659,6 @@ export interface CustomerPagePaginatedResponse {
     data: Customer[];
     meta: PaginatedMeta;
 }
-/** Party represents a person or business entity. */
-export interface Party {
-    /** Unique identifier for the party. */
-    id?: string;
-    /** An optional unique key of the party. */
-    key?: string;
-    /** Legal name or representation of the party. */
-    name?: string;
-    /**
-     * The entity's legal identification used for tax purposes. They may have other
-     * numbers, but we're only interested in those valid for tax purposes.
-     */
-    taxId?: PartyTaxIdentity;
-    /** Address for where information should be sent if needed. */
-    addresses?: PartyAddresses;
-}
 /**
  * Snapshot of the supplier's information at the time the invoice was issued.
  *
@@ -3543,6 +3679,22 @@ export interface Supplier {
     /** Unique identifier for the party. */
     id?: string;
 }
+/** Party represents a person or business entity. */
+export interface Party {
+    /** Unique identifier for the party. */
+    id?: string;
+    /** An optional unique key of the party. */
+    key?: string;
+    /** Legal name or representation of the party. */
+    name?: string;
+    /**
+     * The entity's legal identification used for tax purposes. They may have other
+     * numbers, but we're only interested in those valid for tax purposes.
+     */
+    taxId?: PartyTaxIdentity;
+    /** Address for where information should be sent if needed. */
+    addresses?: PartyAddresses;
+}
 /**
  * Snapshot of the supplier's information at the time the invoice was issued.
  *
@@ -3656,85 +3808,21 @@ 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;
+/** 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. */
+    apps?: InvoiceWorkflowAppsReferences;
+    /** The billing profile that was the source of this workflow snapshot. */
+    sourceBillingProfile: ProfileReference;
     /**
-     * Optional description of the resource.
+     * The workflow configuration that was active when the invoice was created.
      *
-     * 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.
+     * Only the fields that are meaningful at the per-invoice level are included:
+     * invoicing behaviour (auto-advance, draft period) and payment settings
+     * (collection method, due date). Profile-wide settings such as collection
+     * alignment, progressive billing, and tax policy are omitted.
      */
-    systemIntent?: ChargeFlatFeeSystemIntent;
+    workflow: InvoiceWorkflow;
 }
 /** Page paginated response. */
 export interface TaxCodePagePaginatedResponse {
@@ -4004,22 +4092,6 @@ export interface InstalledAppExternalInvoicing {
     /** Default capabilities of the installed app. */
     defaultForCapabilityTypes: ('report_usage' | 'report_events' | 'calculate_tax' | 'invoice_customers' | 'collect_payments')[];
 }
-/** 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. */
-    apps?: InvoiceWorkflowAppsReferences;
-    /** The billing profile that was the source of this workflow snapshot. */
-    sourceBillingProfile: ProfileReference;
-    /**
-     * The workflow configuration that was active when the invoice was created.
-     *
-     * Only the fields that are meaningful at the per-invoice level are included:
-     * invoicing behaviour (auto-advance, draft period) and payment settings
-     * (collection method, due date). Profile-wide settings such as collection
-     * alignment, progressive billing, and tax policy are omitted.
-     */
-    workflow: InvoiceWorkflow;
-}
 /**
  * A detailed (child) sub-line belonging to a parent invoice line.
  *
@@ -4276,6 +4348,83 @@ export interface WorkflowCollectionSettings {
      */
     interval: string;
 }
+/**
+ * The invoice a charge realization was booked to, embedded as a header.
+ *
+ * Matches the standard invoice entity, except that it carries no `customer`
+ * snapshot (the charge context already identifies the customer) and `lines` are
+ * never populated (the realization itself is the line-level breakdown). The shared
+ * invoice contract stays untouched: this model exists so the charges API can slim
+ * the embedding without loosening the invoices API.
+ */
+export interface ChargeRealizationInvoice {
+    id: 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;
+    /** Human-readable invoice number generated by the invoicing app. */
+    number: string;
+    /** Three-letter ISO 4217 currency code for the invoice. */
+    currency: string;
+    /**
+     * Snapshot of the supplier's contact information at the time the invoice was
+     * issued.
+     */
+    supplier: Supplier;
+    /** Aggregated financial totals for the invoice. */
+    totals: Totals;
+    /**
+     * The service period covered by this invoice.
+     *
+     * For flat fee the service period can be empty which means `from` will be equals
+     * to `to`. In other cases those fields will be filled with the actual service
+     * period.
+     */
+    servicePeriod: ClosedPeriod;
+    /**
+     * Validation issues found during invoice processing.
+     *
+     * Present only when there are one or more validation findings. An empty list is
+     * omitted.
+     */
+    validationIssues?: InvoiceValidationIssue[];
+    /** External identifiers assigned to this invoice by third-party systems. */
+    externalReferences?: InvoiceExternalReferences;
+    /** Discriminator field identifying this as a standard invoice. */
+    type: 'standard';
+    /** Current lifecycle status of the invoice. */
+    status: 'draft' | 'issuing' | 'issued' | 'payment_processing' | 'overdue' | 'paid' | 'uncollectible' | 'voided';
+    /** Detailed status information including available actions and workflow state. */
+    statusDetails: InvoiceStatusDetails;
+    /** Timestamp when the invoice was issued to the customer. */
+    issuedAt?: Date;
+    /**
+     * Timestamp until which the invoice remains in draft state.
+     *
+     * The invoice advances automatically once this time is reached.
+     */
+    draftUntil?: Date;
+    /** Timestamp when usage quantities were last snapshotted for this invoice. */
+    quantitySnapshottedAt?: Date;
+    /** Timestamp when collection was initiated for this invoice. */
+    collectionAt?: Date;
+    /** Timestamp when payment is due. */
+    dueAt?: Date;
+    /** Timestamp when the invoice was sent to the customer. */
+    sentToCustomerAt?: Date;
+    /** Workflow configuration snapshot captured at invoice creation time. */
+    workflow: InvoiceWorkflowSettings;
+}
 /** Response of the entitlement access query. */
 export interface EntitlementAccessQueryResponse {
     /** Access evaluation results, one entry per resolved customer. */
@@ -4288,6 +4437,83 @@ export interface EntitlementAccessQueryResponse {
      */
     meta: CursorMeta;
 }
+/** A rate card defines the pricing and entitlement of a feature or service. */
+export interface RateCard {
+    /**
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
+     */
+    name: string;
+    /**
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
+     */
+    description?: string;
+    labels?: Labels;
+    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: Price;
+    /**
+     * Unit conversion configuration for the rate card.
+     *
+     * Synthesized on read for plans authored with 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 and update only when the UnitConfig feature is enabled on the
+     * deployment; otherwise rejected.
+     */
+    unitConfig?: UnitConfig;
+    /**
+     * The payment term of the rate card. In advance payment term can only be used for
+     * flat prices.
+     */
+    paymentTerm: PricePaymentTerm;
+    /**
+     * Spend commitments for this rate card. Only applicable to usage-based prices
+     * (unit, graduated, volume).
+     */
+    commitments?: SpendCommitments;
+    /** The discounts of the rate card. */
+    discounts?: RateCardDiscounts;
+    /** The tax config of the rate card. */
+    taxConfig?: RateCardTaxConfig;
+    /**
+     * The entitlement template granted to subscribers of a plan or addon containing
+     * this rate card. Requires `feature` to be set.
+     */
+    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: 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;
+}
 /**
  * Usage-based intent fields from the system lifecycle controller shadowed by a
  * manual override.
@@ -4316,7 +4542,12 @@ export interface ChargeUsageBasedSystemIntent {
     billingPeriod: ClosedPeriod;
     /** Discounts applied to the usage-based charge. */
     discounts?: RateCardDiscounts;
-    /** The price of the charge. */
+    /**
+     * The price of the charge.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete price.
+     */
     price: PriceUsageBased;
     /** Spend commitments for the charge. */
     commitments?: SpendCommitments;
@@ -4368,9 +4599,12 @@ export interface CreateChargeUsageBasedRequest {
     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. */
+    /**
+     * The price of the charge.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete price.
+     */
     price: PriceUsageBased;
     /** Spend commitments for the charge. */
     commitments?: SpendCommitments;
@@ -4385,87 +4619,17 @@ export interface CreateChargeUsageBasedRequest {
      * deployment; otherwise rejected.
      */
     unitConfig?: UnitConfig;
+    /** A reference to the feature associated with the charge. */
+    feature: FeatureReference;
     /** 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 RateCard {
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
-    /**
-     * Optional description of the resource.
-     *
-     * Maximum 1024 characters.
-     */
-    description?: string;
-    labels?: Labels;
-    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: Price;
-    /**
-     * Unit conversion configuration for the rate card.
-     *
-     * Synthesized on read for plans authored with 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 and update only when the UnitConfig feature is enabled on the
-     * deployment; otherwise rejected.
-     */
-    unitConfig?: UnitConfig;
-    /**
-     * The payment term of the rate card. In advance payment term can only be used for
-     * flat prices.
-     */
-    paymentTerm: PricePaymentTerm;
-    /**
-     * Spend commitments for this rate card. Only applicable to usage-based prices
-     * (unit, graduated, volume).
-     */
-    commitments?: SpendCommitments;
-    /** The discounts of the rate card. */
-    discounts?: RateCardDiscounts;
-    /** The tax config of the rate card. */
-    taxConfig?: RateCardTaxConfig;
-    /**
-     * The entitlement template granted to subscribers of a plan or addon containing
-     * this rate card. Requires `feature` to be set.
-     */
-    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: 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;
+/** Page paginated response. */
+export interface FeaturePagePaginatedResponse {
+    data: Feature[];
+    meta: PaginatedMeta;
 }
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface UpdateInvoiceLineRateCard {
@@ -4478,11 +4642,6 @@ export interface UpdateInvoiceLineRateCard {
     /** Discount configuration from the rate card. */
     discounts?: UpdateDiscounts;
 }
-/** Page paginated response. */
-export interface FeaturePagePaginatedResponse {
-    data: Feature[];
-    meta: PaginatedMeta;
-}
 /** Billing workflow settings. */
 export interface Workflow {
     /** The collection settings for this workflow */
@@ -4508,95 +4667,6 @@ export interface ProfileApps {
     /** The payment app used for this workflow. */
     payment: App;
 }
-/** A usage-based charge for a customer. */
-export interface ChargeUsageBased {
-    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?: 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
-     * customer-facing intent.
-     */
-    systemIntent?: ChargeUsageBasedSystemIntent;
-}
 /** A subscription item pins a rate card to a cadence within a subscription phase. */
 export interface SubscriptionItem {
     /** The unique identifier of the subscription item instance. */
@@ -4962,6 +5032,66 @@ export interface UpsertBillingProfileRequest {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/**
+ * A realization run of a charge.
+ *
+ * `totals` and `detailed_lines` are only populated with the `realization.totals`
+ * and `realization.detailed_lines` expands, respectively, since computing them
+ * requires re-deriving the run's rated breakdown. `invoice` is an ID reference
+ * unless the `realization.invoice` expand is used, which resolves it to the
+ * invoice header of the run's booked line: the invoice entity without its `lines`
+ * and without the `customer` snapshot (the charge itself already identifies the
+ * customer).
+ */
+export interface ChargeRealization {
+    /**
+     * The ID of the realization run. Not present on `outstanding` entries, which are
+     * projections rather than persisted runs.
+     */
+    id?: string;
+    /**
+     * The ID of the invoice line this realization was booked to, when the realization
+     * has been invoiced.
+     */
+    lineId?: string;
+    /** The reference of the invoice related to the realization. */
+    invoice?: ChargeRealizationInvoiceOrReference;
+    /** The type of the realization run. */
+    type: 'final_realization' | 'partial_invoice' | 'outstanding' | 'voided';
+    /** The service period covered by this realization run. */
+    servicePeriod: ClosedPeriod;
+    /**
+     * The metered usage quantity this realization run accounts for. Only present on
+     * usage-based charges; flat fees are not metered, so their realizations carry no
+     * usage.
+     *
+     * Booked entries report a signed delta: a negative value states a downward usage
+     * correction (or a voided run that snapshotted behind its live neighbors) instead
+     * of masking it as zero.
+     *
+     * On an `outstanding` entry this is `0` unless the `real_time_usage` expand is
+     * applied, in which case it is the not-yet-booked remainder of the live metering
+     * read (never negative).
+     */
+    usage?: string;
+    /**
+     * The payment state of the realization, when the charge requires a fiat
+     * transaction to settle.
+     */
+    payment?: ChargeRealizationPayment;
+    /**
+     * Financial totals for the realization run, including credit allocations.
+     *
+     * Requires the `realization.totals` expand.
+     */
+    totals?: Totals;
+    /**
+     * The detailed (rated) lines produced by the realization run.
+     *
+     * Requires the `realization.detailed_lines` expand.
+     */
+    detailedLines?: ChargeRealizationDetailedLine[];
+}
 /**
  * A subscription phase groups the rate cards in effect for a segment of the
  * subscription's lifetime. Analogous to plan phases.
@@ -5188,11 +5318,6 @@ export interface ProfilePagePaginatedResponse {
     data: Profile[];
     meta: PaginatedMeta;
 }
-/** Page paginated response. */
-export interface ChargePagePaginatedResponse {
-    data: Charge[];
-    meta: PaginatedMeta;
-}
 /** Subscription. */
 export interface Subscription {
     id: string;
@@ -5413,11 +5538,213 @@ export interface SubscriptionChangeResponse {
     /** The new state of the subscription after the change. */
     next: Subscription;
 }
+/** 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.
+     *
+     * By default, only the `id` of the customer is returned. For more details use the
+     * `customer` expand.
+     */
+    customer: CustomerOrReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by the system 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.
+     *
+     * By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
+     * returned. For more details use the `subscription` expand.
+     */
+    subscription?: SubscriptionOrReference;
+    /** 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;
+    /** The realization runs of the charge, sorted by `created_at`. */
+    realizations: ChargeRealization[];
+    /** 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. */
+    feature?: FeatureOrReference;
+    /** 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;
+}
+/** A usage-based charge for a customer. */
+export interface ChargeUsageBased {
+    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.
+     *
+     * By default, only the `id` of the customer is returned. For more details use the
+     * `customer` expand.
+     */
+    customer: CustomerOrReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by the system 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.
+     *
+     * By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
+     * returned. For more details use the `subscription` expand.
+     */
+    subscription?: SubscriptionOrReference;
+    /** 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;
+    /** The realization runs of the charge, sorted by `created_at`. */
+    realizations: ChargeRealization[];
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The feature associated with the charge. */
+    feature: FeatureOrReference;
+    /** Aggregated booked and realtime totals for the charge. */
+    totals: ChargeTotals;
+    /**
+     * The metered usage quantity of the charge for its full service period.
+     *
+     * Requires the `real_time_usage` expand, since it is computed live from the
+     * metering store rather than stored on the charge.
+     */
+    usage?: string;
+    /**
+     * The price of the charge.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete 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
+     * customer-facing intent.
+     */
+    systemIntent?: ChargeUsageBasedSystemIntent;
+}
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponse {
     data: Invoice[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
+export interface ChargePagePaginatedResponse {
+    data: Charge[];
+    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.
@@ -5476,6 +5803,8 @@ export type DateTimeFieldFilter = Date | {
     gt?: Date;
     gte?: Date;
 };
+/** Payment settings for a billing workflow. */
+export type WorkflowPaymentSettings = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
 /**
  * Subscription edit timing defined when the changes should take effect. If the
  * provided configuration is not supported by the subscription, an error will be
@@ -5485,8 +5814,6 @@ 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;
@@ -5502,8 +5829,20 @@ export type UpdateAppRequest = UpdateAppStripeRequest | UpdateAppSandboxRequest
  * dynamic LLM cost lookup.
  */
 export type FeatureUnitCost = FeatureManualUnitCost | FeatureLlmUnitCost;
+/**
+ * A detailed (child) line type of a charge realization run.
+ *
+ * This is distinct from an invoice's own detailed lines: it represents the
+ * rated/priced breakdown produced by the realization run itself, before that
+ * breakdown is (or is not yet) reflected on an invoice line. Credit-then-invoice
+ * runs include credit allocations in these lines, while credits-only runs keep the
+ * gross rated detail.
+ */
+export type ChargeRealizationDetailedLine = ChargeRealizationDetailedLineFlatFee | ChargeRealizationDetailedLineUsageBased;
 /** Fiat or custom currency. */
 export type Currency = CurrencyFiat | CurrencyCustom;
+/** Customer or reference. */
+export type CustomerOrReference = Customer | CustomerReference;
 /**
  * The alignment for collecting the pending line items into an invoice.
  *
@@ -5512,6 +5851,8 @@ export type Currency = CurrencyFiat | CurrencyCustom;
  * arrears items).
  */
 export type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+/** Price. */
+export type Price = PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
 /**
  * Usage-based price types for a rate card or charge.
  *
@@ -5520,17 +5861,17 @@ export type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscriptio
  */
 export type PriceUsageBased = PriceUnit | PriceGraduated | PriceVolume;
 /** 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;
 /** Response of the app install. */
 export type BillingInstallAppResponse = InstalledAppStripe | InstalledAppSandbox | InstalledAppExternalInvoicing;
+/** Feature or reference. */
+export type FeatureOrReference = Feature | FeatureReference;
+/** ChargeRealizationInvoice or reference. */
+export type ChargeRealizationInvoiceOrReference = ChargeRealizationInvoice | ChargeRealizationInvoiceReference;
 /** Customer charge. */
 export type CreateChargeRequest = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequest;
-/** Customer charge. */
-export type Charge = ChargeFlatFee | ChargeUsageBased;
 /**
  * A top-level line item on an invoice.
  *
@@ -5547,6 +5888,8 @@ export type InvoiceLine = InvoiceStandardLine;
  * present.
  */
 export type UpdateInvoiceLine = UpdateInvoiceStandardLine;
+/** Subscription or reference. */
+export type SubscriptionOrReference = Subscription | SubscriptionReference;
 /**
  * An invoice issued to a customer.
  *
@@ -5557,6 +5900,8 @@ export type UpdateInvoiceLine = UpdateInvoiceStandardLine;
 export type Invoice = InvoiceStandard;
 /** UpdateInvoiceRequest update request. */
 export type UpdateInvoiceRequest = UpdateInvoiceStandardRequest;
+/** Customer charge. */
+export type Charge = ChargeFlatFee | ChargeUsageBased;
 /**
  * Sort query.
  *
@@ -5586,19 +5931,6 @@ 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';
-    /**
-     * The period after which the invoice is due. With some payment solutions it's only
-     * applicable for manual collection method.
-     */
-    dueAfter?: string;
-}
 /**
  * Invoice-level invoicing settings.
  *
@@ -5614,6 +5946,19 @@ export interface InvoiceWorkflowInvoicingSettingsInput {
     /** The period after which the invoice is considered overdue if not paid. */
     dueAfter?: string;
 }
+/**
+ * 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';
+    /**
+     * The period after which the invoice is due. With some payment solutions it's only
+     * applicable for manual collection method.
+     */
+    dueAfter?: string;
+}
 /**
  * Invoice-level invoicing settings.
  *
@@ -5823,6 +6168,46 @@ 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.
  *
@@ -5862,64 +6247,24 @@ export interface UnitConfigInput {
     /**
      * The rounding mode applied to the converted quantity for invoicing.
      *
-     * Defaults to none (no rounding). Entitlement checks always use the precise
-     * (unrounded) value.
-     */
-    rounding?: 'ceiling' | 'floor' | 'half_up' | 'none';
-    /**
-     * The number of decimal places to retain after rounding.
-     *
-     * Only meaningful when rounding is not "none". Defaults to 0 (round to whole
-     * numbers).
-     */
-    precision?: number;
-    /**
-     * A human-readable label for the converted unit shown on invoices and in the
-     * customer portal (e.g., "GB", "hours", "M tokens").
-     *
-     * Optional. When omitted, no unit label is rendered.
-     */
-    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.
+     * Defaults to none (no rounding). Entitlement checks always use the precise
+     * (unrounded) value.
      */
-    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;
-    };
+    rounding?: 'ceiling' | 'floor' | 'half_up' | 'none';
     /**
-     * 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:
+     * The number of decimal places to retain after rounding.
      *
-     * - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
-     * - Subscription anniversary (day customer signed up)
-     * - Custom date (customer-specified day)
+     * Only meaningful when rounding is not "none". Defaults to 0 (round to whole
+     * numbers).
+     */
+    precision?: number;
+    /**
+     * A human-readable label for the converted unit shown on invoices and in the
+     * customer portal (e.g., "GB", "hours", "M tokens").
      *
-     * If not provided, the subscription will be created with the subscription's
-     * creation time as the billing anchor.
+     * Optional. When omitted, no unit label is rendered.
      */
-    billingAnchor?: Date;
-    /** Controls how custom-currency cost bases are selected for the subscription. */
-    costBasisMode?: 'dynamic' | 'pinned';
+    displayUnit?: string;
 }
 /** Invoice settings for a billing workflow. */
 export interface WorkflowInvoicingSettingsInput {
@@ -5957,6 +6302,19 @@ export interface IngestedEventInput {
     /** The validation errors of the ingested event. */
     validationErrors?: IngestedEventValidationError[];
 }
+/**
+ * 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?: WorkflowPaymentSettingsInput;
+}
 /** Request for canceling a subscription. */
 export interface SubscriptionCancelInput {
     /** If not provided the subscription is canceled immediately. */
@@ -6008,19 +6366,6 @@ export interface SubscriptionChangeInput {
      */
     timing: SubscriptionEditTiming;
 }
-/**
- * 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?: WorkflowPaymentSettingsInput;
-}
 /**
  * Invoice-level snapshot of the workflow configuration.
  *
@@ -6423,16 +6768,16 @@ export interface WorkflowCollectionSettingsInput {
     interval?: string;
 }
 /**
- * Usage-based intent fields from the system lifecycle controller shadowed by a
- * manual override.
+ * The invoice a charge realization was booked to, embedded as a header.
+ *
+ * Matches the standard invoice entity, except that it carries no `customer`
+ * snapshot (the charge context already identifies the customer) and `lines` are
+ * never populated (the realization itself is the line-level breakdown). The shared
+ * invoice contract stays untouched: this model exists so the charges API can slim
+ * the embedding without loosening the invoices API.
  */
-export interface ChargeUsageBasedSystemIntentInput {
-    /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
-     */
-    name: string;
+export interface ChargeRealizationInvoiceInput {
+    id: string;
     /**
      * Optional description of the resource.
      *
@@ -6440,89 +6785,64 @@ export interface ChargeUsageBasedSystemIntentInput {
      */
     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.
-     */
+    /** 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;
-}
-/** Usage-based charge create request. */
-export interface CreateChargeUsageBasedRequestInput {
+    /** Human-readable invoice number generated by the invoicing app. */
+    number: string;
+    /** Three-letter ISO 4217 currency code for the invoice. */
+    currency: string;
     /**
-     * Display name of the resource.
-     *
-     * Between 1 and 256 characters.
+     * Snapshot of the supplier's contact information at the time the invoice was
+     * issued.
      */
-    name: string;
+    supplier: Supplier;
+    /** Aggregated financial totals for the invoice. */
+    totals: Totals;
     /**
-     * Optional description of the resource.
+     * The service period covered by this invoice.
      *
-     * Maximum 1024 characters.
+     * For flat fee the service period can be empty which means `from` will be equals
+     * to `to`. In other cases those fields will be filled with the actual service
+     * period.
      */
-    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.
+     * Validation issues found during invoice processing.
      *
-     * 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.
+     * Present only when there are one or more validation findings. An empty list is
+     * omitted.
+     */
+    validationIssues?: InvoiceValidationIssue[];
+    /** External identifiers assigned to this invoice by third-party systems. */
+    externalReferences?: InvoiceExternalReferences;
+    /** Discriminator field identifying this as a standard invoice. */
+    type: 'standard';
+    /** Current lifecycle status of the invoice. */
+    status: 'draft' | 'issuing' | 'issued' | 'payment_processing' | 'overdue' | 'paid' | 'uncollectible' | 'voided';
+    /** Detailed status information including available actions and workflow state. */
+    statusDetails: InvoiceStatusDetails;
+    /** Timestamp when the invoice was issued to the customer. */
+    issuedAt?: Date;
+    /**
+     * Timestamp until which the invoice remains in draft state.
      *
-     * Accepted on create only when the UnitConfig feature is enabled on the
-     * deployment; otherwise rejected.
+     * The invoice advances automatically once this time is reached.
      */
-    unitConfig?: UnitConfigInput;
-    /** The full, unprorated service period of the charge. */
-    fullServicePeriod?: ClosedPeriod;
-    /** The billing period the charge belongs to. */
-    billingPeriod?: ClosedPeriod;
+    draftUntil?: Date;
+    /** Timestamp when usage quantities were last snapshotted for this invoice. */
+    quantitySnapshottedAt?: Date;
+    /** Timestamp when collection was initiated for this invoice. */
+    collectionAt?: Date;
+    /** Timestamp when payment is due. */
+    dueAt?: Date;
+    /** Timestamp when the invoice was sent to the customer. */
+    sentToCustomerAt?: Date;
+    /** Workflow configuration snapshot captured at invoice creation time. */
+    workflow: InvoiceWorkflowSettingsInput;
 }
 /** A rate card defines the pricing and entitlement of a feature or service. */
 export interface RateCardInput {
@@ -6601,20 +6921,11 @@ export interface InvoiceLineRateCardInput {
      */
     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?: WorkflowPaymentSettingsInput;
-    /** The tax settings for this workflow */
-    tax?: WorkflowTaxSettingsInput;
-}
-/** A usage-based charge for a customer. */
-export interface ChargeUsageBasedInput {
-    id: string;
+/**
+ * Usage-based intent fields from the system lifecycle controller shadowed by a
+ * manual override.
+ */
+export interface ChargeUsageBasedSystemIntentInput {
     /**
      * Display name of the resource.
      *
@@ -6628,43 +6939,65 @@ export interface ChargeUsageBasedInput {
      */
     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. */
+    /** 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.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete 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?: 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;
-    /** The type of the charge. */
-    type: 'usage_based';
-    /** The customer owning the charge. */
-    customer: BillingCustomerReference;
+}
+/** Usage-based charge create request. */
+export interface CreateChargeUsageBasedRequestInput {
     /**
-     * Indicates whether the charge lifecycle is controlled by OpenMeter or manually
-     * overridden by the API user.
+     * Display name of the resource.
+     *
+     * Between 1 and 256 characters.
      */
-    lifecycleController: 'system' | 'manual';
+    name: string;
     /**
-     * The subscription that originated the charge, when the charge was created from a
-     * subscription item.
+     * Optional description of the resource.
+     *
+     * Maximum 1024 characters.
      */
-    subscription?: SubscriptionReference;
+    description?: string;
+    labels?: Labels;
+    /** The type of the charge. */
+    type: 'usage_based';
     /** 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. */
@@ -6673,13 +7006,12 @@ export interface ChargeUsageBasedInput {
     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. */
+    /**
+     * The price of the charge.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete price.
+     */
     price: PriceUsageBased;
     /** Spend commitments for the charge. */
     commitments?: SpendCommitments;
@@ -6694,12 +7026,23 @@ export interface ChargeUsageBasedInput {
      * 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 reference to the feature associated with the charge. */
+    feature: FeatureReference;
+    /** The full, unprorated service period of the charge. */
+    fullServicePeriod?: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billingPeriod?: ClosedPeriod;
+}
+/** 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?: WorkflowPaymentSettingsInput;
+    /** The tax settings for this workflow */
+    tax?: WorkflowTaxSettingsInput;
 }
 /** A subscription item pins a rate card to a cadence within a subscription phase. */
 export interface SubscriptionItemInput {
@@ -7024,6 +7367,66 @@ export interface UpsertBillingProfileRequestInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/**
+ * A realization run of a charge.
+ *
+ * `totals` and `detailed_lines` are only populated with the `realization.totals`
+ * and `realization.detailed_lines` expands, respectively, since computing them
+ * requires re-deriving the run's rated breakdown. `invoice` is an ID reference
+ * unless the `realization.invoice` expand is used, which resolves it to the
+ * invoice header of the run's booked line: the invoice entity without its `lines`
+ * and without the `customer` snapshot (the charge itself already identifies the
+ * customer).
+ */
+export interface ChargeRealizationInput {
+    /**
+     * The ID of the realization run. Not present on `outstanding` entries, which are
+     * projections rather than persisted runs.
+     */
+    id?: string;
+    /**
+     * The ID of the invoice line this realization was booked to, when the realization
+     * has been invoiced.
+     */
+    lineId?: string;
+    /** The reference of the invoice related to the realization. */
+    invoice?: ChargeRealizationInvoiceOrReferenceInput;
+    /** The type of the realization run. */
+    type: 'final_realization' | 'partial_invoice' | 'outstanding' | 'voided';
+    /** The service period covered by this realization run. */
+    servicePeriod: ClosedPeriod;
+    /**
+     * The metered usage quantity this realization run accounts for. Only present on
+     * usage-based charges; flat fees are not metered, so their realizations carry no
+     * usage.
+     *
+     * Booked entries report a signed delta: a negative value states a downward usage
+     * correction (or a voided run that snapshotted behind its live neighbors) instead
+     * of masking it as zero.
+     *
+     * On an `outstanding` entry this is `0` unless the `real_time_usage` expand is
+     * applied, in which case it is the not-yet-booked remainder of the live metering
+     * read (never negative).
+     */
+    usage?: string;
+    /**
+     * The payment state of the realization, when the charge requires a fiat
+     * transaction to settle.
+     */
+    payment?: ChargeRealizationPayment;
+    /**
+     * Financial totals for the realization run, including credit allocations.
+     *
+     * Requires the `realization.totals` expand.
+     */
+    totals?: Totals;
+    /**
+     * The detailed (rated) lines produced by the realization run.
+     *
+     * Requires the `realization.detailed_lines` expand.
+     */
+    detailedLines?: ChargeRealizationDetailedLine[];
+}
 /**
  * A subscription phase groups the rate cards in effect for a segment of the
  * subscription's lifetime. Analogous to plan phases.
@@ -7250,11 +7653,6 @@ export interface ProfilePagePaginatedResponseInput {
     data: ProfileInput[];
     meta: PaginatedMeta;
 }
-/** Page paginated response. */
-export interface ChargePagePaginatedResponseInput {
-    data: ChargeInput[];
-    meta: PaginatedMeta;
-}
 /** Subscription. */
 export interface SubscriptionInput {
     id: string;
@@ -7475,11 +7873,213 @@ export interface SubscriptionChangeResponseInput {
     /** The new state of the subscription after the change. */
     next: SubscriptionInput;
 }
+/** A flat fee charge for a customer. */
+export interface ChargeFlatFeeInput {
+    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.
+     *
+     * By default, only the `id` of the customer is returned. For more details use the
+     * `customer` expand.
+     */
+    customer: CustomerOrReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by the system 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.
+     *
+     * By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
+     * returned. For more details use the `subscription` expand.
+     */
+    subscription?: SubscriptionOrReferenceInput;
+    /** 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;
+    /** The realization runs of the charge, sorted by `created_at`. */
+    realizations: ChargeRealizationInput[];
+    /** 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. */
+    feature?: FeatureOrReference;
+    /** 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;
+}
+/** 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.
+     *
+     * By default, only the `id` of the customer is returned. For more details use the
+     * `customer` expand.
+     */
+    customer: CustomerOrReference;
+    /**
+     * Indicates whether the charge lifecycle is controlled by the system 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.
+     *
+     * By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is
+     * returned. For more details use the `subscription` expand.
+     */
+    subscription?: SubscriptionOrReferenceInput;
+    /** 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;
+    /** The realization runs of the charge, sorted by `created_at`. */
+    realizations: ChargeRealizationInput[];
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The feature associated with the charge. */
+    feature: FeatureOrReference;
+    /** Aggregated booked and realtime totals for the charge. */
+    totals: ChargeTotals;
+    /**
+     * The metered usage quantity of the charge for its full service period.
+     *
+     * Requires the `real_time_usage` expand, since it is computed live from the
+     * metering store rather than stored on the charge.
+     */
+    usage?: string;
+    /**
+     * The price of the charge.
+     *
+     * `free` prices are rejected on create: a usage-based charge always carries a
+     * concrete 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?: 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;
+}
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponseInput {
     data: InvoiceInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
+export interface ChargePagePaginatedResponseInput {
+    data: ChargeInput[];
+    meta: PaginatedMeta;
+}
 /** Payment settings for a billing workflow. */
 export type WorkflowPaymentSettingsInput = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
 /** Payment settings for a billing workflow. */
@@ -7489,10 +8089,10 @@ export type UpdateBillingWorkflowPaymentSettingsInput = UpdateBillingWorkflowPay
  * rate card itself, so it is omitted here.
  */
 export type RateCardEntitlementInput = RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/** ChargeRealizationInvoice or reference. */
+export type ChargeRealizationInvoiceOrReferenceInput = ChargeRealizationInvoiceInput | ChargeRealizationInvoiceReference;
 /** Customer charge. */
 export type CreateChargeRequestInput = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequestInput;
-/** Customer charge. */
-export type ChargeInput = ChargeFlatFee | ChargeUsageBasedInput;
 /**
  * A top-level line item on an invoice.
  *
@@ -7501,6 +8101,8 @@ export type ChargeInput = ChargeFlatFee | ChargeUsageBasedInput;
  * present.
  */
 export type InvoiceLineInput = InvoiceStandardLineInput;
+/** Subscription or reference. */
+export type SubscriptionOrReferenceInput = SubscriptionInput | SubscriptionReference;
 /**
  * An invoice issued to a customer.
  *
@@ -7511,3 +8113,5 @@ export type InvoiceLineInput = InvoiceStandardLineInput;
 export type InvoiceInput = InvoiceStandardInput;
 /** UpdateInvoiceRequest update request. */
 export type UpdateInvoiceRequestInput = UpdateInvoiceStandardRequestInput;
+/** Customer charge. */
+export type ChargeInput = ChargeFlatFeeInput | ChargeUsageBasedInput;