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

package/dist/models/schemas.js

@@ -423,17 +423,63 @@ export const creditTransactionType = z
     .enum(['funded', 'consumed', 'expired', 'voided'])
     .describe('The type of the credit transaction. - `funded`: Credit granted and available for consumption. - `consumed`: Credit consumed by usage or fees. - `expired`: Credit removed because it expired before being used. - `voided`: Credit removed because the grant was voided before being used.');
 export const chargesExpand = z
-    .enum(['real_time_usage'])
-    .describe("Expands for customer charges. Values: - `real_time_usage`: The charge's real-time usage.");
+    .enum([
+    'real_time_usage',
+    'customer',
+    'feature',
+    'subscription',
+    'realization.invoice',
+    'realization.totals',
+    'realization.detailed_lines',
+])
+    .describe("Expands for customer charges. Values: - `real_time_usage`: The charge's real-time usage; it sets the `usage` and the `totals.realtime` fields, and fills the `outstanding` realization's `usage` with the not-yet-booked remainder of the live read. - `customer`: The complete customer entity of the charge. - `feature`: The complete feature entity of the charge. - `subscription`: The complete subscription of the charge, when present. - `realization.invoice`: The invoice header of each realization (the invoice entity without its `lines` and `customer` snapshot), in place of the ID reference. - `realization.totals`: The `totals` of each realization run, including credit allocations. - `realization.detailed_lines`: The `detailed_lines` of each realization run.");
 export const lifecycleController = z
     .enum(['system', 'manual'])
     .describe('Identifies whether a resource lifecycle is controlled by OpenMeter or manually overridden by the API user. Values: - `system`: The resource lifecycle is controlled by OpenMeter. - `manual`: The resource lifecycle was manually overridden by the API user.');
-export const chargeStatus = z
-    .enum(['created', 'active', 'final', 'deleted'])
-    .describe('Lifecycle status of a charge. Values: - `created`: The charge has been created but is not active yet. - `active`: The charge is active. - `final`: The charge is fully finalized and no further changes are expected. - `deleted`: The charge has been deleted.');
+export const subscriptionCostBasisMode = z
+    .enum(['dynamic', 'pinned'])
+    .describe('Controls how custom-currency cost bases are selected for the subscription.');
+export const rateCardProrationMode = z
+    .enum(['no_proration', 'prorate_prices'])
+    .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
+export const subscriptionStatus = z
+    .enum(['active', 'inactive', 'canceled', 'scheduled'])
+    .describe('Subscription status.');
 export const settlementMode = z
     .enum(['credit_then_invoice', 'credit_only'])
     .describe('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.');
+export const priceFree = z
+    .object({
+    type: z.literal('free').describe('The type of the price.'),
+})
+    .describe('Free price.');
+export const unitConfigOperation = z
+    .enum(['divide', 'multiply'])
+    .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
+export const unitConfigRoundingMode = z
+    .enum(['ceiling', 'floor', 'half_up', 'none'])
+    .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
+export const pricePaymentTerm = z
+    .union([z.literal('in_advance'), z.literal('in_arrears')])
+    .describe('The payment term of a flat price.');
+export const rateCardStaticEntitlement = z
+    .object({
+    type: z.literal('static').describe('The type of the entitlement template.'),
+    config: z
+        .unknown()
+        .describe('The entitlement config as a JSON object. Returned when checking entitlement access; useful for configuring fine-grained access settings implemented in your own system.'),
+})
+    .describe('The entitlement template of a static entitlement.');
+export const rateCardBooleanEntitlement = z
+    .object({
+    type: z
+        .literal('boolean')
+        .describe('The type of the entitlement template.'),
+})
+    .describe('The entitlement template of a boolean entitlement.');
+export const chargeStatus = z
+    .enum(['created', 'active', 'final', 'deleted'])
+    .describe('Lifecycle status of a charge. Values: - `created`: The charge has been created but is not active yet. - `active`: The charge is active. - `final`: The charge is fully finalized and no further changes are expected. - `deleted`: The charge has been deleted.');
 export const taxConfigStripe = z
     .object({
     code: z
@@ -450,9 +496,96 @@ export const taxConfigExternalInvoicing = z
         .describe('The tax code should be interpreted by the external invoicing provider.'),
 })
     .describe('External invoicing tax config.');
-export const pricePaymentTerm = z
-    .union([z.literal('in_advance'), z.literal('in_arrears')])
-    .describe('The payment term of a flat price.');
+export const invoiceNumber = z
+    .string()
+    .min(1)
+    .max(256)
+    .describe('InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app. The uniqueness depends on a lot of factors: - app setting (unique per app or unique per customer) - multiple app scenarios (multiple apps generating invoices with the same prefix)');
+export const taxIdentificationCode = z
+    .string()
+    .min(1)
+    .max(32)
+    .describe('Tax identifier code is a normalized tax code shown on the original identity document.');
+export const invoiceValidationIssueSeverity = z
+    .enum(['critical', 'warning'])
+    .describe('Severity level of an invoice validation issue.');
+export const invoiceExternalReferences = z
+    .object({
+    invoicingId: z
+        .string()
+        .optional()
+        .describe('The ID assigned by the external invoicing app (e.g. Stripe invoice ID).'),
+    paymentId: z
+        .string()
+        .optional()
+        .describe('The ID assigned by the external payment app (e.g. Stripe payment intent ID).'),
+})
+    .describe('External identifiers assigned to an invoice by third-party systems.');
+export const invoiceStandardStatus = z
+    .enum([
+    'draft',
+    'issuing',
+    'issued',
+    'payment_processing',
+    'overdue',
+    'paid',
+    'uncollectible',
+    'voided',
+])
+    .describe('Lifecycle status of a standard invoice.');
+export const invoiceAvailableActionDetails = z
+    .object({
+    resultingState: z
+        .string()
+        .describe('The extended status the invoice will transition to after performing this action.'),
+})
+    .describe('Details about an available invoice action including the resulting state.');
+export const invoiceWorkflowInvoicingSettings = z
+    .object({
+    autoAdvance: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Whether to automatically issue the invoice after the draft_period has passed.'),
+    draftPeriod: z
+        .string()
+        .optional()
+        .default('P0D')
+        .describe('The period for the invoice to be kept in draft status for manual reviews.'),
+    dueAfter: z
+        .string()
+        .optional()
+        .describe('The period after which the invoice is considered overdue if not paid.'),
+})
+    .describe('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 const workflowPaymentChargeAutomaticallySettings = z
+    .object({
+    collectionMethod: z
+        .literal('charge_automatically')
+        .describe('The collection method for the invoice.'),
+})
+    .describe('Payment settings for a billing workflow when the collection method is charge automatically.');
+export const workflowPaymentSendInvoiceSettings = z
+    .object({
+    collectionMethod: z
+        .literal('send_invoice')
+        .describe('The collection method for the invoice.'),
+    dueAfter: z
+        .string()
+        .optional()
+        .default('P30D')
+        .describe("The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method."),
+})
+    .describe('Payment settings for a billing workflow when the collection method is send invoice.');
+export const chargeRealizationType = z
+    .enum(['final_realization', 'partial_invoice', 'outstanding', 'voided'])
+    .describe("Type of a charge realization run. Values: - `final_realization`: The run is the final realization of the charge for its service period; no further runs are expected to correct it. - `partial_invoice`: The run only realizes part of the charge, because the remainder is not yet due to be invoiced. - `outstanding`: The type an outstanding (not-yet-realized) projection would carry if it were realized now. Never returned on a booked realization run. - `voided`: The run's billing effect was undone (for example the charge's service period was extended while its invoice was still mutable); it is retained as audit history and excluded from aggregate and live calculations.");
+export const chargeRealizationPaymentStatus = z
+    .enum(['authorized', 'settled'])
+    .describe("Settlement status of a charge realization's payment. Values: - `authorized`: The payment has been authorized against the customer's ledger but has not settled yet. - `settled`: The payment has settled.");
+export const chargeRealizationDetailedLineCategory = z
+    .enum(['regular', 'commitment'])
+    .describe('Cost category of a charge realization detailed line. Values: - `regular`: A regular charge line, based on usage or subscription pricing. - `commitment`: A commitment-derived line, such as minimum spend.');
 export const chargeFlatFeeDiscounts = z
     .object({
     percentage: z
@@ -463,41 +596,17 @@ export const chargeFlatFeeDiscounts = z
         .describe('Percentage discount applied to the price (0–100).'),
 })
     .describe('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 const rateCardProrationMode = z
-    .enum(['no_proration', 'prorate_prices'])
-    .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
-export const unitConfigOperation = z
-    .enum(['divide', 'multiply'])
-    .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
-export const unitConfigRoundingMode = z
-    .enum(['ceiling', 'floor', 'half_up', 'none'])
-    .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
-export const subscriptionCostBasisMode = z
-    .enum(['dynamic', 'pinned'])
-    .describe('Controls how custom-currency cost bases are selected for the subscription.');
-export const subscriptionStatus = z
-    .enum(['active', 'inactive', 'canceled', 'scheduled'])
-    .describe('Subscription status.');
-export const priceFree = z
-    .object({
-    type: z.literal('free').describe('The type of the price.'),
-})
-    .describe('Free price.');
-export const rateCardStaticEntitlement = z
-    .object({
-    type: z.literal('static').describe('The type of the entitlement template.'),
-    config: z
-        .unknown()
-        .describe('The entitlement config as a JSON object. Returned when checking entitlement access; useful for configuring fine-grained access settings implemented in your own system.'),
-})
-    .describe('The entitlement template of a static entitlement.');
-export const rateCardBooleanEntitlement = z
-    .object({
-    type: z
-        .literal('boolean')
-        .describe('The type of the entitlement template.'),
-})
-    .describe('The entitlement template of a boolean entitlement.');
+export const featureLlmTokenType = z
+    .enum([
+    'input',
+    'output',
+    'cache_read',
+    'cache_write',
+    'reasoning',
+    'request',
+    'response',
+])
+    .describe('Token type for LLM cost lookup.');
 export const subscriptionEditTimingEnum = z
     .enum(['immediate', 'next_billing_cycle'])
     .describe('Subscription edit timing. When immediate, the requested changes take effect immediately. When next_billing_cycle, the requested changes take effect at the next billing cycle.');
@@ -550,11 +659,6 @@ export const installAppExternalInvoicing = z
         .describe('If true, a billing profile will be created for the app. The Stripe app will be also set as the default billing profile if the current default is a Sandbox app.'),
 })
     .describe('Base model for installing an app from the catalog.');
