lago-javascript-client 1.47.1 → 1.49.0

package/esm/openapi/webhooks.d.ts

@@ -2447,7 +2447,7 @@ export interface paths {
         /**
          * List all fixed charges for a subscription
          * @description This endpoint retrieves all effective fixed charges for a specific subscription.
-         *     If the subscription has plan overrides with fixed charge overrides, the overridden fixed charges are returned.
+         *     The `units` of each fixed charge reflect any per-subscription unit override applied to the subscription; when no override exists, the plan-level units are returned.
          */
         get: operations["findAllSubscriptionFixedCharges"];
         put?: never;
@@ -2594,14 +2594,14 @@ export interface paths {
         /**
          * Retrieve a fixed charge for a subscription
          * @description This endpoint retrieves a specific effective fixed charge for a subscription.
-         *     If the subscription has a plan override with a fixed charge override, the overridden fixed charge is returned.
+         *     The `units` reflect any per-subscription unit override applied to the subscription; when no override exists, the plan-level units are returned.
          */
         get: operations["findSubscriptionFixedCharge"];
         /**
          * Override a fixed charge for a subscription
-         * @description This endpoint creates or updates a fixed charge override for a specific subscription.
-         *     If the subscription does not have a plan override yet, one will be created automatically.
-         *     The fixed charge override allows customizing specific fixed charge properties (invoice_display_name, units, properties, taxes) without affecting the original plan fixed charge.
+         * @description This endpoint creates or updates a fixed charge override for a subscription, without affecting the original plan fixed charge.
+         *     When the body contains only `units` (and optionally `apply_units_immediately`), the change is recorded as a per-subscription unit override. When the body also sets `invoice_display_name`, `properties`, or `tax_codes`, it is applied as a full plan override for the subscription instead.
+         *     With `apply_units_immediately: true` on a pay-in-advance fixed charge the change is billed mid-period; otherwise it takes effect at the next billing period.
          *     This is a premium feature.
          */
         put: operations["overrideSubscriptionFixedCharge"];
@@ -2992,6 +2992,66 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    billable_metric_created: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * A new billable metric has been created
+         * @description A new billable metric has been created
+         */
+        post: operations["billableMetricCreated"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    billable_metric_updated: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * A billable metric has been updated
+         * @description A billable metric has been updated
+         */
+        post: operations["billableMetricUpdated"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    billable_metric_deleted: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * A billable metric has been deleted
+         * @description A billable metric has been deleted
+         */
+        post: operations["billableMetricDeleted"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     customer_created: {
         parameters: {
             query?: never;
@@ -6225,6 +6285,18 @@ export interface components {
              */
             conversion_rate: string;
         };
+        /** @description Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+        PresentationBreakdownsObject: {
+            /** @description Key value list of event properties used for presentation grouping. */
+            presentation_by?: {
+                [key: string]: string;
+            };
+            /**
+             * @description The number of units consumed for a specific presentation group.
+             * @example 9.0
+             */
+            units?: string;
+        }[];
         FeeObject: {
             /**
              * Format: uuid
@@ -6515,6 +6587,7 @@ export interface components {
             applied_taxes?: components["schemas"]["FeeAppliedTaxObject"][];
             /** @description Details about the pricing unit used and amounts for this fee. */
             pricing_unit_details?: components["schemas"]["PricingUnitDetailsObject"];
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
         };
         CreditNoteItemObject: {
             /**
@@ -7766,55 +7839,6 @@ export interface components {
              */
             updated_at: string;
         };
-        BillingPeriodObject: {
-            /**
-             * Format: uuid
-             * @description Unique identifier assigned to the subscription, created by Lago.
-             * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
-             */
-            lago_subscription_id: string;
-            /**
-             * @description Unique identifier assigned to the subscription in your application.
-             * @example external_id
-             */
-            external_subscription_id: string;
-            /**
-             * Format: uuid
-             * @description Unique identifier assigned to the plan, created by Lago.
-             * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
-             */
-            lago_plan_id: string;
-            /**
-             * Format: date-time
-             * @description The beginning date of the subscription billing period. This field indicates the start date of the billing period associated with the subscription fee.
-             * @example 2022-04-29T08:59:51Z
-             */
-            subscription_from_datetime: string;
-            /**
-             * Format: date-time
-             * @description The ending date of the subscription billing period. This field indicates the end date of the billing period associated with the subscription fee.
-             * @example 2022-05-29T08:59:51Z
-             */
-            subscription_to_datetime: string;
-            /**
-             * Format: date-time
-             * @description The beginning date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the start date of the billing period or subscription period associated with the fees.
-             * @example 2022-04-29T08:59:51Z
-             */
-            charges_from_datetime: string;
-            /**
-             * Format: date-time
-             * @description The ending date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the end date of the billing period or subscription period associated with the fees.
-             * @example 2022-05-29T08:59:51Z
-             */
-            charges_to_datetime: string;
-            /**
-             * @description The reason explaining why this subscription appears on the invoice.
-             * @example subscription_starting
-             * @enum {string}
-             */
-            invoicing_reason: "subscription_starting" | "subscription_periodic" | "subscription_terminating" | "in_advance_charge" | "in_advance_charge_periodic" | "progressive_billing";
-        };
         InvoiceMetadataObject: {
             /**
              * Format: uuid
@@ -7939,7 +7963,6 @@ export interface components {
         InvoiceObject: components["schemas"]["InvoiceBaseObject"] & {
             /** @description The customer on which the invoice applies. It refers to the customer account or entity associated with the invoice. */
             customer?: components["schemas"]["CustomerObject"];
-            billing_periods?: components["schemas"]["BillingPeriodObject"][];
             metadata?: components["schemas"]["InvoiceMetadataObject"][];
             applied_taxes?: components["schemas"]["InvoiceAppliedTaxObject"][];
             /** @description The invoice custom sections applied to this invoice for PDF generation. */
@@ -8175,6 +8198,11 @@ export interface components {
              * @example 5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba
              */
             external_customer_id: string;
+            /**
+             * @description The code of the billing entity associated with the subscription.
+             * @example default
+             */
+            billing_entity_code?: string;
             /**
              * @description The billing time for the subscription, which can be set as either `anniversary` or `calendar`. If not explicitly provided, it will default to `calendar`. The billing time determines the timing of recurring billing cycles for the subscription. By specifying `anniversary`, the billing cycle will be based on the specific date the subscription started (billed fully), while `calendar` sets the billing cycle at the first day of the week/month/year (billed with proration).
              * @example anniversary
@@ -8310,6 +8338,15 @@ export interface components {
             applied_invoice_custom_sections?: components["schemas"]["AppliedInvoiceCustomSectionObject"][];
             /** @description The payment method assigned to this subscription for processing payments. */
             payment_method?: components["schemas"]["PaymentMethodReference"];
+            /**
+             * @description Controls whether this subscription is eligible to be grouped with other subscriptions of the same customer on a consolidated recurring invoice.
+             *
+             *     - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+             *     - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice, regardless of other grouping criteria.
+             * @default true
+             * @example true
+             */
+            consolidate_invoice: boolean;
         };
         SubscriptionsPaginated: {
             subscriptions: components["schemas"]["SubscriptionObject"][];
@@ -8362,6 +8399,11 @@ export interface components {
              * @example 10.0
              */
             granted_credits: string;
+            /**
+             * @description Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted.
+             * @example false
+             */
+            grants_target_top_up: boolean | null;
             /**
              * Format: date-time
              * @description The effective start date for recurring top-ups. This date should be provided in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
@@ -8442,6 +8484,11 @@ export interface components {
              * @example hooli_1234
              */
             external_customer_id: string;
+            /**
+             * @description The code of the billing entity associated with the wallet.
+             * @example default
+             */
+            billing_entity_code?: string;
             /**
              * @description The status of the wallet. Possible values are `active` or `terminated`.
              * @example active
@@ -8639,6 +8686,11 @@ export interface components {
                  * @example hooli_1234
                  */
                 external_customer_id: string;
+                /**
+                 * @description The code of the billing entity associated with the wallet. If not provided, the customer's billing entity is used.
+                 * @example default
+                 */
+                billing_entity_code?: string;
                 /**
                  * Format: date-time
                  * @description The date and time that determines when the wallet will expire. It follows the ISO 8601 datetime format and is expressed in Coordinated Universal Time (UTC).
@@ -8717,6 +8769,11 @@ export interface components {
                      * @example 10.0
                      */
                     granted_credits?: string | null;
+                    /**
+                     * @description Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted.
+                     * @example false
+                     */
+                    grants_target_top_up?: boolean | null;
                     /**
                      * @description The method used for recurring top-up. Possible values are `fixed` or `target`.
                      * @example target
@@ -8831,6 +8888,11 @@ export interface components {
                  * @example false
                  */
                 invoice_requires_successful_payment?: boolean;
+                /**
+                 * @description The code of the billing entity associated with the wallet.
+                 * @example default
+                 */
+                billing_entity_code?: string;
                 invoice_custom_section?: components["schemas"]["InvoiceCustomSectionInput"];
                 /** @description List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
                 recurring_transaction_rules?: {
@@ -8873,6 +8935,11 @@ export interface components {
                      * @example 10.0
                      */
                     granted_credits?: string | null;
+                    /**
+                     * @description Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted.
+                     * @example false
+                     */
+                    grants_target_top_up?: boolean | null;
                     /**
                      * Format: date-time
                      * @description The effective start date for recurring top-ups. This date should be provided in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
@@ -9173,6 +9240,7 @@ export interface components {
             values?: {
                 [key: string]: string[];
             };
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
         }[];
         /** @description Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
         CustomerChargeGroupedUsageObject: {
@@ -9202,6 +9270,7 @@ export interface components {
                 [key: string]: string;
             };
             filters?: components["schemas"]["CustomerChargeFiltersUsageObject"];
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
         }[];
         CustomerChargeUsageObject: {
             /**
@@ -9248,7 +9317,7 @@ export interface components {
                  * @description Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
                  * @example Setup
                  */
-                invoice_display_name?: string;
+                invoice_display_name?: string | null;
             };
             /** @description The related billable metric object. */
             billable_metric: {
@@ -9277,6 +9346,7 @@ export interface components {
             };
             filters?: components["schemas"]["CustomerChargeFiltersUsageObject"];
             grouped_usage?: components["schemas"]["CustomerChargeGroupedUsageObject"];
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
         };
         CustomerUsageObject: {
             /**
@@ -9329,6 +9399,171 @@ export interface components {
         CustomerUsage: {
             customer_usage: components["schemas"]["CustomerUsageObject"];
         };
+        /** @description Array of filter object, representing multiple dimensions for a charge item. */
+        CustomerProjectedChargeFiltersUsageObject: {
+            /**
+             * @description The number of units consumed for a specific charge filter related to a charge item.
+             * @example 0.9
+             */
+            units?: string;
+            /**
+             * @description The projected number of units that can be consumed for a specific charge filter related to a charge item.
+             * @example 1.8
+             */
+            projected_units?: string;
+            /**
+             * @description The amount in cents, tax excluded, consumed for a specific charge filter related to a charge item.
+             * @example 1000
+             */
+            amount_cents?: number;
+            /**
+             * @description The projected amount in cents, tax excluded, that can be consumed for a specific charge filter related to a charge item.
+             * @example 2000
+             */
+            projected_amount_cents?: number;
+            /**
+             * @description The quantity of usage events that have been recorded for a particular charge filter during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+             * @example 10
+             */
+            events_count?: number;
+            /**
+             * @description Specifies the name that will be displayed on an invoice.
+             * @example AWS eu-east-1
+             */
+            invoice_display_name?: string;
+            pricing_unit_details?: components["schemas"]["UsagePricingUnitDetailsObject"];
+            /**
+             * @description List of filter values applied to the usage.
+             * @example {
+             *       "region": [
+             *         "us-east-1"
+             *       ]
+             *     }
+             */
+            values?: {
+                [key: string]: string[];
+            };
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+            projected_presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+        }[];
+        /** @description Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
+        CustomerProjectedChargeGroupedUsageObject: {
+            /**
+             * @description The amount in cents, tax excluded, consumed for a specific group related to a charge item.
+             * @example 1000
+             */
+            amount_cents?: number;
+            /**
+             * @description The projected amount in cents, tax excluded, that can be consumed for a specific group related to a charge item.
+             * @example 2000
+             */
+            projected_amount_cents?: number;
+            /**
+             * @description The quantity of usage events that have been recorded for a particular charge during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+             * @example 10
+             */
+            events_count?: number;
+            /**
+             * @description The number of units consumed for a specific group related to a charge item.
+             * @example 0.9
+             */
+            units?: string;
+            /**
+             * @description The projected number of units that can be consumed for a specific group related to a charge item.
+             * @example 1.8
+             */
+            projected_units?: string;
+            pricing_unit_details?: components["schemas"]["UsagePricingUnitDetailsObject"];
+            /** @description Key value list of event properties aggregated by the charge model */
+            grouped_by?: {
+                [key: string]: string;
+            };
+            filters?: components["schemas"]["CustomerProjectedChargeFiltersUsageObject"];
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+            projected_presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+        }[];
+        CustomerProjectedChargeUsageObject: {
+            /**
+             * @description The number of units consumed by the customer for a specific charge item.
+             * @example 1.0
+             */
+            units: string;
+            /**
+             * @description The projected number of units that can be consumed by the customer for a specific charge item.
+             * @example 2.0
+             */
+            projected_units: string;
+            /**
+             * @description The quantity of usage events that have been recorded for a particular charge during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+             * @example 10
+             */
+            events_count: number;
+            /**
+             * @description The amount in cents, tax excluded, consumed by the customer for a specific charge item.
+             * @example 123
+             */
+            amount_cents: number;
+            /**
+             * @description The projected amount in cents, tax excluded, that can be consumed by the customer for a specific charge item.
+             * @example 256
+             */
+            projected_amount_cents: number;
+            /**
+             * @description The currency of a usage item consumed by the customer.
+             * @example EUR
+             */
+            amount_currency: components["schemas"]["Currency"];
+            pricing_unit_details?: components["schemas"]["UsagePricingUnitDetailsObject"];
+            /** @description Object listing all the properties for a specific charge item. */
+            charge: {
+                /**
+                 * Format: uuid
+                 * @description Unique identifier assigned to the charge within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the charge's record within the Lago system.
+                 * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+                 */
+                lago_id: string;
+                /**
+                 * @description The pricing model applied to this charge. Possible values are standard, `graduated`, `percentage`, `package` or `volume`.
+                 * @example graduated
+                 * @enum {string}
+                 */
+                charge_model: "standard" | "graduated" | "package" | "percentage" | "volume";
+                /**
+                 * @description Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+                 * @example Setup
+                 */
+                invoice_display_name?: string;
+            };
+            /** @description The related billable metric object. */
+            billable_metric: {
+                /**
+                 * Format: uuid
+                 * @description Unique identifier assigned to the billable metric within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the billable metric's record within the Lago system.
+                 * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+                 */
+                lago_id: string;
+                /**
+                 * @description The name of the billable metric used for this charge.
+                 * @example Storage
+                 */
+                name: string;
+                /**
+                 * @description The code of the billable metric used for this charge.
+                 * @example storage
+                 */
+                code: string;
+                /**
+                 * @description The aggregation type of the billable metric used for this charge. Possible values are `count_agg`, `sum_agg`, `max_agg` or `unique_count_agg`.
+                 * @example sum_agg
+                 * @enum {string}
+                 */
+                aggregation_type: "count_agg" | "sum_agg" | "max_agg" | "unique_count_agg" | "weighted_sum_agg" | "latest_agg";
+            };
+            filters?: components["schemas"]["CustomerProjectedChargeFiltersUsageObject"];
+            grouped_usage?: components["schemas"]["CustomerProjectedChargeGroupedUsageObject"];
+            presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+            projected_presentation_breakdowns?: components["schemas"]["PresentationBreakdownsObject"];
+        };
         CustomerProjectedUsageObject: {
             /**
              * Format: date-time
@@ -9380,13 +9615,13 @@ export interface components {
              */
             total_amount_cents: number;
             /** @description Array of charges that comprise the current usage. It contains detailed information about individual charge items associated with the usage. */
-            charges_usage: components["schemas"]["CustomerChargeUsageObject"][];
+            charges_usage: components["schemas"]["CustomerProjectedChargeUsageObject"][];
         };
         CustomerProjectedUsage: {
             customer_projected_usage: components["schemas"]["CustomerProjectedUsageObject"];
         };
         CustomerPastUsage: {
-            usage_periods: components["schemas"]["CustomerUsage"][];
+            usage_periods: components["schemas"]["CustomerUsageObject"][];
             meta: components["schemas"]["PaginationMeta"];
         };
         CustomerCheckoutUrl: {
@@ -9860,6 +10095,11 @@ export interface components {
                  * @example hooli_1234
                  */
                 external_customer_id: string;
+                /**
+                 * @description The code of the billing entity to issue the invoice from. If not provided, the customer's billing entity is used.
+                 * @example default
+                 */
+                billing_entity_code?: string;
                 /**
                  * @description The currency of the invoice.
                  * @example EUR
@@ -9916,7 +10156,57 @@ export interface components {
                 payment_method?: components["schemas"]["PaymentMethodReference"];
             };
         };
+        BillingPeriodObject: {
+            /**
+             * Format: uuid
+             * @description Unique identifier assigned to the subscription, created by Lago.
+             * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+             */
+            lago_subscription_id: string;
+            /**
+             * @description Unique identifier assigned to the subscription in your application.
+             * @example external_id
+             */
+            external_subscription_id: string;
+            /**
+             * Format: uuid
+             * @description Unique identifier assigned to the plan, created by Lago.
+             * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+             */
+            lago_plan_id: string;
+            /**
+             * Format: date-time
+             * @description The beginning date of the subscription billing period. This field indicates the start date of the billing period associated with the subscription fee.
+             * @example 2022-04-29T08:59:51Z
+             */
+            subscription_from_datetime: string;
+            /**
+             * Format: date-time
+             * @description The ending date of the subscription billing period. This field indicates the end date of the billing period associated with the subscription fee.
+             * @example 2022-05-29T08:59:51Z
+             */
+            subscription_to_datetime: string;
+            /**
+             * Format: date-time
+             * @description The beginning date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the start date of the billing period or subscription period associated with the fees.
+             * @example 2022-04-29T08:59:51Z
+             */
+            charges_from_datetime: string;
+            /**
+             * Format: date-time
+             * @description The ending date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the end date of the billing period or subscription period associated with the fees.
+             * @example 2022-05-29T08:59:51Z
+             */
+            charges_to_datetime: string;
+            /**
+             * @description The reason explaining why this subscription appears on the invoice.
+             * @example subscription_starting
+             * @enum {string}
+             */
+            invoicing_reason: "subscription_starting" | "subscription_periodic" | "subscription_terminating" | "in_advance_charge" | "in_advance_charge_periodic" | "progressive_billing";
+        };
         InvoiceObjectExtended: components["schemas"]["InvoiceObject"] & {
+            billing_periods?: components["schemas"]["BillingPeriodObject"][];
             credits?: components["schemas"]["CreditObject"][];
             fees?: components["schemas"]["FeeObject"][];
             subscriptions?: components["schemas"]["SubscriptionObject"][];
@@ -10385,6 +10675,11 @@ export interface components {
              * @example false
              */
             finalize_zero_amount_invoice?: boolean;
+            /**
+             * @example clickhouse
+             * @enum {string}
+             */
+            events_store?: "clickhouse" | "postgres";
         };
         Organization: {
             organization: components["schemas"]["OrganizationObject"];
@@ -10664,6 +10959,30 @@ export interface components {
                 per_unit_amount: string;
             }[];
         };
+        ChargeObjectProperties: components["schemas"]["ChargeProperties"] & {
+            /**
+             * @description Groups usage into sub-items on invoices for display only, without affecting pricing or aggregation.
+             * @example [
+             *       {
+             *         "value": "region",
+             *         "options": {
+             *           "display_in_invoice": true
+             *         }
+             *       }
+             *     ]
+             */
+            presentation_group_keys?: {
+                /**
+                 * @description The event property to group by.
+                 * @example region
+                 */
+                value?: string;
+                options?: {
+                    /** @example true */
+                    display_in_invoice?: boolean;
+                };
+            }[];
+        };
         /** @description Values used to apply differentiated pricing based on additional event properties. */
         ChargeFilterObject: {
             /**
@@ -10755,7 +11074,7 @@ export interface components {
              */
             min_amount_cents: number;
             /** @description List of all thresholds utilized for calculating the charge. */
-            properties: components["schemas"]["ChargeProperties"];
+            properties: components["schemas"]["ChargeObjectProperties"];
             /** @description List of filters used to apply differentiated pricing based on additional event properties. */
             filters: components["schemas"]["ChargeFilterObject"][];
             /** @description All taxes applied to the charge. */
@@ -10901,6 +11220,8 @@ export interface components {
             properties: components["schemas"]["FixedChargeProperties"];
             /**
              * @description The number of units for the fixed charge.
+             *
+             *     When retrieved through a subscription-scoped endpoint (e.g. `GET /subscriptions/{external_id}/fixed_charges`), this reflects the per-subscription unit override when one exists, and falls back to the plan-level units otherwise. Plan-scoped endpoints always return the plan-level units.
              * @example 1
              */
             units: number;
@@ -11573,7 +11894,7 @@ export interface components {
                      */
                     min_amount_cents?: number;
                     /** @description List of all thresholds utilized for calculating the charge. */
-                    properties?: components["schemas"]["ChargeProperties"];
+                    properties?: components["schemas"]["ChargeObjectProperties"];
                     /** @description List of filters used to apply differentiated pricing based on additional event properties. */
                     filters?: components["schemas"]["ChargeFilterInput"][];
                     tax_codes?: components["schemas"]["TaxCodes"];
@@ -11941,7 +12262,7 @@ export interface components {
                      */
                     min_amount_cents?: number;
                     /** @description List of all thresholds utilized for calculating the charge. */
-                    properties?: components["schemas"]["ChargeProperties"];
+                    properties?: components["schemas"]["ChargeObjectProperties"];
                     /** @description List of filters used to apply differentiated pricing based on additional event properties. */
                     filters?: components["schemas"]["ChargeFilterInput"][];
                     tax_codes?: components["schemas"]["TaxCodes"];
@@ -12150,7 +12471,7 @@ export interface components {
              */
             min_amount_cents?: number;
             /** @description List of all thresholds utilized for calculating the charge. */
-            properties?: components["schemas"]["ChargeProperties"];
+            properties?: components["schemas"]["ChargeObjectProperties"];
             /** @description List of filters used to apply differentiated pricing based on additional event properties. */
             filters?: components["schemas"]["ChargeFilterInput"][];
             tax_codes?: components["schemas"]["TaxCodes"];
@@ -12505,7 +12826,7 @@ export interface components {
                  */
                 min_amount_cents?: number;
                 /** @description List of all thresholds utilized for calculating the charge. */
-                properties?: components["schemas"]["ChargeProperties"];
+                properties?: components["schemas"]["ChargeObjectProperties"];
                 /** @description List of filters used to apply differentiated pricing based on additional event properties. */
                 filters?: components["schemas"]["ChargeFilterInput"][];
                 tax_codes?: components["schemas"]["TaxCodes"];
@@ -12520,7 +12841,7 @@ export interface components {
                     conversion_rate?: string;
                 };
             }[];
-            /** @description Additional fixed charges for this plan. */
+            /** @description Fixed charge overrides for the subscription. When `plan_overrides` contains only `fixed_charges` and every entry contains only `id`, `units`, and optionally `apply_units_immediately`, the units are recorded as a per-subscription override without creating a plan override, and subscription-scoped reads return these units. If any entry carries other fields, or `plan_overrides` contains any other key, the request is applied as a full plan override for the subscription instead. */
             fixed_charges?: {
                 /**
                  * Format: uuid
@@ -12619,10 +12940,20 @@ export interface components {
                  * @example 2022-08-08T00:00:00Z
                  */
                 subscription_at?: string;
+                /** @description Overrides applied to the plan for this subscription. A units-only `fixed_charges` override is recorded as a per-subscription unit override without creating a plan override; any other override creates a plan override for the subscription. See `fixed_charges` for the exact rule. */
                 plan_overrides?: components["schemas"]["PlanOverridesObject"];
                 invoice_custom_section?: components["schemas"]["InvoiceCustomSectionInput"];
                 /** @description Optional payment method to use for processing subscription payments. */
                 payment_method?: components["schemas"]["PaymentMethodReference"];
+                /**
+                 * @description Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+                 *
+                 *     - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+                 *     - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.
+                 * @default true
+                 * @example true
+                 */
+                consolidate_invoice: boolean;
             };
         };
         ApplicableUsageThreshold: {
@@ -12675,10 +13006,24 @@ export interface components {
                  * @example 2022-08-08T00:00:00Z
                  */
                 subscription_at?: string;
+                /** @description Overrides applied to the plan for this subscription. A units-only `fixed_charges` override is recorded as a per-subscription unit override without creating a plan override; any other override creates a plan override for the subscription. See `fixed_charges` for the exact rule. */
                 plan_overrides?: components["schemas"]["PlanOverridesObject"];
                 invoice_custom_section?: components["schemas"]["InvoiceCustomSectionInput"];
                 /** @description Optional payment method to use for processing subscription payments. */
                 payment_method?: components["schemas"]["PaymentMethodReference"];
+                /**
+                 * @description Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+                 *
+                 *     - `true`: the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+                 *     - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.
+                 * @example false
+                 */
+                consolidate_invoice?: boolean;
+                /**
+                 * @description The code of the billing entity associated with the subscription. Updates take effect on future invoices only.
+                 * @example default
+                 */
+                billing_entity_code?: string;
             };
         };
         Subscription: {
@@ -15734,6 +16079,8 @@ export interface operations {
                 per_page?: components["parameters"]["per_page"];
                 /** @description Filter by payment status. Possible values are `pending`, `failed` or `succeeded`. */
                 payment_status?: components["parameters"]["payment_status"];
+                /** @description Filter payment requests by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path: {
@@ -15801,6 +16148,8 @@ export interface operations {
                 plan_code?: string;
                 /** @description If the field is not defined, Lago will return only `active` subscriptions. However, if you wish to fetch subscriptions by different status you can define them in a status[] query param. Available filter values: `pending`, `canceled`, `terminated`, `active`. */
                 "status[]"?: ("pending" | "canceled" | "terminated" | "active")[];
+                /** @description Filter subscriptions by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path: {
@@ -15831,6 +16180,8 @@ export interface operations {
                 page?: components["parameters"]["page"];
                 /** @description Number of records per page. */
                 per_page?: components["parameters"]["per_page"];
+                /** @description Filter wallets by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path: {
@@ -16315,6 +16666,8 @@ export interface operations {
                 };
                 /** @description When `true`, returns usage since subscription start instead of the current billing period. Requires one of `charge_id`, `charge_code`, `group` (or their deprecated `filter_by_*` equivalents) to be set. */
                 full_usage?: boolean;
+                /** @description Filter `presentation_breakdowns` by a JSON-encoded array of presentation group key values. Only breakdowns matching the provided values will be returned. Pass an empty array to disable `presentation_breakdowns` entirely. */
+                filter_by_presentation?: string;
             };
             header?: never;
             path: {
@@ -17344,6 +17697,8 @@ export interface operations {
                 external_customer_id?: components["parameters"]["external_customer_id"];
                 /** @description Filter by payment status. Possible values are `pending`, `failed` or `succeeded`. */
                 payment_status?: components["parameters"]["payment_status"];
+                /** @description Filter payment requests by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path?: never;
@@ -18408,6 +18763,8 @@ export interface operations {
                 plan_code?: string;
                 /** @description If the field is not defined, Lago will return only `active` subscriptions. However, if you wish to fetch subscriptions by different status you can define them in a status[] query param. Available filter values: `pending`, `canceled`, `terminated`, `active`. */
                 "status[]"?: ("active" | "canceled" | "pending" | "terminated")[];
+                /** @description Filter subscriptions by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path?: never;
@@ -19490,6 +19847,8 @@ export interface operations {
                 per_page?: components["parameters"]["per_page"];
                 /** @description The customer external unique identifier (provided by your own application). */
                 external_customer_id: string;
+                /** @description Filter wallets by billing entity codes. */
+                "billing_entity_codes[]"?: string[];
             };
             header?: never;
             path?: never;
@@ -20120,6 +20479,132 @@ export interface operations {
             };
         };
     };
+    billableMetricCreated: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Signature of the webhook payload */
+                "X-Lago-Signature": components["parameters"]["webhook_signature"];
+                /** @description Algorithm used to generate the signature */
+                "X-Lago-Signature-Algorithm": components["parameters"]["webhook_signature_algorithm"];
+                /** @description Unique id of the webhook. It can be used for idempotency */
+                "X-Lago-Unique-Key": components["parameters"]["webhook_unique_key"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Details of the new billable metric */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    webhook_type: "billable_metric.created";
+                    /** @enum {string} */
+                    object_type: "billable_metric";
+                    /**
+                     * Format: uuid
+                     * @description Unique identifier of the organization, created by Lago.
+                     * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+                     */
+                    organization_id: string;
+                    billable_metric: components["schemas"]["BillableMetricObject"];
+                };
+            };
+        };
+        responses: {
+            /** @description Return a 200 status to indicate that the data was received successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    billableMetricUpdated: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Signature of the webhook payload */
+                "X-Lago-Signature": components["parameters"]["webhook_signature"];
+                /** @description Algorithm used to generate the signature */
+                "X-Lago-Signature-Algorithm": components["parameters"]["webhook_signature_algorithm"];
+                /** @description Unique id of the webhook. It can be used for idempotency */
+                "X-Lago-Unique-Key": components["parameters"]["webhook_unique_key"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Details of the billable metric */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    webhook_type: "billable_metric.updated";
+                    /** @enum {string} */
+                    object_type: "billable_metric";
+                    /**
+                     * Format: uuid
+                     * @description Unique identifier of the organization, created by Lago.
+                     * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+                     */
+                    organization_id: string;
+                    billable_metric: components["schemas"]["BillableMetricObject"];
+                };
+            };
+        };
+        responses: {
+            /** @description Return a 200 status to indicate that the data was received successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    billableMetricDeleted: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Signature of the webhook payload */
+                "X-Lago-Signature": components["parameters"]["webhook_signature"];
+                /** @description Algorithm used to generate the signature */
+                "X-Lago-Signature-Algorithm": components["parameters"]["webhook_signature_algorithm"];
+                /** @description Unique id of the webhook. It can be used for idempotency */
+                "X-Lago-Unique-Key": components["parameters"]["webhook_unique_key"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Details of the billable metric */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    webhook_type: "billable_metric.deleted";
+                    /** @enum {string} */
+                    object_type: "billable_metric";
+                    /**
+                     * Format: uuid
+                     * @description Unique identifier of the organization, created by Lago.
+                     * @example 1a901a90-1a90-1a90-1a90-1a901a901a90
+                     */
+                    organization_id: string;
+                    billable_metric: components["schemas"]["BillableMetricObject"];
+                };
+            };
+        };
+        responses: {
+            /** @description Return a 200 status to indicate that the data was received successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     customerCreated: {
         parameters: {
             query?: never;