-export const taxIdentificationCode = z
-    .string()
-    .min(1)
-    .max(32)
-    .describe('Tax identifier code is a normalized tax code shown on the original identity document.');
 export const workflowCollectionAlignmentSubscription = z
     .object({
     type: z.literal('subscription').describe('The type of alignment.'),
@@ -563,82 +667,6 @@ export const workflowCollectionAlignmentSubscription = z
 export const workflowInvoicingSubscriptionEndProrationMode = z
     .enum(['bill_full_period', 'bill_actual_period'])
     .describe('Billing workflow subscription end proration mode.');
-export const workflowPaymentChargeAutomaticallySettings = z
-    .object({
-    collectionMethod: z
-        .literal('charge_automatically')
-        .describe('The collection method for the invoice.'),
-})
-    .describe('Payment settings for a billing workflow when the collection method is charge automatically.');
-export const workflowPaymentSendInvoiceSettings = z
-    .object({
-    collectionMethod: z
-        .literal('send_invoice')
-        .describe('The collection method for the invoice.'),
-    dueAfter: z
-        .string()
-        .optional()
-        .default('P30D')
-        .describe("The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method."),
-})
-    .describe('Payment settings for a billing workflow when the collection method is send invoice.');
-export const invoiceNumber = z
-    .string()
-    .min(1)
-    .max(256)
-    .describe('InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app. The uniqueness depends on a lot of factors: - app setting (unique per app or unique per customer) - multiple app scenarios (multiple apps generating invoices with the same prefix)');
-export const invoiceValidationIssueSeverity = z
-    .enum(['critical', 'warning'])
-    .describe('Severity level of an invoice validation issue.');
-export const invoiceExternalReferences = z
-    .object({
-    invoicingId: z
-        .string()
-        .optional()
-        .describe('The ID assigned by the external invoicing app (e.g. Stripe invoice ID).'),
-    paymentId: z
-        .string()
-        .optional()
-        .describe('The ID assigned by the external payment app (e.g. Stripe payment intent ID).'),
-})
-    .describe('External identifiers assigned to an invoice by third-party systems.');
-export const invoiceStandardStatus = z
-    .enum([
-    'draft',
-    'issuing',
-    'issued',
-    'payment_processing',
-    'overdue',
-    'paid',
-    'uncollectible',
-    'voided',
-])
-    .describe('Lifecycle status of a standard invoice.');
-export const invoiceAvailableActionDetails = z
-    .object({
-    resultingState: z
-        .string()
-        .describe('The extended status the invoice will transition to after performing this action.'),
-})
-    .describe('Details about an available invoice action including the resulting state.');
-export const invoiceWorkflowInvoicingSettings = z
-    .object({
-    autoAdvance: z
-        .boolean()
-        .optional()
-        .default(true)
-        .describe('Whether to automatically issue the invoice after the draft_period has passed.'),
-    draftPeriod: z
-        .string()
-        .optional()
-        .default('P0D')
-        .describe('The period for the invoice to be kept in draft status for manual reviews.'),
-    dueAfter: z
-        .string()
-        .optional()
-        .describe('The period after which the invoice is considered overdue if not paid.'),
-})
-    .describe('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 const invoiceDiscountReason = z
     .enum(['maximum_spend', 'ratecard_percentage', 'ratecard_usage'])
     .describe('The reason a discount was applied to an invoice line.');
@@ -697,17 +725,6 @@ export const currencyType = z
 export const currencyExpand = z
     .enum(['cost_basis'])
     .describe("Expands for currencies. Values: - `cost_basis`: The currency's active and scheduled cost basis.");
-export const featureLlmTokenType = z
-    .enum([
-    'input',
-    'output',
-    'cache_read',
-    'cache_write',
-    'reasoning',
-    'request',
-    'response',
-])
-    .describe('Token type for LLM cost lookup.');
 export const llmCostProvider = z
     .object({
     id: z
@@ -962,12 +979,12 @@ export const invoiceLineType = z
 export const priceType = z
     .enum(['free', 'flat', 'unit', 'graduated', 'volume'])
     .describe("The type of the price. - `free`: No charge, the rate card is included at no cost. - `flat`: A fixed amount charged once per billing period, regardless of usage. - `unit`: A fixed rate charged per billing unit consumed. - `graduated`: Tiered pricing where each tier's rate applies only to usage within that tier. - `volume`: Tiered pricing where the rate for the highest tier reached applies to all units in the period.");
-export const collectionAlignment = z
-    .enum(['subscription', 'anchored'])
-    .describe('BillingCollectionAlignment specifies when the pending line items should be collected into an invoice.');
 export const collectionMethod = z
     .enum(['charge_automatically', 'send_invoice'])
     .describe('Collection method specifies how the invoice should be collected (automatic or manual).');
+export const collectionAlignment = z
+    .enum(['subscription', 'anchored'])
+    .describe('BillingCollectionAlignment specifies when the pending line items should be collected into an invoice.');
 export const featureUnitCostType = z
     .enum(['llm', 'manual'])
     .describe('The type of unit cost.');
@@ -1098,18 +1115,24 @@ export const createCurrencyCustomRequest = z
     code: currencyCodeCustom,
 })
     .describe('CurrencyCustom create request.');
-export const currencyAmount = z
-    .object({
-    amount: numeric,
-    currency: currencyCode,
-})
-    .describe('Monetary amount in a specific currency.');
 export const priceFlat = z
     .object({
     type: z.literal('flat').describe('The type of the price.'),
     amount: numeric,
 })
     .describe('Flat price.');
+export const priceUnit = z
+    .object({
+    type: z.literal('unit').describe('The type of the price.'),
+    amount: numeric,
+})
+    .describe('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 const spendCommitments = z
+    .object({
+    minimumAmount: numeric.optional(),
+    maximumAmount: numeric.optional(),
+})
+    .describe('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 const rateCardDiscounts = z
     .object({
     percentage: z
@@ -1133,18 +1156,57 @@ export const totals = z
     total: numeric,
 })
     .describe('Totals contains the summaries of all calculations for a billing resource.');
-export const priceUnit = z
+export const chargeRealizationDetailedLineCreditApplied = z
+    .object({
+    amount: numeric,
+    description: z
+        .string()
+        .optional()
+        .describe('Human-readable description of the credit allocation.'),
+    creditRealizationId: z
+        .string()
+        .describe('The ID of the credit realization (allocation) this credit was applied from.'),
+})
+    .describe('A credit allocation applied to a charge realization detailed line.');
+export const chargeRealizationAmountDiscount = z
+    .object({
+    amount: numeric,
+    reason: z
+        .string()
+        .describe('The reason for the discount applied to the charge.'),
+    description: z
+        .string()
+        .optional()
+        .describe('Optional human-readable description of the discount.'),
+    roundingAmount: numeric.optional(),
+    childUniqueReferenceId: z
+        .string()
+        .describe('Unique reference ID of the discount applied to the charge.'),
+})
+    .describe('A discount applied to a charge realization detailed line.');
+export const featureManualUnitCost = z
     .object({
-    type: z.literal('unit').describe('The type of the price.'),
+    type: z
+        .literal('manual')
+        .describe('The type discriminator for manual unit cost.'),
     amount: numeric,
 })
-    .describe('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 const spendCommitments = z
+    .describe('A fixed per-unit cost amount.');
+export const featureLlmUnitCostPricing = z
     .object({
-    minimumAmount: numeric.optional(),
-    maximumAmount: numeric.optional(),
+    inputPerToken: numeric,
+    outputPerToken: numeric,
+    cacheReadPerToken: numeric.optional(),
+    reasoningPerToken: numeric.optional(),
+    cacheWritePerToken: numeric.optional(),
 })
-    .describe('Spend commitments for a usage-based price. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
+    .describe('Resolved per-token pricing from the LLM cost database.');
+export const currencyAmount = z
+    .object({
+    amount: numeric,
+    currency: currencyCode,
+})
+    .describe('Monetary amount in a specific currency.');
 export const invoiceLineCreditsApplied = z
     .object({
     amount: numeric,
@@ -1187,23 +1249,6 @@ export const updateDiscounts = z
     usage: numeric.optional(),
 })
     .describe('Discount configuration for a rate card.');
-export const featureManualUnitCost = z
-    .object({
-    type: z
-        .literal('manual')
-        .describe('The type discriminator for manual unit cost.'),
-    amount: numeric,
-})
-    .describe('A fixed per-unit cost amount.');
-export const featureLlmUnitCostPricing = z
-    .object({
-    inputPerToken: numeric,
-    outputPerToken: numeric,
-    cacheReadPerToken: numeric.optional(),
-    reasoningPerToken: numeric.optional(),
-    cacheWritePerToken: numeric.optional(),
-})
-    .describe('Resolved per-token pricing from the LLM cost database.');
 export const llmCostModelPricing = z
     .object({
     inputPerToken: numeric,
@@ -1304,14 +1349,25 @@ export const creditGrantInvoiceReference = z
         .describe('Identifier of the invoice line associated with the grant.'),
 })
     .describe('Invoice references for the grant.');
-export const billingCustomerReference = z
+export const subscriptionCostBasisPin = z
+    .object({
+    customCurrencyId: ulid,
+    invoiceCurrency: currencyCode,
+    costBasisId: ulid,
+})
+    .describe('A cost basis pinned to a custom-currency pair for the subscription.');
+export const featureReference = z
     .object({
     id: ulid,
 })
-    .describe('Customer reference.');
+    .describe('Feature reference.');
 export const subscriptionReference = z
     .object({
     id: ulid,
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the subscription. Only populated where the referencing endpoint documents a `subscription` expand that resolves it.'),
     phase: z
         .object({
         id: ulid,
@@ -1324,28 +1380,21 @@ export const subscriptionReference = z
         .describe('The phase of the subscription.'),
 })
     .describe('Subscription reference represents a reference to the specific subscription item this entity represents.');
-export const subscriptionCostBasisPin = z
+export const appReference = z
     .object({
-    customCurrencyId: ulid,
-    invoiceCurrency: currencyCode,
-    costBasisId: ulid,
+    id: ulid,
 })
-    .describe('A cost basis pinned to a custom-currency pair for the subscription.');
-export const featureReference = z
+    .describe('App reference.');
+export const chargeRealizationInvoiceReference = z
     .object({
     id: ulid,
 })
-    .describe('Feature reference.');
+    .describe('ChargeRealizationInvoice reference.');
 export const addonReference = z
     .object({
     id: ulid,
 })
     .describe('Addon reference.');
-export const appReference = z
-    .object({
-    id: ulid,
-})
-    .describe('App reference.');
 export const chargeReference = z
     .object({
     id: ulid,
@@ -1356,6 +1405,28 @@ export const updateResourceReference = z
     id: ulid,
 })
     .describe('TaxCode reference.');
+export const billingCustomerReference = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the customer. Only populated where the referencing endpoint documents a `customer` expand that resolves it.'),
+})
+    .describe('Customer reference.');
+export const chargeFeature = z
+    .object({
+    id: ulid,
+    key: z
+        .string()
+        .optional()
+        .describe('The key of the feature. Requires the `feature` expand.'),
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the feature. Requires the `feature` expand.'),
+})
+    .describe('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 const dateTimeFieldFilter = z
     .union([
     dateTime,
@@ -2041,11 +2112,6 @@ export const getCreditBalanceParamsFilter = z
     featureKey: stringFieldFilter.optional(),
 })
     .describe('Filter options for getting a credit balance.');
-export const listChargesParamsFilter = z
-    .object({
-    status: stringFieldFilterExact.optional(),
-})
-    .describe('Filter options for listing charges.');
 export const listPlansParamsFilter = z
     .object({
     key: stringFieldFilter.optional(),
@@ -2061,34 +2127,17 @@ export const voidCreditGrantRequest = z
         .default('none'),
 })
     .describe('Request body for voiding a credit grant.');
-export const rateCardProrationConfiguration = z
-    .object({
-    mode: rateCardProrationMode,
-})
-    .describe('The proration configuration of the rate card.');
 export const subscriptionProRatingConfig = z
     .object({
     enabled: z.boolean().describe('Whether pro-rating is enabled.'),
     mode: rateCardProrationMode,
 })
     .describe('The pro-rating configuration of a subscription.');
-export const unitConfig = z
+export const rateCardProrationConfiguration = z
     .object({
-    operation: unitConfigOperation,
-    conversionFactor: numeric,
-    rounding: unitConfigRoundingMode.optional().default('none'),
-    precision: z
-        .number()
-        .int()
-        .optional()
-        .default(0)
-        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
-    displayUnit: z
-        .string()
-        .optional()
-        .describe('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.'),
+    mode: rateCardProrationMode,
 })
-    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
+    .describe('The proration configuration of the rate card.');
 export const subscriptionCreate = z
     .object({
     labels: labels.optional(),
@@ -2114,6 +2163,68 @@ export const subscriptionCreate = z
     costBasisMode: subscriptionCostBasisMode.optional().default('dynamic'),
 })
     .describe('Subscription create request.');
+export const unitConfig = z
+    .object({
+    operation: unitConfigOperation,
+    conversionFactor: numeric,
+    rounding: unitConfigRoundingMode.optional().default('none'),
+    precision: z
+        .number()
+        .int()
+        .optional()
+        .default(0)
+        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
+    displayUnit: z
+        .string()
+        .optional()
+        .describe('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.'),
+})
+    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
+export const partyTaxIdentity = z
+    .object({
+    code: taxIdentificationCode.optional(),
+})
+    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
+export const updateBillingPartyTaxIdentity = z
+    .object({
+    code: taxIdentificationCode.optional(),
+})
+    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
+export const invoiceValidationIssue = z
+    .object({
+    code: z.string().describe('Machine-readable error code.'),
+    message: z.string().describe('Human-readable description of the error.'),
+    attributes: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Additional structured context.'),
+    severity: invoiceValidationIssueSeverity,
+    field: z
+        .string()
+        .optional()
+        .describe('JSON path to the field that caused this validation issue, if applicable. For example: `lines/0/rate_card/price`.'),
+})
+    .describe('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 const invoiceAvailableActions = z
+    .object({
+    advance: invoiceAvailableActionDetails.optional(),
+    approve: invoiceAvailableActionDetails.optional(),
+    delete: invoiceAvailableActionDetails.optional(),
+    retry: invoiceAvailableActionDetails.optional(),
+    snapshotQuantities: invoiceAvailableActionDetails.optional(),
+})
+    .describe('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 const workflowPaymentSettings = z
+    .discriminatedUnion('collectionMethod', [
+    workflowPaymentChargeAutomaticallySettings,
+    workflowPaymentSendInvoiceSettings,
+])
+    .describe('Payment settings for a billing workflow.');
+export const chargeRealizationPayment = z
+    .object({
+    status: chargeRealizationPaymentStatus,
+})
+    .describe('Payment state of a charge realization.');
 export const subscriptionEditTiming = z
     .union([subscriptionEditTimingEnum, dateTime])
     .describe('Subscription edit timing defined when the changes should take effect. If the provided configuration is not supported by the subscription, an error will be returned.');
@@ -2196,16 +2307,6 @@ export const installAppRequest = z
     installAppExternalInvoicing,
 ])
     .describe('Request to install an app from the catalog.');
-export const partyTaxIdentity = z
-    .object({
-    code: taxIdentificationCode.optional(),
-})
-    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
-export const updateBillingPartyTaxIdentity = z
-    .object({
-    code: taxIdentificationCode.optional(),
-})
-    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
 export const workflowInvoicingSettings = z
     .object({
     autoAdvance: z
@@ -2228,36 +2329,6 @@ export const workflowInvoicingSettings = z
         .default('bill_actual_period'),
 })
     .describe('Invoice settings for a billing workflow.');
-export const workflowPaymentSettings = z
-    .discriminatedUnion('collectionMethod', [
-    workflowPaymentChargeAutomaticallySettings,
-    workflowPaymentSendInvoiceSettings,
-])
-    .describe('Payment settings for a billing workflow.');
-export const invoiceValidationIssue = z
-    .object({
-    code: z.string().describe('Machine-readable error code.'),
-    message: z.string().describe('Human-readable description of the error.'),
-    attributes: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe('Additional structured context.'),
-    severity: invoiceValidationIssueSeverity,
-    field: z
-        .string()
-        .optional()
-        .describe('JSON path to the field that caused this validation issue, if applicable. For example: `lines/0/rate_card/price`.'),
-})
-    .describe('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 const invoiceAvailableActions = z
-    .object({
-    advance: invoiceAvailableActionDetails.optional(),
-    approve: invoiceAvailableActionDetails.optional(),
-    delete: invoiceAvailableActionDetails.optional(),
-    retry: invoiceAvailableActionDetails.optional(),
-    snapshotQuantities: invoiceAvailableActionDetails.optional(),
-})
-    .describe('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 const invoiceLineAmountDiscount = z
     .object({
     id: ulid,
@@ -2426,12 +2497,6 @@ export const creditTransaction = z
         .describe('The available balance before and after the transaction.'),
 })
     .describe("A credit transaction represents a single credit movement on the customer's balance. Credit transactions are immutable.");
-export const chargeTotals = z
-    .object({
-    booked: totals,
-    realtime: totals.optional(),
-})
-    .describe('The totals of a charge. RealTime is only expanded when the `real_time_usage` expand is used.');
 export const priceTier = z
     .object({
     upToAmount: numeric.optional(),
@@ -2439,13 +2504,12 @@ export const priceTier = z
     unitPrice: priceUnit.optional(),
 })
     .describe('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 const updatePriceTier = z
+export const chargeTotals = z
     .object({
-    upToAmount: numeric.optional(),
-    flatPrice: updatePriceFlat.optional(),
-    unitPrice: updatePriceUnit.optional(),
+    booked: totals,
+    realtime: totals.optional(),
 })
-    .describe('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.');
+    .describe('The totals of a charge. `realtime` is only populated when the `real_time_usage` expand is used.');
 export const featureLlmUnitCost = z
     .object({
     type: z
@@ -2475,6 +2539,13 @@ export const featureLlmUnitCost = z
     pricing: featureLlmUnitCostPricing.optional(),
 })
     .describe('LLM cost lookup configuration. Each dimension (provider, model, token type) can be specified as either a static value or a meter group-by property name (mutually exclusive).');
+export const updatePriceTier = z
+    .object({
+    upToAmount: numeric.optional(),
+    flatPrice: updatePriceFlat.optional(),
+    unitPrice: updatePriceUnit.optional(),
+})
+    .describe('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 const llmCostPrice = z
     .object({
     id: ulid,
@@ -2557,6 +2628,12 @@ export const creditGrantTaxConfig = z
     taxCode: taxCodeReference.optional(),
 })
     .describe('Tax configuration for a credit grant. Tax configuration should be provided to ensure correct revenue recognition, including for externally funded grants.');
+export const rateCardTaxConfig = z
+    .object({
+    behavior: taxBehavior.optional(),
+    code: taxCodeReference,
+})
+    .describe('The tax config of the rate card.');
 export const taxConfig = z
     .object({
     behavior: taxBehavior.optional(),
@@ -2566,12 +2643,6 @@ export const taxConfig = z
     taxCode: taxCodeReference.optional(),
 })
     .describe('Set of provider specific tax configs.');
-export const rateCardTaxConfig = z
-    .object({
-    behavior: taxBehavior.optional(),
-    code: taxCodeReference,
-})
-    .describe('The tax config of the rate card.');
 export const organizationDefaultTaxCodes = z
     .object({
     invoicingTaxCode: taxCodeReference,
@@ -2579,13 +2650,27 @@ export const organizationDefaultTaxCodes = z
     createdAt: dateTime,
     updatedAt: dateTime,
 })
-    .describe('Organization-level default tax code references. Stores the default tax codes applied to specific billing contexts for this organization. Provisioned automatically when the organization is created.');
-export const updateOrganizationDefaultTaxCodesRequest = z
+    .describe('Organization-level default tax code references. Stores the default tax codes applied to specific billing contexts for this organization. Provisioned automatically when the organization is created.');
+export const updateOrganizationDefaultTaxCodesRequest = z
+    .object({
+    invoicingTaxCode: taxCodeReference.optional(),
+    creditGrantTaxCode: taxCodeReference.optional(),
+})
+    .describe('OrganizationDefaultTaxCodes update request.');
+export const invoiceWorkflowAppsReferences = z
+    .object({
+    tax: appReference,
+    invoicing: appReference,
+    payment: appReference,
+})
+    .describe('BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps used by a billing profile');
+export const profileAppReferences = z
     .object({
-    invoicingTaxCode: taxCodeReference.optional(),
-    creditGrantTaxCode: taxCodeReference.optional(),
+    tax: appReference,
+    invoicing: appReference,
+    payment: appReference,
 })
-    .describe('OrganizationDefaultTaxCodes update request.');
+    .describe('References to the applications used by a billing profile.');
 export const planAddon = z
     .object({
     id: ulid,
@@ -2640,20 +2725,6 @@ export const createPlanAddonRequest = z
         .describe('The maximum number of times the add-on can be purchased for the plan. For single-instance add-ons this field must be omitted. For multi-instance add-ons when omitted, unlimited quantity can be purchased.'),
 })
     .describe('PlanAddon create request.');
-export const profileAppReferences = z
-    .object({
-    tax: appReference,
-    invoicing: appReference,
-    payment: appReference,
-})
-    .describe('References to the applications used by a billing profile.');
-export const invoiceWorkflowAppsReferences = z
-    .object({
-    tax: appReference,
-    invoicing: appReference,
-    payment: appReference,
-})
-    .describe('BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps used by a billing profile');
 export const updateRateCardTaxConfig = z
     .object({
     behavior: taxBehavior.optional(),
@@ -2672,6 +2743,15 @@ export const listEventsParamsFilter = z
     storedAt: dateTimeFieldFilter.optional(),
 })
     .describe('Filter options for listing ingested events.');
+export const listChargesParamsFilter = z
+    .object({
+    status: stringFieldFilterExact.optional(),
+    featureId: ulidFieldFilter.optional(),
+    featureKey: stringFieldFilterExact.optional(),
+    servicePeriodFrom: dateTimeFieldFilter.optional(),
+    servicePeriodTo: dateTimeFieldFilter.optional(),
+})
+    .describe('Filter options for listing charges.');
 export const listInvoicesParamsFilter = z
     .object({
     status: stringFieldFilterExact.optional(),
@@ -2723,6 +2803,55 @@ export const meterQueryResult = z
         .describe('The usage data. If no data is available, an empty array is returned.'),
 })
     .describe('Meter query result.');
+export const chargeRealizationDetailedLineFlatFee = z
+    .object({
+    id: ulid,
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('flat_fee')
+        .describe('The type of the charge the realization belongs to.'),
+    servicePeriod: closedPeriod,
+    totals: totals,
+    category: chargeRealizationDetailedLineCategory,
+    creditsApplied: z
+        .array(chargeRealizationDetailedLineCreditApplied)
+        .optional()
+        .describe('Credits applied to this detailed line.'),
+    unitPrice: numeric,
+    amountDiscounts: z
+        .array(chargeRealizationAmountDiscount)
+        .describe('The amount discounts applied to the detailed line.'),
+})
+    .describe("A detailed line produced by a flat fee charge's realization run.");
+export const chargeRealizationDetailedLineUsageBased = z
+    .object({
+    id: ulid,
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z
+        .literal('usage_based')
+        .describe('The type of the charge the realization belongs to.'),
+    servicePeriod: closedPeriod,
+    totals: totals,
+    category: chargeRealizationDetailedLineCategory,
+    creditsApplied: z
+        .array(chargeRealizationDetailedLineCreditApplied)
+        .optional()
+        .describe('Credits applied to this detailed line.'),
+    unitPrice: numeric,
+    amountDiscounts: z
+        .array(chargeRealizationAmountDiscount)
+        .describe('The amount discounts applied to the detailed line.'),
+    quantity: numeric,
+    correctsRunId: z
+        .string()
+        .optional()
+        .describe("The ID of a prior realization run this detailed line corrects. Only set if the detailed line's totals are negative."),
+})
+    .describe("A detailed line produced by a usage-based charge's realization run.");
 export const currencyCustom = z
     .object({
     type: z.literal('custom').describe('The type of the currency.'),
@@ -2965,6 +3094,24 @@ export const chargeFlatFeeSystemIntent = z
     deletedAt: dateTime.optional(),
 })
     .describe('Flat fee intent fields from the system lifecycle controller shadowed by a manual override.');
+export const invoiceStatusDetails = z
+    .object({
+    immutable: z
+        .boolean()
+        .describe('Whether the invoice is immutable (i.e. cannot be modified or deleted).'),
+    failed: z.boolean().describe('Whether the invoice is in a failed state.'),
+    extendedStatus: z
+        .string()
+        .describe('Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.'),
+    availableActions: invoiceAvailableActions,
+})
+    .describe('Detailed status information for a standard invoice.');
+export const invoiceWorkflow = z
+    .object({
+    invoicing: invoiceWorkflowInvoicingSettings.optional(),
+    payment: workflowPaymentSettings.optional(),
+})
+    .describe('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 const subscriptionCancel = z
     .object({
     timing: subscriptionEditTiming.optional().default('immediate'),
@@ -3086,24 +3233,6 @@ export const updateAppRequest = z
     updateAppExternalInvoicingRequest,
 ])
     .describe('Request to update an installed app.');
-export const invoiceWorkflow = z
-    .object({
-    invoicing: invoiceWorkflowInvoicingSettings.optional(),
-    payment: workflowPaymentSettings.optional(),
-})
-    .describe('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 const invoiceStatusDetails = z
-    .object({
-    immutable: z
-        .boolean()
-        .describe('Whether the invoice is immutable (i.e. cannot be modified or deleted).'),
-    failed: z.boolean().describe('Whether the invoice is in a failed state.'),
-    extendedStatus: z
-        .string()
-        .describe('Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.'),
-    availableActions: invoiceAvailableActions,
-})
-    .describe('Detailed status information for a standard invoice.');
 export const invoiceLineDiscounts = z
     .object({
     amount: z
@@ -3172,6 +3301,9 @@ export const priceVolume = z
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
     .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
+export const featureUnitCost = z
+    .discriminatedUnion('type', [featureManualUnitCost, featureLlmUnitCost])
+    .describe('Per-unit cost configuration for a feature. Either a fixed manual amount or a dynamic LLM cost lookup.');
 export const updatePriceGraduated = z
     .object({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -3190,9 +3322,6 @@ export const updatePriceVolume = z
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
     .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
-export const featureUnitCost = z
-    .discriminatedUnion('type', [featureManualUnitCost, featureLlmUnitCost])
-    .describe('Per-unit cost configuration for a feature. Either a fixed manual amount or a dynamic LLM cost lookup.');
 export const pricePagePaginatedResponse = z
     .object({
     data: z.array(llmCostPrice),
@@ -3295,12 +3424,9 @@ export const createChargeFlatFeeRequest = z
     taxConfig: taxConfig.optional(),
     paymentTerm: pricePaymentTerm,
     discounts: chargeFlatFeeDiscounts.optional(),
-    featureId: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
     prorationConfiguration: rateCardProrationConfiguration,
     amountBeforeProration: currencyAmount,
+    feature: featureReference.optional(),
     fullServicePeriod: closedPeriod.optional(),
     billingPeriod: closedPeriod.optional(),
 })
@@ -3332,6 +3458,12 @@ export const ingestedEventPaginatedResponse = z
     meta: cursorMeta,
 })
     .describe('Cursor paginated response.');
+export const chargeRealizationDetailedLine = z
+    .discriminatedUnion('type', [
+    chargeRealizationDetailedLineFlatFee,
+    chargeRealizationDetailedLineUsageBased,
+])
+    .describe("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 const currency = z
     .discriminatedUnion('type', [currencyFiat, currencyCustom])
     .describe('Fiat or custom currency.');
@@ -3363,29 +3495,32 @@ export const customerPagePaginatedResponse = z
     meta: paginatedMeta,
 })
     .describe('Page paginated response.');
-export const party = z
+export const customerOrReference = z
+    .union([customer, customerReference])
+    .describe('Customer or reference.');
+export const supplier = z
     .object({
-    id: z.string().optional().describe('Unique identifier for the party.'),
-    key: externalResourceKey.optional(),
     name: z
         .string()
         .optional()
         .describe('Legal name or representation of the party.'),
     taxId: partyTaxIdentity.optional(),
     addresses: partyAddresses.optional(),
+    id: z.string().optional().describe('Unique identifier for the party.'),
 })
-    .describe('Party represents a person or business entity.');
-export const supplier = z
+    .describe("Snapshot of the supplier's information at the time the invoice was issued. Structurally a read-only subset of `BillingParty` (the type configured on the billing profile), so the snapshot stays aligned with the source. `key` is omitted because it is not part of the snapshotted supplier data.");
+export const party = z
     .object({
+    id: z.string().optional().describe('Unique identifier for the party.'),
+    key: externalResourceKey.optional(),
     name: z
         .string()
         .optional()
         .describe('Legal name or representation of the party.'),
     taxId: partyTaxIdentity.optional(),
     addresses: partyAddresses.optional(),
-    id: z.string().optional().describe('Unique identifier for the party.'),
 })
-    .describe("Snapshot of the supplier's information at the time the invoice was issued. Structurally a read-only subset of `BillingParty` (the type configured on the billing profile), so the snapshot stays aligned with the source. `key` is omitted because it is not part of the snapshotted supplier data.");
+    .describe('Party represents a person or business entity.');
 export const updateSupplier = z
     .object({
     name: z
@@ -3451,56 +3586,13 @@ export const workflowCollectionAlignment = z
     workflowCollectionAlignmentAnchored,
 ])
     .describe('The alignment for collecting the pending line items into an invoice. Defaults to subscription, which means that we are to create a new invoice every time the a subscription period starts (for in advance items) or ends (for in arrears items).');
-export const chargeFlatFee = z
+export const invoiceWorkflowSettings = z
     .object({
-    id: ulid,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labels.optional(),
-    createdAt: dateTime,
-    updatedAt: dateTime,
-    deletedAt: dateTime.optional(),
-    type: z.literal('flat_fee').describe('The type of the charge.'),
-    customer: billingCustomerReference,
-    lifecycleController: lifecycleController,
-    subscription: subscriptionReference.optional(),
-    currency: currencyCode,
-    status: chargeStatus,
-    invoiceAt: dateTime,
-    servicePeriod: closedPeriod,
-    fullServicePeriod: closedPeriod,
-    billingPeriod: closedPeriod,
-    advanceAfter: dateTime.optional(),
-    uniqueReferenceId: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlementMode: settlementMode,
-    taxConfig: taxConfig.optional(),
-    paymentTerm: pricePaymentTerm,
-    discounts: chargeFlatFeeDiscounts.optional(),
-    featureKey: z
-        .string()
-        .optional()
-        .describe('The feature associated with the charge, when applicable.'),
-    featureId: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
-    prorationConfiguration: rateCardProrationConfiguration,
-    amountAfterProration: currencyAmount,
-    price: priceFlat,
-    systemIntent: chargeFlatFeeSystemIntent.optional(),
+    apps: invoiceWorkflowAppsReferences.optional(),
+    sourceBillingProfile: profileReference,
+    workflow: invoiceWorkflow,
 })
-    .describe('A flat fee charge for a customer.');
+    .describe('Snapshot of the billing workflow configuration captured at invoice creation.');
 export const taxCodePagePaginatedResponse = z
     .object({
     data: z.array(taxCode),
@@ -3684,13 +3776,6 @@ export const installedAppExternalInvoicing = z
         .describe('Default capabilities of the installed app.'),
 })
     .describe('Response of an installed app.');
-export const invoiceWorkflowSettings = z
-    .object({
-    apps: invoiceWorkflowAppsReferences.optional(),
-    sourceBillingProfile: profileReference,
-    workflow: invoiceWorkflow,
-})
-    .describe('Snapshot of the billing workflow configuration captured at invoice creation.');
 export const invoiceDetailedLine = z
     .object({
     id: ulid,
@@ -3738,9 +3823,6 @@ export const entitlementAccessQueryResult = z
     updatedAt: dateTime,
 })
     .describe('Access evaluation result for a single resolved customer.');
-export const priceUsageBased = z
-    .discriminatedUnion('type', [priceUnit, priceGraduated, priceVolume])
-    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const price = z
     .discriminatedUnion('type', [
     priceFree,
@@ -3750,15 +3832,9 @@ export const price = z
     priceVolume,
 ])
     .describe('Price.');
-export const updatePrice = z
-    .discriminatedUnion('type', [
-    updatePriceFree,
-    updatePriceFlat,
-    updatePriceUnit,
-    updatePriceGraduated,
-    updatePriceVolume,
-])
-    .describe('Price.');
+export const priceUsageBased = z
+    .discriminatedUnion('type', [priceUnit, priceGraduated, priceVolume])
+    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const feature = z
     .object({
     id: ulid,
@@ -3807,6 +3883,15 @@ export const updateFeatureRequest = z
         .describe('Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties. Set to `null` to clear the existing unit cost; omit to leave it unchanged.'),
 })
     .describe('Request body for updating a feature. Currently only the unit_cost field can be updated.');
+export const updatePrice = z
+    .discriminatedUnion('type', [
+    updatePriceFree,
+    updatePriceFlat,
+    updatePriceUnit,
+    updatePriceGraduated,
+    updatePriceVolume,
+])
+    .describe('Price.');
 export const creditGrantPagePaginatedResponse = z
     .object({
     data: z.array(creditGrant),
@@ -3866,6 +3951,42 @@ export const workflowCollectionSettings = z
         .describe('This grace period can be used to delay the collection of the pending line items specified in alignment. This is useful, in case of multiple subscriptions having slightly different billing periods.'),
 })
     .describe('Workflow collection specifies how to collect the pending line items for an invoice.');
+export const chargeRealizationInvoice = z
+    .object({
+    id: ulid,
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    number: invoiceNumber,
+    currency: currencyCode,
+    supplier: supplier,
+    totals: totals,
+    servicePeriod: closedPeriod,
+    validationIssues: z
+        .array(invoiceValidationIssue)
+        .optional()
+        .describe('Validation issues found during invoice processing. Present only when there are one or more validation findings. An empty list is omitted.'),
+    externalReferences: invoiceExternalReferences.optional(),
+    type: z
+        .literal('standard')
+        .describe('Discriminator field identifying this as a standard invoice.'),
+    status: invoiceStandardStatus,
+    statusDetails: invoiceStatusDetails,
+    issuedAt: dateTime.optional(),
+    draftUntil: dateTime.optional(),
+    quantitySnapshottedAt: dateTime.optional(),
+    collectionAt: dateTime.optional(),
+    dueAt: dateTime.optional(),
+    sentToCustomerAt: dateTime.optional(),
+    workflow: invoiceWorkflowSettings,
+})
+    .describe('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 const app = z
     .discriminatedUnion('type', [appStripe, appSandbox, appExternalInvoicing])
     .describe('Installed application.');
@@ -3878,15 +3999,50 @@ export const billingInstallAppResponse = z
     .describe('Response of the app install.');
 export const entitlementAccessQueryResponse = z
     .object({
-    data: z
-        .array(entitlementAccessQueryResult)
-        .describe('Access evaluation results, one entry per resolved customer.'),
-    errors: z
-        .array(entitlementAccessQueryError)
-        .describe('Partial errors encountered while processing the request.'),
-    meta: cursorMeta,
+    data: z
+        .array(entitlementAccessQueryResult)
+        .describe('Access evaluation results, one entry per resolved customer.'),
+    errors: z
+        .array(entitlementAccessQueryError)
+        .describe('Partial errors encountered while processing the request.'),
+    meta: cursorMeta,
+})
+    .describe('Response of the entitlement access query.');
+export const rateCard = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labels.optional(),
+    key: resourceKey,
+    feature: featureReference.optional(),
+    currency: billingCurrencyCode.optional(),
+    billingCadence: iso8601Duration.optional(),
+    price: price,
+    unitConfig: unitConfig.optional(),
+    paymentTerm: pricePaymentTerm.optional().default('in_arrears'),
+    commitments: spendCommitments.optional(),
+    discounts: rateCardDiscounts.optional(),
+    taxConfig: rateCardTaxConfig.optional(),
+    entitlement: rateCardEntitlement.optional(),
+})
+    .describe('A rate card defines the pricing and entitlement of a feature or service.');
+export const invoiceLineRateCard = z
+    .object({
+    price: price,
+    taxConfig: rateCardTaxConfig.optional(),
+    featureKey: resourceKey.optional(),
+    discounts: rateCardDiscounts.optional(),
+    unitConfig: unitConfig.optional(),
 })
-    .describe('Response of the entitlement access query.');
+    .describe('Rate card configuration snapshot for a usage-based invoice line.');
 export const chargeUsageBasedSystemIntent = z
     .object({
     name: z
@@ -3935,51 +4091,23 @@ export const createChargeUsageBasedRequest = z
     settlementMode: settlementMode,
     taxConfig: taxConfig.optional(),
     discounts: rateCardDiscounts.optional(),
-    featureId: z
-        .string()
-        .describe('The feature ID associated with the charge.'),
     price: priceUsageBased,
     commitments: spendCommitments.optional(),
     unitConfig: unitConfig.optional(),
+    feature: featureReference,
     fullServicePeriod: closedPeriod.optional(),
     billingPeriod: closedPeriod.optional(),
 })
     .describe('Usage-based charge create request.');
-export const rateCard = z
-    .object({
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labels.optional(),
-    key: resourceKey,
-    feature: featureReference.optional(),
-    currency: billingCurrencyCode.optional(),
-    billingCadence: iso8601Duration.optional(),
-    price: price,
-    unitConfig: unitConfig.optional(),
-    paymentTerm: pricePaymentTerm.optional().default('in_arrears'),
-    commitments: spendCommitments.optional(),
-    discounts: rateCardDiscounts.optional(),
-    taxConfig: rateCardTaxConfig.optional(),
-    entitlement: rateCardEntitlement.optional(),
-})
-    .describe('A rate card defines the pricing and entitlement of a feature or service.');
-export const invoiceLineRateCard = z
+export const featureOrReference = z
+    .union([feature, featureReference])
+    .describe('Feature or reference.');
+export const featurePagePaginatedResponse = z
     .object({
-    price: price,
-    taxConfig: rateCardTaxConfig.optional(),
-    featureKey: resourceKey.optional(),
-    discounts: rateCardDiscounts.optional(),
-    unitConfig: unitConfig.optional(),
+    data: z.array(feature),
+    meta: paginatedMeta,
 })
-    .describe('Rate card configuration snapshot for a usage-based invoice line.');
+    .describe('Page paginated response.');
 export const updateInvoiceLineRateCard = z
     .object({
     price: updatePrice,
@@ -3988,12 +4116,6 @@ export const updateInvoiceLineRateCard = z
     discounts: updateDiscounts.optional(),
 })
     .describe('Rate card configuration snapshot for a usage-based invoice line.');
-export const featurePagePaginatedResponse = z
-    .object({
-    data: z.array(feature),
-    meta: paginatedMeta,
-})
-    .describe('Page paginated response.');
 export const workflow = z
     .object({
     collection: workflowCollectionSettings.optional(),
@@ -4002,6 +4124,9 @@ export const workflow = z
     tax: workflowTaxSettings.optional(),
 })
     .describe('Billing workflow settings.');
+export const chargeRealizationInvoiceOrReference = z
+    .union([chargeRealizationInvoice, chargeRealizationInvoiceReference])
+    .describe('ChargeRealizationInvoice or reference.');
 export const appPagePaginatedResponse = z
     .object({
     data: z.array(app),
@@ -4015,58 +4140,6 @@ export const profileApps = z
     payment: app,
 })
     .describe('Applications used by a billing profile.');
-export const chargeUsageBased = z
-    .object({
-    id: ulid,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labels.optional(),
-    createdAt: dateTime,
-    updatedAt: dateTime,
-    deletedAt: dateTime.optional(),
-    type: z.literal('usage_based').describe('The type of the charge.'),
-    customer: billingCustomerReference,
-    lifecycleController: lifecycleController,
-    subscription: subscriptionReference.optional(),
-    currency: currencyCode,
-    status: chargeStatus,
-    invoiceAt: dateTime,
-    servicePeriod: closedPeriod,
-    fullServicePeriod: closedPeriod,
-    billingPeriod: closedPeriod,
-    advanceAfter: dateTime.optional(),
-    uniqueReferenceId: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlementMode: settlementMode,
-    taxConfig: taxConfig.optional(),
-    discounts: rateCardDiscounts.optional(),
-    featureKey: z.string().describe('The feature associated with the charge.'),
-    featureId: z
-        .string()
-        .describe('The feature ID associated with the charge.'),
-    totals: chargeTotals,
-    price: priceUsageBased,
-    commitments: spendCommitments.optional(),
-    unitConfig: unitConfig.optional(),
-    systemIntent: chargeUsageBasedSystemIntent.optional(),
-})
-    .describe('A usage-based charge for a customer.');
-export const createChargeRequest = z
-    .discriminatedUnion('type', [
-    createChargeFlatFeeRequest,
-    createChargeUsageBasedRequest,
-])
-    .describe('Customer charge.');
 export const subscriptionItem = z
     .object({
     id: ulid,
@@ -4211,6 +4284,12 @@ export const invoiceStandardLine = z
     charge: chargeReference.optional(),
 })
     .describe('A top-level line item on an invoice. Each line represents a single charge, typically associated with a rate card from a subscription. Detailed (child) lines are nested under `detailed_lines` when present.');
+export const createChargeRequest = z
+    .discriminatedUnion('type', [
+    createChargeFlatFeeRequest,
+    createChargeUsageBasedRequest,
+])
+    .describe('Customer charge.');
 export const updateInvoiceStandardLine = z
     .object({
     name: z
@@ -4292,9 +4371,28 @@ export const upsertBillingProfileRequest = z
     default: z.boolean().describe('Whether this is the default profile.'),
 })
     .describe('BillingProfile upsert request.');
-export const charge = z
-    .discriminatedUnion('type', [chargeFlatFee, chargeUsageBased])
-    .describe('Customer charge.');
+export const chargeRealization = z
+    .object({
+    id: z
+        .string()
+        .optional()
+        .describe('The ID of the realization run. Not present on `outstanding` entries, which are projections rather than persisted runs.'),
+    lineId: z
+        .string()
+        .optional()
+        .describe('The ID of the invoice line this realization was booked to, when the realization has been invoiced.'),
+    invoice: chargeRealizationInvoiceOrReference.optional(),
+    type: chargeRealizationType,
+    servicePeriod: closedPeriod,
+    usage: numeric.optional(),
+    payment: chargeRealizationPayment.optional(),
+    totals: totals.optional(),
+    detailedLines: z
+        .array(chargeRealizationDetailedLine)
+        .optional()
+        .describe('The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.'),
+})
+    .describe("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 const subscriptionPhase = z
     .object({
     id: ulid,
@@ -4468,12 +4566,6 @@ export const profilePagePaginatedResponse = z
     meta: paginatedMeta,
 })
     .describe('Page paginated response.');
-export const chargePagePaginatedResponse = z
-    .object({
-    data: z.array(charge),
-    meta: paginatedMeta,
-})
-    .describe('Page paginated response.');
 export const subscription = z
     .object({
     id: ulid,
@@ -4585,6 +4677,9 @@ export const updateInvoiceStandardRequest = z
         .describe('Line items on this invoice. Always returned on single-resource GET; omitted on list endpoints unless explicitly expanded. Editable via update: existing lines are matched by `id`, lines without an `id` are created, and lines present on the invoice but omitted from the update request are deleted. Detailed (child) lines are always computed and cannot be edited directly.'),
 })
     .describe('InvoiceStandard update request.');
+export const subscriptionOrReference = z
+    .union([subscription, subscriptionReference])
+    .describe('Subscription or reference.');
 export const subscriptionPagePaginatedResponse = z
     .object({
     data: z.array(subscription),
@@ -4603,12 +4698,114 @@ export const invoice = z
 export const updateInvoiceRequest = z
     .discriminatedUnion('type', [updateInvoiceStandardRequest])
     .describe('UpdateInvoiceRequest update request.');
+export const chargeFlatFee = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z.literal('flat_fee').describe('The type of the charge.'),
+    customer: customerOrReference,
+    lifecycleController: lifecycleController,
+    subscription: subscriptionOrReference.optional(),
+    currency: currencyCode,
+    status: chargeStatus,
+    invoiceAt: dateTime,
+    servicePeriod: closedPeriod,
+    fullServicePeriod: closedPeriod,
+    billingPeriod: closedPeriod,
+    advanceAfter: dateTime.optional(),
+    uniqueReferenceId: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlementMode: settlementMode,
+    taxConfig: taxConfig.optional(),
+    realizations: z
+        .array(chargeRealization)
+        .describe('The realization runs of the charge, sorted by `created_at`.'),
+    paymentTerm: pricePaymentTerm,
+    discounts: chargeFlatFeeDiscounts.optional(),
+    feature: featureOrReference.optional(),
+    prorationConfiguration: rateCardProrationConfiguration,
+    amountAfterProration: currencyAmount,
+    price: priceFlat,
+    systemIntent: chargeFlatFeeSystemIntent.optional(),
+})
+    .describe('A flat fee charge for a customer.');
+export const chargeUsageBased = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z.literal('usage_based').describe('The type of the charge.'),
+    customer: customerOrReference,
+    lifecycleController: lifecycleController,
+    subscription: subscriptionOrReference.optional(),
+    currency: currencyCode,
+    status: chargeStatus,
+    invoiceAt: dateTime,
+    servicePeriod: closedPeriod,
+    fullServicePeriod: closedPeriod,
+    billingPeriod: closedPeriod,
+    advanceAfter: dateTime.optional(),
+    uniqueReferenceId: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlementMode: settlementMode,
+    taxConfig: taxConfig.optional(),
+    realizations: z
+        .array(chargeRealization)
+        .describe('The realization runs of the charge, sorted by `created_at`.'),
+    discounts: rateCardDiscounts.optional(),
+    feature: featureOrReference,
+    totals: chargeTotals,
+    usage: numeric.optional(),
+    price: priceUsageBased,
+    commitments: spendCommitments.optional(),
+    unitConfig: unitConfig.optional(),
+    systemIntent: chargeUsageBasedSystemIntent.optional(),
+})
+    .describe('A usage-based charge for a customer.');
 export const invoicePagePaginatedResponse = z
     .object({
     data: z.array(invoice),
     meta: paginatedMeta,
 })
     .describe('Page paginated response.');
+export const charge = z
+    .discriminatedUnion('type', [chargeFlatFee, chargeUsageBased])
+    .describe('Customer charge.');
+export const chargePagePaginatedResponse = z
+    .object({
+    data: z.array(charge),
+    meta: paginatedMeta,
+})
+    .describe('Page paginated response.');
 export const listMeteringEventsQueryParams = z.object({
     page: cursorPaginationQueryPage.optional(),
     filter: listEventsParamsFilter.optional(),
@@ -4810,7 +5007,7 @@ export const listCustomerChargesQueryParams = z.object({
     expand: z
         .array(chargesExpand)
         .optional()
-        .describe("Expand full objects for referenced entities. Supported values are: - `real_time_usage`: Expand the charge's real-time usage."),
+        .describe("Expand full objects for referenced entities. Supported values are: - `real_time_usage`: Expand the charge's real-time usage; it sets the `usage` and the `totals.realtime` fields. - `customer`: Expand the charge's customer to the complete entity. - `feature`: Expand the charge's feature to the complete entity. - `subscription`: Expand the charge's subscription to the complete entity. - `realization.invoice`: Expand each realization's invoice to the complete entity. - `realization.totals`: Expand each realization run's `totals`. - `realization.detailed_lines`: Expand each realization run's `detailed_lines`."),
 });
 export const listCustomerChargesResponse = z.object({
     data: z.array(charge),
@@ -5749,17 +5946,63 @@ export const creditTransactionTypeWire = z
     .enum(['funded', 'consumed', 'expired', 'voided'])
     .describe('The type of the credit transaction. - `funded`: Credit granted and available for consumption. - `consumed`: Credit consumed by usage or fees. - `expired`: Credit removed because it expired before being used. - `voided`: Credit removed because the grant was voided before being used.');
 export const chargesExpandWire = z
-    .enum(['real_time_usage'])
-    .describe("Expands for customer charges. Values: - `real_time_usage`: The charge's real-time usage.");
+    .enum([
+    'real_time_usage',
+    'customer',
+    'feature',
+    'subscription',
+    'realization.invoice',
+    'realization.totals',
+    'realization.detailed_lines',
+])
+    .describe("Expands for customer charges. Values: - `real_time_usage`: The charge's real-time usage; it sets the `usage` and the `totals.realtime` fields, and fills the `outstanding` realization's `usage` with the not-yet-booked remainder of the live read. - `customer`: The complete customer entity of the charge. - `feature`: The complete feature entity of the charge. - `subscription`: The complete subscription of the charge, when present. - `realization.invoice`: The invoice header of each realization (the invoice entity without its `lines` and `customer` snapshot), in place of the ID reference. - `realization.totals`: The `totals` of each realization run, including credit allocations. - `realization.detailed_lines`: The `detailed_lines` of each realization run.");
 export const lifecycleControllerWire = z
     .enum(['system', 'manual'])
     .describe('Identifies whether a resource lifecycle is controlled by OpenMeter or manually overridden by the API user. Values: - `system`: The resource lifecycle is controlled by OpenMeter. - `manual`: The resource lifecycle was manually overridden by the API user.');
+export const subscriptionCostBasisModeWire = z
+    .enum(['dynamic', 'pinned'])
+    .describe('Controls how custom-currency cost bases are selected for the subscription.');
+export const rateCardProrationModeWire = z
+    .enum(['no_proration', 'prorate_prices'])
+    .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
+export const subscriptionStatusWire = z
+    .enum(['active', 'inactive', 'canceled', 'scheduled'])
+    .describe('Subscription status.');
+export const settlementModeWire = z
+    .enum(['credit_then_invoice', 'credit_only'])
+    .describe('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.');
+export const priceFreeWire = z
+    .strictObject({
+    type: z.literal('free').describe('The type of the price.'),
+})
+    .describe('Free price.');
+export const unitConfigOperationWire = z
+    .enum(['divide', 'multiply'])
+    .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
+export const unitConfigRoundingModeWire = z
+    .enum(['ceiling', 'floor', 'half_up', 'none'])
+    .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
+export const pricePaymentTermWire = z
+    .union([z.literal('in_advance'), z.literal('in_arrears')])
+    .describe('The payment term of a flat price.');
+export const rateCardStaticEntitlementWire = z
+    .strictObject({
+    type: z.literal('static').describe('The type of the entitlement template.'),
+    config: z
+        .unknown()
+        .describe('The entitlement config as a JSON object. Returned when checking entitlement access; useful for configuring fine-grained access settings implemented in your own system.'),
+})
+    .describe('The entitlement template of a static entitlement.');
+export const rateCardBooleanEntitlementWire = z
+    .strictObject({
+    type: z
+        .literal('boolean')
+        .describe('The type of the entitlement template.'),
+})
+    .describe('The entitlement template of a boolean entitlement.');
 export const chargeStatusWire = z
     .enum(['created', 'active', 'final', 'deleted'])
     .describe('Lifecycle status of a charge. Values: - `created`: The charge has been created but is not active yet. - `active`: The charge is active. - `final`: The charge is fully finalized and no further changes are expected. - `deleted`: The charge has been deleted.');
-export const settlementModeWire = z
-    .enum(['credit_then_invoice', 'credit_only'])
-    .describe('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.');
 export const taxConfigStripeWire = z
     .strictObject({
     code: z
@@ -5776,9 +6019,93 @@ export const taxConfigExternalInvoicingWire = z
         .describe('The tax code should be interpreted by the external invoicing provider.'),
 })
     .describe('External invoicing tax config.');
-export const pricePaymentTermWire = z
-    .union([z.literal('in_advance'), z.literal('in_arrears')])
-    .describe('The payment term of a flat price.');
+export const invoiceNumberWire = z
+    .string()
+    .min(1)
+    .max(256)
+    .describe('InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app. The uniqueness depends on a lot of factors: - app setting (unique per app or unique per customer) - multiple app scenarios (multiple apps generating invoices with the same prefix)');
+export const taxIdentificationCodeWire = z
+    .string()
+    .min(1)
+    .max(32)
+    .describe('Tax identifier code is a normalized tax code shown on the original identity document.');
+export const invoiceValidationIssueSeverityWire = z
+    .enum(['critical', 'warning'])
+    .describe('Severity level of an invoice validation issue.');
+export const invoiceExternalReferencesWire = z
+    .strictObject({
+    invoicing_id: z
+        .string()
+        .optional()
+        .describe('The ID assigned by the external invoicing app (e.g. Stripe invoice ID).'),
+    payment_id: z
+        .string()
+        .optional()
+        .describe('The ID assigned by the external payment app (e.g. Stripe payment intent ID).'),
+})
+    .describe('External identifiers assigned to an invoice by third-party systems.');
+export const invoiceStandardStatusWire = z
+    .enum([
+    'draft',
+    'issuing',
+    'issued',
+    'payment_processing',
+    'overdue',
+    'paid',
+    'uncollectible',
+    'voided',
+])
+    .describe('Lifecycle status of a standard invoice.');
+export const invoiceAvailableActionDetailsWire = z
+    .strictObject({
+    resulting_state: z
+        .string()
+        .describe('The extended status the invoice will transition to after performing this action.'),
+})
+    .describe('Details about an available invoice action including the resulting state.');
+export const invoiceWorkflowInvoicingSettingsWire = z
+    .strictObject({
+    auto_advance: z
+        .boolean()
+        .optional()
+        .describe('Whether to automatically issue the invoice after the draft_period has passed.'),
+    draft_period: z
+        .string()
+        .optional()
+        .describe('The period for the invoice to be kept in draft status for manual reviews.'),
+    due_after: z
+        .string()
+        .optional()
+        .describe('The period after which the invoice is considered overdue if not paid.'),
+})
+    .describe('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 const workflowPaymentChargeAutomaticallySettingsWire = z
+    .strictObject({
+    collection_method: z
+        .literal('charge_automatically')
+        .describe('The collection method for the invoice.'),
+})
+    .describe('Payment settings for a billing workflow when the collection method is charge automatically.');
+export const workflowPaymentSendInvoiceSettingsWire = z
+    .strictObject({
+    collection_method: z
+        .literal('send_invoice')
+        .describe('The collection method for the invoice.'),
+    due_after: z
+        .string()
+        .optional()
+        .describe("The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method."),
+})
+    .describe('Payment settings for a billing workflow when the collection method is send invoice.');
+export const chargeRealizationTypeWire = z
+    .enum(['final_realization', 'partial_invoice', 'outstanding', 'voided'])
+    .describe("Type of a charge realization run. Values: - `final_realization`: The run is the final realization of the charge for its service period; no further runs are expected to correct it. - `partial_invoice`: The run only realizes part of the charge, because the remainder is not yet due to be invoiced. - `outstanding`: The type an outstanding (not-yet-realized) projection would carry if it were realized now. Never returned on a booked realization run. - `voided`: The run's billing effect was undone (for example the charge's service period was extended while its invoice was still mutable); it is retained as audit history and excluded from aggregate and live calculations.");
+export const chargeRealizationPaymentStatusWire = z
+    .enum(['authorized', 'settled'])
+    .describe("Settlement status of a charge realization's payment. Values: - `authorized`: The payment has been authorized against the customer's ledger but has not settled yet. - `settled`: The payment has settled.");
+export const chargeRealizationDetailedLineCategoryWire = z
+    .enum(['regular', 'commitment'])
+    .describe('Cost category of a charge realization detailed line. Values: - `regular`: A regular charge line, based on usage or subscription pricing. - `commitment`: A commitment-derived line, such as minimum spend.');
 export const chargeFlatFeeDiscountsWire = z
     .strictObject({
     percentage: z
@@ -5789,41 +6116,17 @@ export const chargeFlatFeeDiscountsWire = z
         .describe('Percentage discount applied to the price (0–100).'),
 })
     .describe('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 const rateCardProrationModeWire = z
-    .enum(['no_proration', 'prorate_prices'])
-    .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
-export const unitConfigOperationWire = z
-    .enum(['divide', 'multiply'])
-    .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
-export const unitConfigRoundingModeWire = z
-    .enum(['ceiling', 'floor', 'half_up', 'none'])
-    .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
-export const subscriptionCostBasisModeWire = z
-    .enum(['dynamic', 'pinned'])
-    .describe('Controls how custom-currency cost bases are selected for the subscription.');
-export const subscriptionStatusWire = z
-    .enum(['active', 'inactive', 'canceled', 'scheduled'])
-    .describe('Subscription status.');
-export const priceFreeWire = z
-    .strictObject({
-    type: z.literal('free').describe('The type of the price.'),
-})
-    .describe('Free price.');
-export const rateCardStaticEntitlementWire = z
-    .strictObject({
-    type: z.literal('static').describe('The type of the entitlement template.'),
-    config: z
-        .unknown()
-        .describe('The entitlement config as a JSON object. Returned when checking entitlement access; useful for configuring fine-grained access settings implemented in your own system.'),
-})
-    .describe('The entitlement template of a static entitlement.');
-export const rateCardBooleanEntitlementWire = z
-    .strictObject({
-    type: z
-        .literal('boolean')
-        .describe('The type of the entitlement template.'),
-})
-    .describe('The entitlement template of a boolean entitlement.');
+export const featureLlmTokenTypeWire = z
+    .enum([
+    'input',
+    'output',
+    'cache_read',
+    'cache_write',
+    'reasoning',
+    'request',
+    'response',
+])
+    .describe('Token type for LLM cost lookup.');
 export const subscriptionEditTimingEnumWire = z
     .enum(['immediate', 'next_billing_cycle'])
     .describe('Subscription edit timing. When immediate, the requested changes take effect immediately. When next_billing_cycle, the requested changes take effect at the next billing cycle.');
@@ -5876,11 +6179,6 @@ export const installAppExternalInvoicingWire = z
         .describe('If true, a billing profile will be created for the app. The Stripe app will be also set as the default billing profile if the current default is a Sandbox app.'),
 })
     .describe('Base model for installing an app from the catalog.');
-export const taxIdentificationCodeWire = z
-    .string()
-    .min(1)
-    .max(32)
-    .describe('Tax identifier code is a normalized tax code shown on the original identity document.');
 export const workflowCollectionAlignmentSubscriptionWire = z
     .strictObject({
     type: z.literal('subscription').describe('The type of alignment.'),
@@ -5889,79 +6187,6 @@ export const workflowCollectionAlignmentSubscriptionWire = z
 export const workflowInvoicingSubscriptionEndProrationModeWire = z
     .enum(['bill_full_period', 'bill_actual_period'])
     .describe('Billing workflow subscription end proration mode.');
-export const workflowPaymentChargeAutomaticallySettingsWire = z
-    .strictObject({
-    collection_method: z
-        .literal('charge_automatically')
-        .describe('The collection method for the invoice.'),
-})
-    .describe('Payment settings for a billing workflow when the collection method is charge automatically.');
-export const workflowPaymentSendInvoiceSettingsWire = z
-    .strictObject({
-    collection_method: z
-        .literal('send_invoice')
-        .describe('The collection method for the invoice.'),
-    due_after: z
-        .string()
-        .optional()
-        .describe("The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method."),
-})
-    .describe('Payment settings for a billing workflow when the collection method is send invoice.');
-export const invoiceNumberWire = z
-    .string()
-    .min(1)
-    .max(256)
-    .describe('InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app. The uniqueness depends on a lot of factors: - app setting (unique per app or unique per customer) - multiple app scenarios (multiple apps generating invoices with the same prefix)');
-export const invoiceValidationIssueSeverityWire = z
-    .enum(['critical', 'warning'])
-    .describe('Severity level of an invoice validation issue.');
-export const invoiceExternalReferencesWire = z
-    .strictObject({
-    invoicing_id: z
-        .string()
-        .optional()
-        .describe('The ID assigned by the external invoicing app (e.g. Stripe invoice ID).'),
-    payment_id: z
-        .string()
-        .optional()
-        .describe('The ID assigned by the external payment app (e.g. Stripe payment intent ID).'),
-})
-    .describe('External identifiers assigned to an invoice by third-party systems.');
-export const invoiceStandardStatusWire = z
-    .enum([
-    'draft',
-    'issuing',
-    'issued',
-    'payment_processing',
-    'overdue',
-    'paid',
-    'uncollectible',
-    'voided',
-])
-    .describe('Lifecycle status of a standard invoice.');
-export const invoiceAvailableActionDetailsWire = z
-    .strictObject({
-    resulting_state: z
-        .string()
-        .describe('The extended status the invoice will transition to after performing this action.'),
-})
-    .describe('Details about an available invoice action including the resulting state.');
-export const invoiceWorkflowInvoicingSettingsWire = z
-    .strictObject({
-    auto_advance: z
-        .boolean()
-        .optional()
-        .describe('Whether to automatically issue the invoice after the draft_period has passed.'),
-    draft_period: z
-        .string()
-        .optional()
-        .describe('The period for the invoice to be kept in draft status for manual reviews.'),
-    due_after: z
-        .string()
-        .optional()
-        .describe('The period after which the invoice is considered overdue if not paid.'),
-})
-    .describe('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 const invoiceDiscountReasonWire = z
     .enum(['maximum_spend', 'ratecard_percentage', 'ratecard_usage'])
     .describe('The reason a discount was applied to an invoice line.');
@@ -6017,17 +6242,6 @@ export const currencyTypeWire = z
 export const currencyExpandWire = z
     .enum(['cost_basis'])
     .describe("Expands for currencies. Values: - `cost_basis`: The currency's active and scheduled cost basis.");
-export const featureLlmTokenTypeWire = z
-    .enum([
-    'input',
-    'output',
-    'cache_read',
-    'cache_write',
-    'reasoning',
-    'request',
-    'response',
-])
-    .describe('Token type for LLM cost lookup.');
 export const llmCostProviderWire = z
     .strictObject({
     id: z
@@ -6282,12 +6496,12 @@ export const invoiceLineTypeWire = z
 export const priceTypeWire = z
     .enum(['free', 'flat', 'unit', 'graduated', 'volume'])
     .describe("The type of the price. - `free`: No charge, the rate card is included at no cost. - `flat`: A fixed amount charged once per billing period, regardless of usage. - `unit`: A fixed rate charged per billing unit consumed. - `graduated`: Tiered pricing where each tier's rate applies only to usage within that tier. - `volume`: Tiered pricing where the rate for the highest tier reached applies to all units in the period.");
-export const collectionAlignmentWire = z
-    .enum(['subscription', 'anchored'])
-    .describe('BillingCollectionAlignment specifies when the pending line items should be collected into an invoice.');
 export const collectionMethodWire = z
     .enum(['charge_automatically', 'send_invoice'])
     .describe('Collection method specifies how the invoice should be collected (automatic or manual).');
+export const collectionAlignmentWire = z
+    .enum(['subscription', 'anchored'])
+    .describe('BillingCollectionAlignment specifies when the pending line items should be collected into an invoice.');
 export const featureUnitCostTypeWire = z
     .enum(['llm', 'manual'])
     .describe('The type of unit cost.');
@@ -6414,22 +6628,28 @@ export const createCurrencyCustomRequestWire = z
         .string()
         .min(1)
         .max(1)
-        .describe('The thousand separator for the currency. It should be a string that represents the thousand separator of the currency, such as "," for US Dollar or "." for Euro.'),
-    code: currencyCodeCustomWire,
-})
-    .describe('CurrencyCustom create request.');
-export const currencyAmountWire = z
-    .strictObject({
-    amount: numericWire,
-    currency: currencyCodeWire,
+        .describe('The thousand separator for the currency. It should be a string that represents the thousand separator of the currency, such as "," for US Dollar or "." for Euro.'),
+    code: currencyCodeCustomWire,
 })
-    .describe('Monetary amount in a specific currency.');
+    .describe('CurrencyCustom create request.');
 export const priceFlatWire = z
     .strictObject({
     type: z.literal('flat').describe('The type of the price.'),
     amount: numericWire,
 })
     .describe('Flat price.');
+export const priceUnitWire = z
+    .strictObject({
+    type: z.literal('unit').describe('The type of the price.'),
+    amount: numericWire,
+})
+    .describe('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 const spendCommitmentsWire = z
+    .strictObject({
+    minimum_amount: numericWire.optional(),
+    maximum_amount: numericWire.optional(),
+})
+    .describe('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 const rateCardDiscountsWire = z
     .strictObject({
     percentage: z
@@ -6453,18 +6673,57 @@ export const totalsWire = z
     total: numericWire,
 })
     .describe('Totals contains the summaries of all calculations for a billing resource.');
-export const priceUnitWire = z
+export const chargeRealizationDetailedLineCreditAppliedWire = z
     .strictObject({
-    type: z.literal('unit').describe('The type of the price.'),
     amount: numericWire,
+    description: z
+        .string()
+        .optional()
+        .describe('Human-readable description of the credit allocation.'),
+    credit_realization_id: z
+        .string()
+        .describe('The ID of the credit realization (allocation) this credit was applied from.'),
 })
-    .describe('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 const spendCommitmentsWire = z
+    .describe('A credit allocation applied to a charge realization detailed line.');
+export const chargeRealizationAmountDiscountWire = z
     .strictObject({
-    minimum_amount: numericWire.optional(),
-    maximum_amount: numericWire.optional(),
+    amount: numericWire,
+    reason: z
+        .string()
+        .describe('The reason for the discount applied to the charge.'),
+    description: z
+        .string()
+        .optional()
+        .describe('Optional human-readable description of the discount.'),
+    rounding_amount: numericWire.optional(),
+    child_unique_reference_id: z
+        .string()
+        .describe('Unique reference ID of the discount applied to the charge.'),
 })
-    .describe('Spend commitments for a usage-based price. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
+    .describe('A discount applied to a charge realization detailed line.');
+export const featureManualUnitCostWire = z
+    .strictObject({
+    type: z
+        .literal('manual')
+        .describe('The type discriminator for manual unit cost.'),
+    amount: numericWire,
+})
+    .describe('A fixed per-unit cost amount.');
+export const featureLlmUnitCostPricingWire = z
+    .strictObject({
+    input_per_token: numericWire,
+    output_per_token: numericWire,
+    cache_read_per_token: numericWire.optional(),
+    reasoning_per_token: numericWire.optional(),
+    cache_write_per_token: numericWire.optional(),
+})
+    .describe('Resolved per-token pricing from the LLM cost database.');
+export const currencyAmountWire = z
+    .strictObject({
+    amount: numericWire,
+    currency: currencyCodeWire,
+})
+    .describe('Monetary amount in a specific currency.');
 export const invoiceLineCreditsAppliedWire = z
     .strictObject({
     amount: numericWire,
@@ -6507,23 +6766,6 @@ export const updateDiscountsWire = z
     usage: numericWire.optional(),
 })
     .describe('Discount configuration for a rate card.');
-export const featureManualUnitCostWire = z
-    .strictObject({
-    type: z
-        .literal('manual')
-        .describe('The type discriminator for manual unit cost.'),
-    amount: numericWire,
-})
-    .describe('A fixed per-unit cost amount.');
-export const featureLlmUnitCostPricingWire = z
-    .strictObject({
-    input_per_token: numericWire,
-    output_per_token: numericWire,
-    cache_read_per_token: numericWire.optional(),
-    reasoning_per_token: numericWire.optional(),
-    cache_write_per_token: numericWire.optional(),
-})
-    .describe('Resolved per-token pricing from the LLM cost database.');
 export const llmCostModelPricingWire = z
     .strictObject({
     input_per_token: numericWire,
@@ -6624,14 +6866,25 @@ export const creditGrantInvoiceReferenceWire = z
         .describe('Identifier of the invoice line associated with the grant.'),
 })
     .describe('Invoice references for the grant.');
-export const billingCustomerReferenceWire = z
+export const subscriptionCostBasisPinWire = z
+    .strictObject({
+    custom_currency_id: ulidWire,
+    invoice_currency: currencyCodeWire,
+    cost_basis_id: ulidWire,
+})
+    .describe('A cost basis pinned to a custom-currency pair for the subscription.');
+export const featureReferenceWire = z
     .strictObject({
     id: ulidWire,
 })
-    .describe('Customer reference.');
+    .describe('Feature reference.');
 export const subscriptionReferenceWire = z
     .strictObject({
     id: ulidWire,
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the subscription. Only populated where the referencing endpoint documents a `subscription` expand that resolves it.'),
     phase: z
         .strictObject({
         id: ulidWire,
@@ -6644,28 +6897,21 @@ export const subscriptionReferenceWire = z
         .describe('The phase of the subscription.'),
 })
     .describe('Subscription reference represents a reference to the specific subscription item this entity represents.');
-export const subscriptionCostBasisPinWire = z
+export const appReferenceWire = z
     .strictObject({
-    custom_currency_id: ulidWire,
-    invoice_currency: currencyCodeWire,
-    cost_basis_id: ulidWire,
+    id: ulidWire,
 })
-    .describe('A cost basis pinned to a custom-currency pair for the subscription.');
-export const featureReferenceWire = z
+    .describe('App reference.');
+export const chargeRealizationInvoiceReferenceWire = z
     .strictObject({
     id: ulidWire,
 })
-    .describe('Feature reference.');
+    .describe('ChargeRealizationInvoice reference.');
 export const addonReferenceWire = z
     .strictObject({
     id: ulidWire,
 })
     .describe('Addon reference.');
-export const appReferenceWire = z
-    .strictObject({
-    id: ulidWire,
-})
-    .describe('App reference.');
 export const chargeReferenceWire = z
     .strictObject({
     id: ulidWire,
@@ -6676,6 +6922,28 @@ export const updateResourceReferenceWire = z
     id: ulidWire,
 })
     .describe('TaxCode reference.');
+export const billingCustomerReferenceWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the customer. Only populated where the referencing endpoint documents a `customer` expand that resolves it.'),
+})
+    .describe('Customer reference.');
+export const chargeFeatureWire = z
+    .strictObject({
+    id: ulidWire,
+    key: z
+        .string()
+        .optional()
+        .describe('The key of the feature. Requires the `feature` expand.'),
+    name: z
+        .string()
+        .optional()
+        .describe('The display name of the feature. Requires the `feature` expand.'),
+})
+    .describe('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 const dateTimeFieldFilterWire = z
     .union([
     dateTimeWire,
@@ -7346,11 +7614,6 @@ export const getCreditBalanceParamsFilterWire = z
     feature_key: stringFieldFilterWire.optional(),
 })
     .describe('Filter options for getting a credit balance.');
-export const listChargesParamsFilterWire = z
-    .strictObject({
-    status: stringFieldFilterExactWire.optional(),
-})
-    .describe('Filter options for listing charges.');
 export const listPlansParamsFilterWire = z
     .strictObject({
     key: stringFieldFilterWire.optional(),
@@ -7364,33 +7627,17 @@ export const voidCreditGrantRequestWire = z
     payment_adjustment: creditGrantVoidPaymentAdjustmentWire.optional(),
 })
     .describe('Request body for voiding a credit grant.');
-export const rateCardProrationConfigurationWire = z
-    .strictObject({
-    mode: rateCardProrationModeWire,
-})
-    .describe('The proration configuration of the rate card.');
 export const subscriptionProRatingConfigWire = z
     .strictObject({
     enabled: z.boolean().describe('Whether pro-rating is enabled.'),
     mode: rateCardProrationModeWire,
 })
     .describe('The pro-rating configuration of a subscription.');
-export const unitConfigWire = z
+export const rateCardProrationConfigurationWire = z
     .strictObject({
-    operation: unitConfigOperationWire,
-    conversion_factor: numericWire,
-    rounding: unitConfigRoundingModeWire.optional(),
-    precision: z
-        .number()
-        .int()
-        .optional()
-        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
-    display_unit: z
-        .string()
-        .optional()
-        .describe('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.'),
+    mode: rateCardProrationModeWire,
 })
-    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
+    .describe('The proration configuration of the rate card.');
 export const subscriptionCreateWire = z
     .strictObject({
     labels: labelsWire.optional(),
@@ -7416,6 +7663,67 @@ export const subscriptionCreateWire = z
     cost_basis_mode: subscriptionCostBasisModeWire.optional(),
 })
     .describe('Subscription create request.');
+export const unitConfigWire = z
+    .strictObject({
+    operation: unitConfigOperationWire,
+    conversion_factor: numericWire,
+    rounding: unitConfigRoundingModeWire.optional(),
+    precision: z
+        .number()
+        .int()
+        .optional()
+        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
+    display_unit: z
+        .string()
+        .optional()
+        .describe('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.'),
+})
+    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
+export const partyTaxIdentityWire = z
+    .strictObject({
+    code: taxIdentificationCodeWire.optional(),
+})
+    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
+export const updateBillingPartyTaxIdentityWire = z
+    .strictObject({
+    code: taxIdentificationCodeWire.optional(),
+})
+    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
+export const invoiceValidationIssueWire = z
+    .strictObject({
+    code: z.string().describe('Machine-readable error code.'),
+    message: z.string().describe('Human-readable description of the error.'),
+    attributes: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Additional structured context.'),
+    severity: invoiceValidationIssueSeverityWire,
+    field: z
+        .string()
+        .optional()
+        .describe('JSON path to the field that caused this validation issue, if applicable. For example: `lines/0/rate_card/price`.'),
+})
+    .describe('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 const invoiceAvailableActionsWire = z
+    .strictObject({
+    advance: invoiceAvailableActionDetailsWire.optional(),
+    approve: invoiceAvailableActionDetailsWire.optional(),
+    delete: invoiceAvailableActionDetailsWire.optional(),
+    retry: invoiceAvailableActionDetailsWire.optional(),
+    snapshot_quantities: invoiceAvailableActionDetailsWire.optional(),
+})
+    .describe('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 const workflowPaymentSettingsWire = z
+    .discriminatedUnion('collection_method', [
+    workflowPaymentChargeAutomaticallySettingsWire,
+    workflowPaymentSendInvoiceSettingsWire,
+])
+    .describe('Payment settings for a billing workflow.');
+export const chargeRealizationPaymentWire = z
+    .strictObject({
+    status: chargeRealizationPaymentStatusWire,
+})
+    .describe('Payment state of a charge realization.');
 export const subscriptionEditTimingWire = z
     .union([subscriptionEditTimingEnumWire, dateTimeWire])
     .describe('Subscription edit timing defined when the changes should take effect. If the provided configuration is not supported by the subscription, an error will be returned.');
@@ -7498,16 +7806,6 @@ export const installAppRequestWire = z
     installAppExternalInvoicingWire,
 ])
     .describe('Request to install an app from the catalog.');
-export const partyTaxIdentityWire = z
-    .strictObject({
-    code: taxIdentificationCodeWire.optional(),
-})
-    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
-export const updateBillingPartyTaxIdentityWire = z
-    .strictObject({
-    code: taxIdentificationCodeWire.optional(),
-})
-    .describe('Identity stores the details required to identify an entity for tax purposes in a specific country.');
 export const workflowInvoicingSettingsWire = z
     .strictObject({
     auto_advance: z
@@ -7525,36 +7823,6 @@ export const workflowInvoicingSettingsWire = z
     subscription_end_proration_mode: workflowInvoicingSubscriptionEndProrationModeWire.optional(),
 })
     .describe('Invoice settings for a billing workflow.');
-export const workflowPaymentSettingsWire = z
-    .discriminatedUnion('collection_method', [
-    workflowPaymentChargeAutomaticallySettingsWire,
-    workflowPaymentSendInvoiceSettingsWire,
-])
-    .describe('Payment settings for a billing workflow.');
-export const invoiceValidationIssueWire = z
-    .strictObject({
-    code: z.string().describe('Machine-readable error code.'),
-    message: z.string().describe('Human-readable description of the error.'),
-    attributes: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe('Additional structured context.'),
-    severity: invoiceValidationIssueSeverityWire,
-    field: z
-        .string()
-        .optional()
-        .describe('JSON path to the field that caused this validation issue, if applicable. For example: `lines/0/rate_card/price`.'),
-})
-    .describe('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 const invoiceAvailableActionsWire = z
-    .strictObject({
-    advance: invoiceAvailableActionDetailsWire.optional(),
-    approve: invoiceAvailableActionDetailsWire.optional(),
-    delete: invoiceAvailableActionDetailsWire.optional(),
-    retry: invoiceAvailableActionDetailsWire.optional(),
-    snapshot_quantities: invoiceAvailableActionDetailsWire.optional(),
-})
-    .describe('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 const invoiceLineAmountDiscountWire = z
     .strictObject({
     id: ulidWire,
@@ -7722,12 +7990,6 @@ export const creditTransactionWire = z
         .describe('The available balance before and after the transaction.'),
 })
     .describe("A credit transaction represents a single credit movement on the customer's balance. Credit transactions are immutable.");
-export const chargeTotalsWire = z
-    .strictObject({
-    booked: totalsWire,
-    realtime: totalsWire.optional(),
-})
-    .describe('The totals of a charge. RealTime is only expanded when the `real_time_usage` expand is used.');
 export const priceTierWire = z
     .strictObject({
     up_to_amount: numericWire.optional(),
@@ -7735,13 +7997,12 @@ export const priceTierWire = z
     unit_price: priceUnitWire.optional(),
 })
     .describe('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 const updatePriceTierWire = z
-    .strictObject({
-    up_to_amount: numericWire.optional(),
-    flat_price: updatePriceFlatWire.optional(),
-    unit_price: updatePriceUnitWire.optional(),
+export const chargeTotalsWire = z
+    .strictObject({
+    booked: totalsWire,
+    realtime: totalsWire.optional(),
 })
-    .describe('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.');
+    .describe('The totals of a charge. `realtime` is only populated when the `real_time_usage` expand is used.');
 export const featureLlmUnitCostWire = z
     .strictObject({
     type: z
@@ -7771,6 +8032,13 @@ export const featureLlmUnitCostWire = z
     pricing: featureLlmUnitCostPricingWire.optional(),
 })
     .describe('LLM cost lookup configuration. Each dimension (provider, model, token type) can be specified as either a static value or a meter group-by property name (mutually exclusive).');
+export const updatePriceTierWire = z
+    .strictObject({
+    up_to_amount: numericWire.optional(),
+    flat_price: updatePriceFlatWire.optional(),
+    unit_price: updatePriceUnitWire.optional(),
+})
+    .describe('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 const llmCostPriceWire = z
     .strictObject({
     id: ulidWire,
@@ -7853,6 +8121,12 @@ export const creditGrantTaxConfigWire = z
     tax_code: taxCodeReferenceWire.optional(),
 })
     .describe('Tax configuration for a credit grant. Tax configuration should be provided to ensure correct revenue recognition, including for externally funded grants.');
+export const rateCardTaxConfigWire = z
+    .strictObject({
+    behavior: taxBehaviorWire.optional(),
+    code: taxCodeReferenceWire,
+})
+    .describe('The tax config of the rate card.');
 export const taxConfigWire = z
     .strictObject({
     behavior: taxBehaviorWire.optional(),
@@ -7862,12 +8136,6 @@ export const taxConfigWire = z
     tax_code: taxCodeReferenceWire.optional(),
 })
     .describe('Set of provider specific tax configs.');
-export const rateCardTaxConfigWire = z
-    .strictObject({
-    behavior: taxBehaviorWire.optional(),
-    code: taxCodeReferenceWire,
-})
-    .describe('The tax config of the rate card.');
 export const organizationDefaultTaxCodesWire = z
     .strictObject({
     invoicing_tax_code: taxCodeReferenceWire,
@@ -7882,6 +8150,20 @@ export const updateOrganizationDefaultTaxCodesRequestWire = z
     credit_grant_tax_code: taxCodeReferenceWire.optional(),
 })
     .describe('OrganizationDefaultTaxCodes update request.');
+export const invoiceWorkflowAppsReferencesWire = z
+    .strictObject({
+    tax: appReferenceWire,
+    invoicing: appReferenceWire,
+    payment: appReferenceWire,
+})
+    .describe('BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps used by a billing profile');
+export const profileAppReferencesWire = z
+    .strictObject({
+    tax: appReferenceWire,
+    invoicing: appReferenceWire,
+    payment: appReferenceWire,
+})
+    .describe('References to the applications used by a billing profile.');
 export const planAddonWire = z
     .strictObject({
     id: ulidWire,
@@ -7936,20 +8218,6 @@ export const createPlanAddonRequestWire = z
         .describe('The maximum number of times the add-on can be purchased for the plan. For single-instance add-ons this field must be omitted. For multi-instance add-ons when omitted, unlimited quantity can be purchased.'),
 })
     .describe('PlanAddon create request.');
-export const profileAppReferencesWire = z
-    .strictObject({
-    tax: appReferenceWire,
-    invoicing: appReferenceWire,
-    payment: appReferenceWire,
-})
-    .describe('References to the applications used by a billing profile.');
-export const invoiceWorkflowAppsReferencesWire = z
-    .strictObject({
-    tax: appReferenceWire,
-    invoicing: appReferenceWire,
-    payment: appReferenceWire,
-})
-    .describe('BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps used by a billing profile');
 export const updateRateCardTaxConfigWire = z
     .strictObject({
     behavior: taxBehaviorWire.optional(),
@@ -7968,6 +8236,15 @@ export const listEventsParamsFilterWire = z
     stored_at: dateTimeFieldFilterWire.optional(),
 })
     .describe('Filter options for listing ingested events.');
+export const listChargesParamsFilterWire = z
+    .strictObject({
+    status: stringFieldFilterExactWire.optional(),
+    feature_id: ulidFieldFilterWire.optional(),
+    feature_key: stringFieldFilterExactWire.optional(),
+    service_period_from: dateTimeFieldFilterWire.optional(),
+    service_period_to: dateTimeFieldFilterWire.optional(),
+})
+    .describe('Filter options for listing charges.');
 export const listInvoicesParamsFilterWire = z
     .strictObject({
     status: stringFieldFilterExactWire.optional(),
@@ -8019,6 +8296,55 @@ export const meterQueryResultWire = z
         .describe('The usage data. If no data is available, an empty array is returned.'),
 })
     .describe('Meter query result.');
+export const chargeRealizationDetailedLineFlatFeeWire = z
+    .strictObject({
+    id: ulidWire,
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('flat_fee')
+        .describe('The type of the charge the realization belongs to.'),
+    service_period: closedPeriodWire,
+    totals: totalsWire,
+    category: chargeRealizationDetailedLineCategoryWire,
+    credits_applied: z
+        .array(chargeRealizationDetailedLineCreditAppliedWire)
+        .optional()
+        .describe('Credits applied to this detailed line.'),
+    unit_price: numericWire,
+    amount_discounts: z
+        .array(chargeRealizationAmountDiscountWire)
+        .describe('The amount discounts applied to the detailed line.'),
+})
+    .describe("A detailed line produced by a flat fee charge's realization run.");
+export const chargeRealizationDetailedLineUsageBasedWire = z
+    .strictObject({
+    id: ulidWire,
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z
+        .literal('usage_based')
+        .describe('The type of the charge the realization belongs to.'),
+    service_period: closedPeriodWire,
+    totals: totalsWire,
+    category: chargeRealizationDetailedLineCategoryWire,
+    credits_applied: z
+        .array(chargeRealizationDetailedLineCreditAppliedWire)
+        .optional()
+        .describe('Credits applied to this detailed line.'),
+    unit_price: numericWire,
+    amount_discounts: z
+        .array(chargeRealizationAmountDiscountWire)
+        .describe('The amount discounts applied to the detailed line.'),
+    quantity: numericWire,
+    corrects_run_id: z
+        .string()
+        .optional()
+        .describe("The ID of a prior realization run this detailed line corrects. Only set if the detailed line's totals are negative."),
+})
+    .describe("A detailed line produced by a usage-based charge's realization run.");
 export const currencyCustomWire = z
     .strictObject({
     type: z.literal('custom').describe('The type of the currency.'),
@@ -8261,6 +8587,24 @@ export const chargeFlatFeeSystemIntentWire = z
     deleted_at: dateTimeWire.optional(),
 })
     .describe('Flat fee intent fields from the system lifecycle controller shadowed by a manual override.');
+export const invoiceStatusDetailsWire = z
+    .strictObject({
+    immutable: z
+        .boolean()
+        .describe('Whether the invoice is immutable (i.e. cannot be modified or deleted).'),
+    failed: z.boolean().describe('Whether the invoice is in a failed state.'),
+    extended_status: z
+        .string()
+        .describe('Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.'),
+    available_actions: invoiceAvailableActionsWire,
+})
+    .describe('Detailed status information for a standard invoice.');
+export const invoiceWorkflowWire = z
+    .strictObject({
+    invoicing: invoiceWorkflowInvoicingSettingsWire.optional(),
+    payment: workflowPaymentSettingsWire.optional(),
+})
+    .describe('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 const subscriptionCancelWire = z
     .strictObject({
     timing: subscriptionEditTimingWire.optional(),
@@ -8384,24 +8728,6 @@ export const updateAppRequestWire = z
     updateAppExternalInvoicingRequestWire,
 ])
     .describe('Request to update an installed app.');
-export const invoiceWorkflowWire = z
-    .strictObject({
-    invoicing: invoiceWorkflowInvoicingSettingsWire.optional(),
-    payment: workflowPaymentSettingsWire.optional(),
-})
-    .describe('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 const invoiceStatusDetailsWire = z
-    .strictObject({
-    immutable: z
-        .boolean()
-        .describe('Whether the invoice is immutable (i.e. cannot be modified or deleted).'),
-    failed: z.boolean().describe('Whether the invoice is in a failed state.'),
-    extended_status: z
-        .string()
-        .describe('Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.'),
-    available_actions: invoiceAvailableActionsWire,
-})
-    .describe('Detailed status information for a standard invoice.');
 export const invoiceLineDiscountsWire = z
     .strictObject({
     amount: z
@@ -8472,6 +8798,12 @@ export const priceVolumeWire = z
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
     .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
+export const featureUnitCostWire = z
+    .discriminatedUnion('type', [
+    featureManualUnitCostWire,
+    featureLlmUnitCostWire,
+])
+    .describe('Per-unit cost configuration for a feature. Either a fixed manual amount or a dynamic LLM cost lookup.');
 export const updatePriceGraduatedWire = z
     .strictObject({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -8490,12 +8822,6 @@ export const updatePriceVolumeWire = z
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
     .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
-export const featureUnitCostWire = z
-    .discriminatedUnion('type', [
-    featureManualUnitCostWire,
-    featureLlmUnitCostWire,
-])
-    .describe('Per-unit cost configuration for a feature. Either a fixed manual amount or a dynamic LLM cost lookup.');
 export const pricePagePaginatedResponseWire = z
     .strictObject({
     data: z.array(llmCostPriceWire),
@@ -8596,12 +8922,9 @@ export const createChargeFlatFeeRequestWire = z
     tax_config: taxConfigWire.optional(),
     payment_term: pricePaymentTermWire,
     discounts: chargeFlatFeeDiscountsWire.optional(),
-    feature_id: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
     proration_configuration: rateCardProrationConfigurationWire,
     amount_before_proration: currencyAmountWire,
+    feature: featureReferenceWire.optional(),
     full_service_period: closedPeriodWire.optional(),
     billing_period: closedPeriodWire.optional(),
 })
@@ -8631,6 +8954,12 @@ export const ingestedEventPaginatedResponseWire = z
     meta: cursorMetaWire,
 })
     .describe('Cursor paginated response.');
+export const chargeRealizationDetailedLineWire = z
+    .discriminatedUnion('type', [
+    chargeRealizationDetailedLineFlatFeeWire,
+    chargeRealizationDetailedLineUsageBasedWire,
+])
+    .describe("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 const currencyWire = z
     .discriminatedUnion('type', [currencyFiatWire, currencyCustomWire])
     .describe('Fiat or custom currency.');
@@ -8661,29 +8990,32 @@ export const customerPagePaginatedResponseWire = z
     meta: paginatedMetaWire,
 })
     .describe('Page paginated response.');
-export const partyWire = z
+export const customerOrReferenceWire = z
+    .union([customerWire, customerReferenceWire])
+    .describe('Customer or reference.');
+export const supplierWire = z
     .strictObject({
-    id: z.string().optional().describe('Unique identifier for the party.'),
-    key: externalResourceKeyWire.optional(),
     name: z
         .string()
         .optional()
         .describe('Legal name or representation of the party.'),
     tax_id: partyTaxIdentityWire.optional(),
     addresses: partyAddressesWire.optional(),
+    id: z.string().optional().describe('Unique identifier for the party.'),
 })
-    .describe('Party represents a person or business entity.');
-export const supplierWire = z
+    .describe("Snapshot of the supplier's information at the time the invoice was issued. Structurally a read-only subset of `BillingParty` (the type configured on the billing profile), so the snapshot stays aligned with the source. `key` is omitted because it is not part of the snapshotted supplier data.");
+export const partyWire = z
     .strictObject({
+    id: z.string().optional().describe('Unique identifier for the party.'),
+    key: externalResourceKeyWire.optional(),
     name: z
         .string()
         .optional()
         .describe('Legal name or representation of the party.'),
     tax_id: partyTaxIdentityWire.optional(),
     addresses: partyAddressesWire.optional(),
-    id: z.string().optional().describe('Unique identifier for the party.'),
 })
-    .describe("Snapshot of the supplier's information at the time the invoice was issued. Structurally a read-only subset of `BillingParty` (the type configured on the billing profile), so the snapshot stays aligned with the source. `key` is omitted because it is not part of the snapshotted supplier data.");
+    .describe('Party represents a person or business entity.');
 export const updateSupplierWire = z
     .strictObject({
     name: z
@@ -8747,56 +9079,13 @@ export const workflowCollectionAlignmentWire = z
     workflowCollectionAlignmentAnchoredWire,
 ])
     .describe('The alignment for collecting the pending line items into an invoice. Defaults to subscription, which means that we are to create a new invoice every time the a subscription period starts (for in advance items) or ends (for in arrears items).');
-export const chargeFlatFeeWire = z
+export const invoiceWorkflowSettingsWire = z
     .strictObject({
-    id: ulidWire,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labelsWire.optional(),
-    created_at: dateTimeWire,
-    updated_at: dateTimeWire,
-    deleted_at: dateTimeWire.optional(),
-    type: z.literal('flat_fee').describe('The type of the charge.'),
-    customer: billingCustomerReferenceWire,
-    lifecycle_controller: lifecycleControllerWire,
-    subscription: subscriptionReferenceWire.optional(),
-    currency: currencyCodeWire,
-    status: chargeStatusWire,
-    invoice_at: dateTimeWire,
-    service_period: closedPeriodWire,
-    full_service_period: closedPeriodWire,
-    billing_period: closedPeriodWire,
-    advance_after: dateTimeWire.optional(),
-    unique_reference_id: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlement_mode: settlementModeWire,
-    tax_config: taxConfigWire.optional(),
-    payment_term: pricePaymentTermWire,
-    discounts: chargeFlatFeeDiscountsWire.optional(),
-    feature_key: z
-        .string()
-        .optional()
-        .describe('The feature associated with the charge, when applicable.'),
-    feature_id: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
-    proration_configuration: rateCardProrationConfigurationWire,
-    amount_after_proration: currencyAmountWire,
-    price: priceFlatWire,
-    system_intent: chargeFlatFeeSystemIntentWire.optional(),
+    apps: invoiceWorkflowAppsReferencesWire.optional(),
+    source_billing_profile: profileReferenceWire,
+    workflow: invoiceWorkflowWire,
 })
-    .describe('A flat fee charge for a customer.');
+    .describe('Snapshot of the billing workflow configuration captured at invoice creation.');
 export const taxCodePagePaginatedResponseWire = z
     .strictObject({
     data: z.array(taxCodeWire),
@@ -8980,13 +9269,6 @@ export const installedAppExternalInvoicingWire = z
         .describe('Default capabilities of the installed app.'),
 })
     .describe('Response of an installed app.');
-export const invoiceWorkflowSettingsWire = z
-    .strictObject({
-    apps: invoiceWorkflowAppsReferencesWire.optional(),
-    source_billing_profile: profileReferenceWire,
-    workflow: invoiceWorkflowWire,
-})
-    .describe('Snapshot of the billing workflow configuration captured at invoice creation.');
 export const invoiceDetailedLineWire = z
     .strictObject({
     id: ulidWire,
@@ -9034,13 +9316,6 @@ export const entitlementAccessQueryResultWire = z
     updated_at: dateTimeWire,
 })
     .describe('Access evaluation result for a single resolved customer.');
-export const priceUsageBasedWire = z
-    .discriminatedUnion('type', [
-    priceUnitWire,
-    priceGraduatedWire,
-    priceVolumeWire,
-])
-    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const priceWire = z
     .discriminatedUnion('type', [
     priceFreeWire,
@@ -9050,15 +9325,13 @@ export const priceWire = z
     priceVolumeWire,
 ])
     .describe('Price.');
-export const updatePriceWire = z
+export const priceUsageBasedWire = z
     .discriminatedUnion('type', [
-    updatePriceFreeWire,
-    updatePriceFlatWire,
-    updatePriceUnitWire,
-    updatePriceGraduatedWire,
-    updatePriceVolumeWire,
+    priceUnitWire,
+    priceGraduatedWire,
+    priceVolumeWire,
 ])
-    .describe('Price.');
+    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const featureWire = z
     .strictObject({
     id: ulidWire,
@@ -9107,6 +9380,15 @@ export const updateFeatureRequestWire = z
         .describe('Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties. Set to `null` to clear the existing unit cost; omit to leave it unchanged.'),
 })
     .describe('Request body for updating a feature. Currently only the unit_cost field can be updated.');
+export const updatePriceWire = z
+    .discriminatedUnion('type', [
+    updatePriceFreeWire,
+    updatePriceFlatWire,
+    updatePriceUnitWire,
+    updatePriceGraduatedWire,
+    updatePriceVolumeWire,
+])
+    .describe('Price.');
 export const creditGrantPagePaginatedResponseWire = z
     .strictObject({
     data: z.array(creditGrantWire),
@@ -9162,7 +9444,43 @@ export const workflowCollectionSettingsWire = z
         .optional()
         .describe('This grace period can be used to delay the collection of the pending line items specified in alignment. This is useful, in case of multiple subscriptions having slightly different billing periods.'),
 })
-    .describe('Workflow collection specifies how to collect the pending line items for an invoice.');
+    .describe('Workflow collection specifies how to collect the pending line items for an invoice.');
+export const chargeRealizationInvoiceWire = z
+    .strictObject({
+    id: ulidWire,
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    number: invoiceNumberWire,
+    currency: currencyCodeWire,
+    supplier: supplierWire,
+    totals: totalsWire,
+    service_period: closedPeriodWire,
+    validation_issues: z
+        .array(invoiceValidationIssueWire)
+        .optional()
+        .describe('Validation issues found during invoice processing. Present only when there are one or more validation findings. An empty list is omitted.'),
+    external_references: invoiceExternalReferencesWire.optional(),
+    type: z
+        .literal('standard')
+        .describe('Discriminator field identifying this as a standard invoice.'),
+    status: invoiceStandardStatusWire,
+    status_details: invoiceStatusDetailsWire,
+    issued_at: dateTimeWire.optional(),
+    draft_until: dateTimeWire.optional(),
+    quantity_snapshotted_at: dateTimeWire.optional(),
+    collection_at: dateTimeWire.optional(),
+    due_at: dateTimeWire.optional(),
+    sent_to_customer_at: dateTimeWire.optional(),
+    workflow: invoiceWorkflowSettingsWire,
+})
+    .describe('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 const appWire = z
     .discriminatedUnion('type', [
     appStripeWire,
@@ -9188,6 +9506,41 @@ export const entitlementAccessQueryResponseWire = z
     meta: cursorMetaWire,
 })
     .describe('Response of the entitlement access query.');
+export const rateCardWire = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labelsWire.optional(),
+    key: resourceKeyWire,
+    feature: featureReferenceWire.optional(),
+    currency: billingCurrencyCodeWire.optional(),
+    billing_cadence: iso8601DurationWire.optional(),
+    price: priceWire,
+    unit_config: unitConfigWire.optional(),
+    payment_term: pricePaymentTermWire.optional(),
+    commitments: spendCommitmentsWire.optional(),
+    discounts: rateCardDiscountsWire.optional(),
+    tax_config: rateCardTaxConfigWire.optional(),
+    entitlement: rateCardEntitlementWire.optional(),
+})
+    .describe('A rate card defines the pricing and entitlement of a feature or service.');
+export const invoiceLineRateCardWire = z
+    .strictObject({
+    price: priceWire,
+    tax_config: rateCardTaxConfigWire.optional(),
+    feature_key: resourceKeyWire.optional(),
+    discounts: rateCardDiscountsWire.optional(),
+    unit_config: unitConfigWire.optional(),
+})
+    .describe('Rate card configuration snapshot for a usage-based invoice line.');
 export const chargeUsageBasedSystemIntentWire = z
     .strictObject({
     name: z
@@ -9236,51 +9589,23 @@ export const createChargeUsageBasedRequestWire = z
     settlement_mode: settlementModeWire,
     tax_config: taxConfigWire.optional(),
     discounts: rateCardDiscountsWire.optional(),
-    feature_id: z
-        .string()
-        .describe('The feature ID associated with the charge.'),
     price: priceUsageBasedWire,
     commitments: spendCommitmentsWire.optional(),
     unit_config: unitConfigWire.optional(),
+    feature: featureReferenceWire,
     full_service_period: closedPeriodWire.optional(),
     billing_period: closedPeriodWire.optional(),
 })
     .describe('Usage-based charge create request.');
-export const rateCardWire = z
-    .strictObject({
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labelsWire.optional(),
-    key: resourceKeyWire,
-    feature: featureReferenceWire.optional(),
-    currency: billingCurrencyCodeWire.optional(),
-    billing_cadence: iso8601DurationWire.optional(),
-    price: priceWire,
-    unit_config: unitConfigWire.optional(),
-    payment_term: pricePaymentTermWire.optional(),
-    commitments: spendCommitmentsWire.optional(),
-    discounts: rateCardDiscountsWire.optional(),
-    tax_config: rateCardTaxConfigWire.optional(),
-    entitlement: rateCardEntitlementWire.optional(),
-})
-    .describe('A rate card defines the pricing and entitlement of a feature or service.');
-export const invoiceLineRateCardWire = z
+export const featureOrReferenceWire = z
+    .union([featureWire, featureReferenceWire])
+    .describe('Feature or reference.');
+export const featurePagePaginatedResponseWire = z
     .strictObject({
-    price: priceWire,
-    tax_config: rateCardTaxConfigWire.optional(),
-    feature_key: resourceKeyWire.optional(),
-    discounts: rateCardDiscountsWire.optional(),
-    unit_config: unitConfigWire.optional(),
+    data: z.array(featureWire),
+    meta: paginatedMetaWire,
 })
-    .describe('Rate card configuration snapshot for a usage-based invoice line.');
+    .describe('Page paginated response.');
 export const updateInvoiceLineRateCardWire = z
     .strictObject({
     price: updatePriceWire,
@@ -9289,12 +9614,6 @@ export const updateInvoiceLineRateCardWire = z
     discounts: updateDiscountsWire.optional(),
 })
     .describe('Rate card configuration snapshot for a usage-based invoice line.');
-export const featurePagePaginatedResponseWire = z
-    .strictObject({
-    data: z.array(featureWire),
-    meta: paginatedMetaWire,
-})
-    .describe('Page paginated response.');
 export const workflowWire = z
     .strictObject({
     collection: workflowCollectionSettingsWire.optional(),
@@ -9303,6 +9622,9 @@ export const workflowWire = z
     tax: workflowTaxSettingsWire.optional(),
 })
     .describe('Billing workflow settings.');
+export const chargeRealizationInvoiceOrReferenceWire = z
+    .union([chargeRealizationInvoiceWire, chargeRealizationInvoiceReferenceWire])
+    .describe('ChargeRealizationInvoice or reference.');
 export const appPagePaginatedResponseWire = z
     .strictObject({
     data: z.array(appWire),
@@ -9316,58 +9638,6 @@ export const profileAppsWire = z
     payment: appWire,
 })
     .describe('Applications used by a billing profile.');
-export const chargeUsageBasedWire = z
-    .strictObject({
-    id: ulidWire,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labelsWire.optional(),
-    created_at: dateTimeWire,
-    updated_at: dateTimeWire,
-    deleted_at: dateTimeWire.optional(),
-    type: z.literal('usage_based').describe('The type of the charge.'),
-    customer: billingCustomerReferenceWire,
-    lifecycle_controller: lifecycleControllerWire,
-    subscription: subscriptionReferenceWire.optional(),
-    currency: currencyCodeWire,
-    status: chargeStatusWire,
-    invoice_at: dateTimeWire,
-    service_period: closedPeriodWire,
-    full_service_period: closedPeriodWire,
-    billing_period: closedPeriodWire,
-    advance_after: dateTimeWire.optional(),
-    unique_reference_id: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlement_mode: settlementModeWire,
-    tax_config: taxConfigWire.optional(),
-    discounts: rateCardDiscountsWire.optional(),
-    feature_key: z.string().describe('The feature associated with the charge.'),
-    feature_id: z
-        .string()
-        .describe('The feature ID associated with the charge.'),
-    totals: chargeTotalsWire,
-    price: priceUsageBasedWire,
-    commitments: spendCommitmentsWire.optional(),
-    unit_config: unitConfigWire.optional(),
-    system_intent: chargeUsageBasedSystemIntentWire.optional(),
-})
-    .describe('A usage-based charge for a customer.');
-export const createChargeRequestWire = z
-    .discriminatedUnion('type', [
-    createChargeFlatFeeRequestWire,
-    createChargeUsageBasedRequestWire,
-])
-    .describe('Customer charge.');
 export const subscriptionItemWire = z
     .strictObject({
     id: ulidWire,
@@ -9511,6 +9781,12 @@ export const invoiceStandardLineWire = z
     charge: chargeReferenceWire.optional(),
 })
     .describe('A top-level line item on an invoice. Each line represents a single charge, typically associated with a rate card from a subscription. Detailed (child) lines are nested under `detailed_lines` when present.');
+export const createChargeRequestWire = z
+    .discriminatedUnion('type', [
+    createChargeFlatFeeRequestWire,
+    createChargeUsageBasedRequestWire,
+])
+    .describe('Customer charge.');
 export const updateInvoiceStandardLineWire = z
     .strictObject({
     name: z
@@ -9592,9 +9868,28 @@ export const upsertBillingProfileRequestWire = z
     default: z.boolean().describe('Whether this is the default profile.'),
 })
     .describe('BillingProfile upsert request.');
-export const chargeWire = z
-    .discriminatedUnion('type', [chargeFlatFeeWire, chargeUsageBasedWire])
-    .describe('Customer charge.');
+export const chargeRealizationWire = z
+    .strictObject({
+    id: z
+        .string()
+        .optional()
+        .describe('The ID of the realization run. Not present on `outstanding` entries, which are projections rather than persisted runs.'),
+    line_id: z
+        .string()
+        .optional()
+        .describe('The ID of the invoice line this realization was booked to, when the realization has been invoiced.'),
+    invoice: chargeRealizationInvoiceOrReferenceWire.optional(),
+    type: chargeRealizationTypeWire,
+    service_period: closedPeriodWire,
+    usage: numericWire.optional(),
+    payment: chargeRealizationPaymentWire.optional(),
+    totals: totalsWire.optional(),
+    detailed_lines: z
+        .array(chargeRealizationDetailedLineWire)
+        .optional()
+        .describe('The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.'),
+})
+    .describe("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 const subscriptionPhaseWire = z
     .strictObject({
     id: ulidWire,
@@ -9764,12 +10059,6 @@ export const profilePagePaginatedResponseWire = z
     meta: paginatedMetaWire,
 })
     .describe('Page paginated response.');
-export const chargePagePaginatedResponseWire = z
-    .strictObject({
-    data: z.array(chargeWire),
-    meta: paginatedMetaWire,
-})
-    .describe('Page paginated response.');
 export const subscriptionWire = z
     .strictObject({
     id: ulidWire,
@@ -9881,6 +10170,9 @@ export const updateInvoiceStandardRequestWire = z
         .describe('Line items on this invoice. Always returned on single-resource GET; omitted on list endpoints unless explicitly expanded. Editable via update: existing lines are matched by `id`, lines without an `id` are created, and lines present on the invoice but omitted from the update request are deleted. Detailed (child) lines are always computed and cannot be edited directly.'),
 })
     .describe('InvoiceStandard update request.');
+export const subscriptionOrReferenceWire = z
+    .union([subscriptionWire, subscriptionReferenceWire])
+    .describe('Subscription or reference.');
 export const subscriptionPagePaginatedResponseWire = z
     .strictObject({
     data: z.array(subscriptionWire),
@@ -9899,12 +10191,114 @@ export const invoiceWire = z
 export const updateInvoiceRequestWire = z
     .discriminatedUnion('type', [updateInvoiceStandardRequestWire])
     .describe('UpdateInvoiceRequest update request.');
+export const chargeFlatFeeWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z.literal('flat_fee').describe('The type of the charge.'),
+    customer: customerOrReferenceWire,
+    lifecycle_controller: lifecycleControllerWire,
+    subscription: subscriptionOrReferenceWire.optional(),
+    currency: currencyCodeWire,
+    status: chargeStatusWire,
+    invoice_at: dateTimeWire,
+    service_period: closedPeriodWire,
+    full_service_period: closedPeriodWire,
+    billing_period: closedPeriodWire,
+    advance_after: dateTimeWire.optional(),
+    unique_reference_id: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlement_mode: settlementModeWire,
+    tax_config: taxConfigWire.optional(),
+    realizations: z
+        .array(chargeRealizationWire)
+        .describe('The realization runs of the charge, sorted by `created_at`.'),
+    payment_term: pricePaymentTermWire,
+    discounts: chargeFlatFeeDiscountsWire.optional(),
+    feature: featureOrReferenceWire.optional(),
+    proration_configuration: rateCardProrationConfigurationWire,
+    amount_after_proration: currencyAmountWire,
+    price: priceFlatWire,
+    system_intent: chargeFlatFeeSystemIntentWire.optional(),
+})
+    .describe('A flat fee charge for a customer.');
+export const chargeUsageBasedWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z.literal('usage_based').describe('The type of the charge.'),
+    customer: customerOrReferenceWire,
+    lifecycle_controller: lifecycleControllerWire,
+    subscription: subscriptionOrReferenceWire.optional(),
+    currency: currencyCodeWire,
+    status: chargeStatusWire,
+    invoice_at: dateTimeWire,
+    service_period: closedPeriodWire,
+    full_service_period: closedPeriodWire,
+    billing_period: closedPeriodWire,
+    advance_after: dateTimeWire.optional(),
+    unique_reference_id: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlement_mode: settlementModeWire,
+    tax_config: taxConfigWire.optional(),
+    realizations: z
+        .array(chargeRealizationWire)
+        .describe('The realization runs of the charge, sorted by `created_at`.'),
+    discounts: rateCardDiscountsWire.optional(),
+    feature: featureOrReferenceWire,
+    totals: chargeTotalsWire,
+    usage: numericWire.optional(),
+    price: priceUsageBasedWire,
+    commitments: spendCommitmentsWire.optional(),
+    unit_config: unitConfigWire.optional(),
+    system_intent: chargeUsageBasedSystemIntentWire.optional(),
+})
+    .describe('A usage-based charge for a customer.');
 export const invoicePagePaginatedResponseWire = z
     .strictObject({
     data: z.array(invoiceWire),
     meta: paginatedMetaWire,
 })
     .describe('Page paginated response.');
+export const chargeWire = z
+    .discriminatedUnion('type', [chargeFlatFeeWire, chargeUsageBasedWire])
+    .describe('Customer charge.');
+export const chargePagePaginatedResponseWire = z
+    .strictObject({
+    data: z.array(chargeWire),
+    meta: paginatedMetaWire,
+})
+    .describe('Page paginated response.');
 export const listMeteringEventsQueryParamsWire = z.object({
     page: cursorPaginationQueryPageWire.optional(),
     filter: listEventsParamsFilterWire.optional(),
@@ -10121,7 +10515,7 @@ export const listCustomerChargesQueryParamsWire = z.object({
     expand: z
         .array(chargesExpandWire)
         .optional()
-        .describe("Expand full objects for referenced entities. Supported values are: - `real_time_usage`: Expand the charge's real-time usage."),
+        .describe("Expand full objects for referenced entities. Supported values are: - `real_time_usage`: Expand the charge's real-time usage; it sets the `usage` and the `totals.realtime` fields. - `customer`: Expand the charge's customer to the complete entity. - `feature`: Expand the charge's feature to the complete entity. - `subscription`: Expand the charge's subscription to the complete entity. - `realization.invoice`: Expand each realization's invoice to the complete entity. - `realization.totals`: Expand each realization run's `totals`. - `realization.detailed_lines`: Expand each realization run's `detailed_lines`."),
 });
 export const listCustomerChargesResponseWire = z.strictObject({
     data: z.array(chargeWire),