lago-javascript-client 1.33.4 → 1.40.0

package/script/openapi/client.d.ts

@@ -59,6 +59,16 @@ export interface BillingEntityObject {
      * @example 0
      */
     invoice_grace_period: number;
+    /**
+     * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+     * @default "next_period_start"
+     */
+    subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+    /**
+     * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+     * @default "align_with_finalization_date"
+     */
+    subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     /**
      * Whether this billing entity is the default billing entity for the organization. Default billing entity will be used as fallback in services if no billing entity is specified when billing_entity is not provided. Default billing entity is the billing entity that will be used to generate invoices if no billing entity is specified when invoice is created. is the oldest active billing entity and this flag cannot be changed
      * @example false
@@ -219,6 +229,16 @@ export interface BillingEntityCreateInput {
              * @example 0
              */
             invoice_grace_period?: number;
+            /**
+             * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+             * @default "next_period_start"
+             */
+            subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+            /**
+             * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+             * @default "align_with_finalization_date"
+             */
+            subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
         };
         /**
          * The net payment term (in days) for this billing entity
@@ -468,6 +488,16 @@ export interface BillingEntityUpdateInput {
          * @example 0
          */
         invoice_grace_period?: number;
+        /**
+         * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+         * @default "next_period_start"
+         */
+        subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+        /**
+         * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+         * @default "align_with_finalization_date"
+         */
+        subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     };
     /**
      * The net payment term (in days) for this billing entity
@@ -2008,6 +2038,12 @@ export interface FeeObject {
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
     lago_charge_filter_id?: string | null;
+    /**
+     * Unique identifier assigned to the fixed charge that the fee belongs to
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_fixed_charge_id?: string | null;
     /**
      * Unique identifier assigned to the invoice that the fee belongs to
      * @format uuid
@@ -2093,6 +2129,11 @@ export interface FeeObject {
      * @example "312.5"
      */
     precise_unit_amount: string;
+    /**
+     * The total number of units that have been aggregated for this specific fee.
+     * @example "0.32"
+     */
+    total_aggregated_units: string;
     /**
      * The cost of this specific fee, including any applicable taxes.
      * @example 120
@@ -2119,13 +2160,13 @@ export interface FeeObject {
      */
     invoiceable: boolean;
     /**
-     * The beginning date of the period that the fee covers. It is applicable only to `subscription` and `charge` fees. This field indicates the start date of the billing period or subscription period associated with the fee.
+     * The beginning date of the period that the fee covers. It is applicable only to `subscription`, `charge`, `fixed_charge` and `commitment` fees. This field indicates the start date of the billing period or subscription period associated with the fee.
      * @format date-time
      * @example "2022-04-29T08:59:51Z"
      */
     from_date?: string | null;
     /**
-     * The ending date of the period that the fee covers. It is applicable only to `subscription` and `charge` fees. This field indicates the end date of the billing period or subscription period associated with the fee.
+     * The ending date of the period that the fee covers. It is applicable only to `subscription`, `charge`, `fixed_charge` and `commitment` fees. This field indicates the end date of the billing period or subscription period associated with the fee.
      * @format date-time
      * @example "2022-05-29T08:59:51Z"
      */
@@ -2184,12 +2225,12 @@ export interface FeeObject {
     /** Item attached to the fee */
     item: {
         /**
-         * The fee type. Possible values are `add-on`, `charge`, `credit`, `subscription` or `commitment`.
+         * The fee type. Possible values are `add-on`, `charge`, `fixed_charge`, `credit`, `subscription` or `commitment`.
          * @example "subscription"
          */
-        type: "charge" | "add_on" | "subscription" | "credit" | "commitment";
+        type: "charge" | "fixed_charge" | "add_on" | "subscription" | "credit" | "commitment";
         /**
-         * The code of the fee item. It can be the code of the `add-on`, the code of the `charge`, the code of the `credit` or the code of the `subscription`.
+         * The code of the fee item. It can be the code of the `add-on`, the code of the `charge`, the code of the `fixed_charge`, the code of the `credit` or the code of the `subscription`.
          * @example "startup"
          */
         code: string;
@@ -2240,7 +2281,7 @@ export interface FeeObject {
          */
         lago_item_id: string;
         /**
-         * The type of the fee item. Possible values are `AddOn`, `BillableMetric`, `WalletTransaction`, `Subscription` or `Commitment`.
+         * The type of the fee item. Possible values are `AddOn`, `BillableMetric`, `WalletTransaction`, `Subscription`.
          * @example "Subscription"
          */
         item_type: "AddOn" | "BillableMetric" | "Subscription" | "WalletTransaction";
@@ -2282,6 +2323,12 @@ export type CreditNoteAppliedTaxObject = BaseAppliedTax & {
     /** @example 100 */
     base_amount_cents?: number;
 };
+/**
+ * Custom metadata stored as key-value pairs.
+ * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+ * @example {"external_id":"ext-123","synced_at":"2024-01-15","source":null}
+ */
+export type MetadataObject = object | null;
 export interface CreditNoteErrorDetailsObject {
     /**
      * The credit note error details unique identifier, created by Lago.
@@ -2405,6 +2452,11 @@ export interface CreditNoteObject {
      * @example 0
      */
     refund_amount_cents: number;
+    /**
+     * The ofsetted amount (deducted from the invoice balance) of the credit note, expressed in cents.
+     * @example 0
+     */
+    offset_amount_cents: number;
     /**
      * The pro-rated amount of the coupons applied to the source invoice.
      * @example 20
@@ -2435,12 +2487,22 @@ export interface CreditNoteObject {
      * @example false
      */
     self_billed?: boolean;
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
     error_details?: any[] | null;
 }
 export interface CreditNotesPaginated {
     credit_notes: CreditNoteObject[];
     meta: PaginationMeta;
 }
+/**
+ * Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+ * @example {"external_id":"ext-123","synced_at":"2024-01-15"}
+ */
+export type MetadataInput = Record<string, string | null>;
 export interface CreditNoteCreateInput {
     credit_note: {
         /**
@@ -2461,18 +2523,23 @@ export interface CreditNoteCreateInput {
          */
         description?: string;
         /**
-         * The total amount to be credited to the customer balance for discounts on future invoices. For a total or partial refund or credit, the amount in cents must include both the item amount and the applicable tax. The refunded and credited amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * The total amount to be credited to the customer balance for discounts on future invoices. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
          * @example 100
          */
         credit_amount_cents?: number | null;
         /**
-         * The total amount to be refunded immediately to the payment method used by the customer. For a total or partial refund or credit, the amount in cents must include both the item amount and the applicable tax. The refunded and credited amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * The total amount to be refunded immediately to the payment method used by the customer. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
          * @example 500
          */
         refund_amount_cents?: number | null;
+        /**
+         * The total amount to be immediately deducted from the invoice balance. For a total or partial refund, credit or offset, the amount in cents must include both the item amount and the applicable tax. The refunded, credited and offsetted amounts should always balance. The total, including taxes, cannot exceed the invoice’s total fees.”
+         * @example 200
+         */
+        offset_amount_cents?: number | null;
         /**
          * The list of credit note's items.
-         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":100},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":500}]
+         * @example [{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","amount_cents":100},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","amount_cents":500},{"fee_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","amount_cents":200}]
          */
         items: {
             /**
@@ -2487,6 +2554,8 @@ export interface CreditNoteCreateInput {
              */
             amount_cents: number;
         }[];
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface CreditNote {
@@ -2503,6 +2572,8 @@ export interface CreditNoteUpdateInput {
          * @example "succeeded"
          */
         refund_status: "pending" | "succeeded" | "failed";
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface CreditNoteEstimateInput {
@@ -2580,6 +2651,11 @@ export interface CreditNoteEstimated {
          * @example 0
          */
         max_refundable_amount_cents: number;
+        /**
+         * The ofsetted amount of the credit note, expressed in cents.
+         * @example 0
+         */
+        max_offsettable_amount_cents: number;
         /**
          * The pro-rated amount of the coupons applied to the source invoice.
          * @example 20
@@ -2657,6 +2733,13 @@ export interface ApiErrorNotAllowed {
     /** @example "not_allowed" */
     code: string;
 }
+export interface CreditNoteMetadataResponse {
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata: MetadataObject;
+}
 /** @example "US" */
 export type CountryOrNull = "AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AQ" | "AR" | "AS" | "AT" | "AU" | "AW" | "AX" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BQ" | "BR" | "BS" | "BT" | "BV" | "BW" | "BY" | "BZ" | "CA" | "CC" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CX" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FM" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GF" | "GG" | "GH" | "GI" | "GL" | "GM" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GU" | "GW" | "GY" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IM" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MH" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PN" | "PR" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SH" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VG" | "VI" | "VN" | "VU" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW";
 /** @example "America/Los_Angeles" */
@@ -2668,6 +2751,18 @@ export interface CustomerBillingConfiguration {
      * @example 3
      */
     invoice_grace_period?: number;
+    /**
+     * Defines whether the issuing date follows the current billing period's end date or the next period starting date.
+     * @default null
+     * @example "next_period_start"
+     */
+    subscription_invoice_issuing_date_anchor?: "current_period_end" | "next_period_start";
+    /**
+     * The logic applied on top of the subscription_invoice_issuing_date_anchor rule. You can opt to use the invoice finalization date, that includes any configured grace period.
+     * @default null
+     * @example "keep_anchor"
+     */
+    subscription_invoice_issuing_date_adjustment?: "align_with_finalization_date" | "keep_anchor";
     /**
      * The payment provider utilized to initiate payments for invoices issued by Lago.
      * Accepted values: `stripe`, `adyen`, `gocardless` or null. This field is required if you intend to assign a `provider_customer_id`.
@@ -3876,6 +3971,11 @@ export interface WalletRecurringTransactionRule {
      * @example "Tokens for models 'high-fidelity-boost'"
      */
     transaction_name: string | null;
+    /**
+     * When true, allows rule to topped up wallet with transactions that exceed the paid top-up limits. Defaults to false.
+     * @example false
+     */
+    ignore_paid_top_up_limits: boolean;
 }
 export interface WalletObject {
     /**
@@ -3910,6 +4010,13 @@ export interface WalletObject {
      * @example "Prepaid"
      */
     name?: string | null;
+    /**
+     * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+     * @min 1
+     * @max 50
+     * @example 50
+     */
+    priority?: number;
     /**
      * The rate of conversion between credits and the amount in the specified currency. It indicates the ratio or factor used to convert credits into the corresponding monetary value in the currency of the transaction.
      * @pattern ^[0-9]+.?[0-9]*$
@@ -4005,6 +4112,21 @@ export interface WalletObject {
      * @example "2.0"
      */
     credits_ongoing_usage_balance: string;
+    /**
+     * Minimum amount of cents that can be top-up with a single paid transaction.
+     * @example 100
+     */
+    paid_top_up_min_amount_cents?: number | null;
+    /**
+     * Maximum amount of cents that can be top-up with a single paid transaction.
+     * @example 1000
+     */
+    paid_top_up_max_amount_cents?: number | null;
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
 }
 export interface WalletsPaginated {
     wallets: WalletObject[];
@@ -4036,6 +4158,12 @@ export type CustomerChargeFiltersUsageObject = {
      * @example "0.9"
      */
     units?: string;
+    /**
+     * The total number of units consumed by the customer for a specific charge item, aggregated across all usage events.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.0"
+     */
+    total_aggregated_units?: string;
     /**
      * The amount in cents, tax excluded, consumed for a specific charge filter related to a charge item.
      * @example 1000
@@ -4077,6 +4205,12 @@ export type CustomerChargeGroupedUsageObject = {
      * @example "0.9"
      */
     units?: string;
+    /**
+     * The total number of units consumed by the customer for a specific charge item, aggregated across all usage events.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.0"
+     */
+    total_aggregated_units?: string;
     /** Details about the pricing unit used for charge usage. */
     pricing_unit_details?: UsagePricingUnitDetailsObject;
     /** Key value list of event properties aggregated by the charge model */
@@ -4091,6 +4225,12 @@ export interface CustomerChargeUsageObject {
      * @example "1.0"
      */
     units: string;
+    /**
+     * The total number of units consumed by the customer for a specific charge item, aggregated across all usage events.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.0"
+     */
+    total_aggregated_units: string;
     /**
      * 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
@@ -4303,7 +4443,7 @@ export interface EventObject {
      * @format uuid
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
-    lago_id: string;
+    lago_id?: string | null;
     /**
      * This field represents a unique identifier for the event. It is crucial for ensuring idempotency, meaning that each event can be uniquely identified and processed without causing any unintended side effects.
      * @example "transaction_1234567890"
@@ -4356,7 +4496,7 @@ export interface EventObject {
      * @format date-time
      * @example "2022-04-29T08:59:51Z"
      */
-    created_at: string;
+    created_at?: string | null;
 }
 export interface EventsPaginated {
     events: EventObject[];
@@ -5601,6 +5741,138 @@ export interface ChargeObject {
         conversion_rate: string;
     };
 }
+export interface FixedChargeProperties {
+    /**
+     * - The unit price, excluding tax, for a `standard` charge model. It is expressed as a decimal value.
+     * - The amount, excluding tax, for a complete set of units in a `package` charge model. It is expressed as a decimal value.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "30"
+     */
+    amount?: string;
+    /** Graduated ranges, sorted from bottom to top tiers, used for a `graduated` charge model. */
+    graduated_ranges?: {
+        /**
+         * Specifies the lower value of a tier for a `graduated` charge model. It must be either 0 or the previous range's `to_value + 1` to maintain the proper sequence of values.
+         * @example 0
+         */
+        from_value: number;
+        /**
+         * Specifies the highest value of a tier for a `graduated` charge model.
+         * - This value must be higher than the from_value of the same tier.
+         * - This value must be null for the last tier.
+         * @example 10
+         */
+        to_value: number | null;
+        /**
+         * The flat amount for a whole tier, excluding tax, for a `graduated` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "10"
+         */
+        flat_amount: string;
+        /**
+         * The unit price, excluding tax, for a specific tier of a `graduated` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "0.5"
+         */
+        per_unit_amount: string;
+    }[];
+    /** Volume ranges, sorted from bottom to top tiers, used for a `volume` charge model. */
+    volume_ranges?: {
+        /**
+         * Specifies the lower value of a tier for a `volume` charge model. It must be either 0 or the previous range's `to_value + 1` to maintain the proper sequence of values.
+         * @example 0
+         */
+        from_value: number;
+        /**
+         * Specifies the highest value of a tier for a `volume` charge model.
+         * - This value must be higher than the `from_value` of the same tier.
+         * - This value must be `null` for the last tier.
+         * @example 10
+         */
+        to_value: number | null;
+        /**
+         * The flat amount for a whole tier, excluding tax, for a `volume` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "10"
+         */
+        flat_amount: string;
+        /**
+         * The unit price, excluding tax, for a specific tier of a `volume` charge model. It is expressed as a decimal value.
+         * @pattern ^[0-9]+.?[0-9]*$
+         * @example "0.5"
+         */
+        per_unit_amount: string;
+    }[];
+}
+export interface FixedChargeObject {
+    /**
+     * Unique identifier of the fixed charge, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * Unique identifier of the add-on associated with this fixed charge.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_add_on_id: string;
+    /**
+     * 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 fee"
+     */
+    invoice_display_name: string;
+    /**
+     * Unique code used to identify the add-on.
+     * @example "setup_fee"
+     */
+    add_on_code: string;
+    /**
+     * The date and time when the fixed charge was created. It is expressed in UTC format according to the ISO 8601 datetime standard.
+     * @format date-time
+     * @example "2023-06-27T19:43:42Z"
+     */
+    created_at: string;
+    /**
+     * Unique code for the fixed charge.
+     * @example "setup_fee"
+     */
+    code?: string;
+    /**
+     * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+     * @example "standard"
+     */
+    charge_model: "standard" | "graduated" | "volume";
+    /**
+     * This field determines the billing timing for this fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period.
+     * @example false
+     */
+    pay_in_advance: boolean;
+    /**
+     * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+     *
+     * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+     * - If set to `false`, the charge is billed in full.
+     * - If not defined in the request, default value is `false`.
+     * @example false
+     */
+    prorated: boolean;
+    /** List of all thresholds utilized for calculating the fixed charge. */
+    properties: FixedChargeProperties;
+    /**
+     * The number of units for the fixed charge.
+     * @example 1
+     */
+    units: number;
+    /**
+     * Unique identifier of the parent fixed charge (for plan versions).
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_parent_id?: string | null;
+    /** List of taxes applied to the fixed charge. */
+    taxes?: TaxObject[];
+}
 export type PlanEntitlementPrivilegeObject = FeaturePrivilegeObject & {
     /**
      * Value assigned to this privilege in the entitlement. Type depends on the privilege's value_type.
@@ -5696,18 +5968,33 @@ export interface PlanObject {
      * @example null
      */
     bill_charges_monthly?: boolean | null;
+    /**
+     * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is yearly or semiannual. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+     * @example null
+     */
+    bill_fixed_charges_monthly?: boolean | null;
     minimum_commitment?: MinimumCommitmentObject;
     /**
      * Additional usage-based charges for this plan.
      * @example [{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","billable_metric_code":"requests","created_at":"2023-06-27T19:43:42Z","charge_model":"package","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","billable_metric_code":"cpu","created_at":"2023-06-27T19:43:42Z","charge_model":"graduated","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"flat_amount":"10","per_unit_amount":"0.5"},{"from_value":11,"to_value":null,"flat_amount":"0","per_unit_amount":"0.4"}]},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","billable_metric_code":"seats","created_at":"2023-06-27T19:43:42Z","charge_model":"standard","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":true,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{},"filters":[{"invoice_display_name":"Europe","properties":{"amount":"10"},"values":{"region":["Europe"]}},{"invoice_display_name":"USA","properties":{"amount":"5"},"values":{"region":["USA"]}},{"invoice_display_name":"Africa","properties":{"amount":"8"},"values":{"region":["Africa"]}}]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","billable_metric_code":"storage","created_at":"2023-06-27T19:43:42Z","charge_model":"volume","invoiceable":true,"invoice_display_name":"Setup","pay_in_advance":false,"regroup_paid_fees":null,"prorated":false,"min_amount_cents":0,"properties":{"volume_ranges":[{"from_value":0,"to_value":100,"flat_amount":"0","per_unit_amount":"0"},{"from_value":101,"to_value":null,"flat_amount":"0","per_unit_amount":"0.5"}]},"filters":[]},{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","lago_billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","billable_metric_code":"payments","created_at":"2023-06-27T19:43:42Z","charge_model":"percentage","invoiceable":false,"invoice_display_name":"Setup","pay_in_advance":true,"regroup_paid_fees":"invoice","prorated":false,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"filters":[]}]
      */
     charges?: ChargeObject[];
+    /**
+     * List of fixed charges for this plan.
+     * @example [{"lago_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","lago_add_on_id":"2b802b80-2b80-2b80-2b80-2b802b802b80","code":"setup_fee","invoice_display_name":"Setup Fee","add_on_code":"setup","created_at":"2026-01-15T10:30:00Z","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"lago_parent_id":null,"taxes":[{"lago_id":"3c703c70-3c70-3c70-3c70-3c703c703c70","name":"VAT","code":"vat_20","rate":20,"description":"Standard VAT rate","applied_to_organization":true,"created_at":"2026-01-01T00:00:00Z"}]},{"lago_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","lago_add_on_id":"5e505e50-5e50-5e50-5e50-5e505e505e50","code":"support_tier","invoice_display_name":"Support Tier","add_on_code":"premium_support","created_at":"2026-01-15T10:30:00Z","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":1,"lago_parent_id":null,"taxes":[]},{"lago_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","lago_add_on_id":"7a307a30-7a30-7a30-7a30-7a307a307a30","code":"storage","invoice_display_name":"Storage Allocation","add_on_code":"cloud_storage","created_at":"2026-01-15T10:30:00Z","charge_model":"volume","pay_in_advance":false,"prorated":false,"properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50,"lago_parent_id":null,"taxes":[]}]
+     */
+    fixed_charges?: FixedChargeObject[];
     /** All taxes applied to the plan. */
     taxes?: TaxObject[];
     /** List of usage thresholds applied to the plan. */
     usage_thresholds?: UsageThresholdObject[];
     /** List of all feature entitlements and their privileges available for this plan. */
     entitlements?: PlanEntitlement[];
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata?: MetadataObject;
 }
 export interface PlansPaginated {
     plans: PlanObject[];
@@ -5767,52 +6054,57 @@ export interface PlanCreateInput {
          * The name of the plan.
          * @example "Startup"
          */
-        name?: string;
+        name: string;
         /**
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the plan will be used as the default display name.
          * @example "Startup plan"
          */
-        invoice_display_name?: string;
+        invoice_display_name?: string | null;
         /**
          * The code of the plan. It serves as a unique identifier associated with a particular plan. The code is typically used for internal or system-level identification purposes, like assigning a subscription, for instance.
          * @example "startup"
          */
-        code?: string;
+        code: string;
         /**
          * The interval used for recurring billing. It represents the frequency at which subscription billing occurs. The interval can be one of the following values: `yearly`, `semiannual`, `quarterly`, `monthly`, or `weekly`.
          * @example "monthly"
          */
-        interval?: "weekly" | "monthly" | "quarterly" | "semiannual" | "yearly";
+        interval: "weekly" | "monthly" | "quarterly" | "semiannual" | "yearly";
         /**
          * The description on the plan.
          * @example "Plan for early stage startups."
          */
-        description?: string;
+        description?: string | null;
         /**
          * The base cost of the plan, excluding any applicable taxes, that is billed on a recurring basis. This value is defined at 0 if your plan is a pay-as-you-go plan.
          * @example 10000
          */
-        amount_cents?: number;
+        amount_cents: number;
         /**
          * The currency of the plan. It indicates the monetary unit in which the plan's cost, including taxes and usage-based charges, is expressed.
          * @example "USD"
          */
-        amount_currency?: Currency;
+        amount_currency: Currency;
         /**
          * The duration in days during which the base cost of the plan is offered for free.
          * @example 5
          */
-        trial_period?: number;
+        trial_period?: number | null;
         /**
          * This field determines the billing timing for the plan. When set to `true`, the base cost of the plan is due at the beginning of each billing period. Conversely, when set to `false`, the base cost of the plan is due at the end of each billing period.
          * @example true
          */
-        pay_in_advance?: boolean;
+        pay_in_advance: boolean;
         /**
          * This field, when set to `true`, enables to invoice usage-based charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay charges overage on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
          * @example null
          */
         bill_charges_monthly?: boolean | null;
+        /**
+         * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+         * @example null
+         */
+        bill_fixed_charges_monthly?: boolean | null;
         /** List of unique code used to identify the taxes. */
         tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
@@ -5827,7 +6119,7 @@ export interface PlanCreateInput {
              * @format uuid
              * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
              */
-            billable_metric_id?: string;
+            billable_metric_id: string;
             /**
              * Specifies the pricing model used for the calculation of the final fee. It can be any of the following values:
              *   - [`dynamic`](https://docs.getlago.com/guide/plans/charges/charge-models/dynamic)
@@ -5838,7 +6130,7 @@ export interface PlanCreateInput {
              *   - [`standard`](https://docs.getlago.com/guide/plans/charges/charge-models/standard)
              *   - [`volume`](https://docs.getlago.com/guide/plans/charges/charge-models/volume)
              */
-            charge_model?: ChargeModelEnum;
+            charge_model: ChargeModelEnum;
             /**
              * This field determines the billing timing for this specific usage-based charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period.
              * @example false
@@ -5899,8 +6191,65 @@ export interface PlanCreateInput {
                 conversion_rate?: string;
             };
         }[];
+        /**
+         * Additional fixed charges for this plan.
+         * @example [{"add_on_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","code":"setup_fee","invoice_display_name":"Setup Fee","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"tax_codes":["french_standard_vat"]},{"add_on_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","invoice_display_name":"Support Tier","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":2},{"add_on_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","charge_model":"volume","properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50}]
+         */
+        fixed_charges?: {
+            /**
+             * Unique identifier of the add-on associated with this fixed charge.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            add_on_id: string;
+            /**
+             * Unique code for the fixed charge. If not provided, it will be automatically generated based on the add-on code.
+             * @example "setup_fee"
+             */
+            code?: string;
+            /**
+             * 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 fee"
+             */
+            invoice_display_name?: string;
+            /**
+             * The number of units for the fixed charge. Defaults to 0 if not provided.
+             * @default 0
+             * @example 1
+             */
+            units?: number;
+            /**
+             * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+             * @example "standard"
+             */
+            charge_model: "standard" | "graduated" | "volume";
+            /**
+             * This field determines the billing timing for this specific fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period. Defaults to `false` if not provided.
+             * @default false
+             * @example false
+             */
+            pay_in_advance?: boolean;
+            /**
+             * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+             *
+             * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+             * - If set to `false`, the charge is billed in full.
+             * - Defaults to `false` if not provided.
+             *
+             * Note: Prorated fixed charges with `graduated` model and `pay_in_advance` are not allowed.
+             * @default false
+             * @example false
+             */
+            prorated?: boolean;
+            /** List of all thresholds utilized for calculating the fixed charge. */
+            properties?: FixedChargeProperties;
+            /** List of taxes applied to the fixed charge. */
+            tax_codes?: TaxCodes;
+        }[];
         /** List of usage thresholds to apply to the plan. */
         usage_thresholds?: UsageThresholdInput[];
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface Plan {
@@ -5917,7 +6266,7 @@ export interface PlanUpdateInput {
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the plan will be used as the default display name.
          * @example "Startup plan"
          */
-        invoice_display_name?: string;
+        invoice_display_name?: string | null;
         /**
          * The code of the plan. It serves as a unique identifier associated with a particular plan. The code is typically used for internal or system-level identification purposes, like assigning a subscription, for instance.
          * @example "startup"
@@ -5932,7 +6281,7 @@ export interface PlanUpdateInput {
          * The description on the plan.
          * @example "Plan for early stage startups."
          */
-        description?: string;
+        description?: string | null;
         /**
          * The base cost of the plan, excluding any applicable taxes, that is billed on a recurring basis. This value is defined at 0 if your plan is a pay-as-you-go plan.
          * @example 10000
@@ -5947,7 +6296,7 @@ export interface PlanUpdateInput {
          * The duration in days during which the base cost of the plan is offered for free.
          * @example 5
          */
-        trial_period?: number;
+        trial_period?: number | null;
         /**
          * This field determines the billing timing for the plan. When set to `true`, the base cost of the plan is due at the beginning of each billing period. Conversely, when set to `false`, the base cost of the plan is due at the end of each billing period.
          * @example true
@@ -5958,6 +6307,11 @@ export interface PlanUpdateInput {
          * @example null
          */
         bill_charges_monthly?: boolean | null;
+        /**
+         * This field, when set to `true`, enables to invoice fixed charges on monthly basis, even if the cadence of the plan is `yearly` or `semiannual`. This allows customers to pay fixed charges on a monthly basis. This can be set to true only if the plan's interval is `yearly` or `semiannual`.
+         * @example null
+         */
+        bill_fixed_charges_monthly?: boolean | null;
         /** List of unique code used to identify the taxes. */
         tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
@@ -6045,6 +6399,72 @@ export interface PlanUpdateInput {
                 conversion_rate?: string;
             };
         }[];
+        /**
+         * Additional fixed charges for this plan.
+         * @example [{"id":"1a901a90-1a90-1a90-1a90-1a901a901a90","invoice_display_name":"New Setup Fee","charge_model":"standard","apply_units_immediately":true,"units":5},{"add_on_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","code":"setup_fee","invoice_display_name":"Setup Fee","charge_model":"standard","pay_in_advance":true,"prorated":false,"properties":{"amount":"500"},"units":1,"apply_units_immediately":false,"tax_codes":["french_standard_vat"]},{"add_on_id":"4d604d60-4d60-4d60-4d60-4d604d604d60","invoice_display_name":"Support Tier","charge_model":"graduated","pay_in_advance":false,"prorated":true,"properties":{"graduated_ranges":[{"from_value":0,"to_value":10,"per_unit_amount":"5","flat_amount":"200"},{"from_value":11,"to_value":null,"per_unit_amount":"1","flat_amount":"300"}]},"units":2},{"add_on_id":"6f406f40-6f40-6f40-6f40-6f406f406f40","charge_model":"volume","properties":{"volume_ranges":[{"from_value":0,"to_value":100,"per_unit_amount":"2","flat_amount":"1"},{"from_value":101,"to_value":null,"per_unit_amount":"1","flat_amount":"0"}]},"units":50}]
+         */
+        fixed_charges?: {
+            /**
+             * Unique identifier of the fixed charge created by Lago (required for updates).
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            id?: string;
+            /**
+             * Unique identifier of the add-on associated with this fixed charge.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            add_on_id?: string;
+            /**
+             * Unique code for the fixed charge. If not provided, it will be automatically generated based on the add-on code.
+             * @example "setup_fee"
+             */
+            code?: string;
+            /**
+             * 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 fee"
+             */
+            invoice_display_name?: string;
+            /**
+             * The number of units for the fixed charge. Defaults to 0 if not provided.
+             * @default 0
+             * @example 1
+             */
+            units?: number;
+            /**
+             * The charge model for the fixed charge. Only `standard`, `graduated`, and `volume` models are supported for fixed charges.
+             * @example "standard"
+             */
+            charge_model?: "standard" | "graduated" | "volume";
+            /**
+             * This field determines the billing timing for this specific fixed charge. When set to `true`, the charge is due and invoiced immediately. Conversely, when set to false, the charge is due and invoiced at the end of each billing period. Defaults to `false` if not provided.
+             * @default false
+             * @example false
+             */
+            pay_in_advance?: boolean;
+            /**
+             * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
+             *
+             * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
+             * - If set to `false`, the charge is billed in full.
+             * - Defaults to `false` if not provided.
+             *
+             * Note: Prorated fixed charges with `graduated` model and `pay_in_advance` are not allowed.
+             * @default false
+             * @example false
+             */
+            prorated?: boolean;
+            /** List of all thresholds utilized for calculating the fixed charge. */
+            properties?: FixedChargeProperties;
+            /** List of taxes applied to the fixed charge. */
+            tax_codes?: TaxCodes;
+            /**
+             * Determines if the units should be applied immediately upon assignment or deferred to the next billing cycle.
+             * @example true
+             */
+            apply_units_immediately?: boolean;
+        }[];
         /** List of usage thresholds to apply to the plan. */
         usage_thresholds?: UsageThresholdInput[];
         /**
@@ -6052,6 +6472,8 @@ export interface PlanUpdateInput {
          * @example true
          */
         cascade_updates?: boolean;
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface PlanEntitlements {
@@ -6064,6 +6486,13 @@ export interface EntitlementUpdateInput {
      */
     entitlements: Record<string, Record<string, number | boolean | string>>;
 }
+export interface PlanMetadataResponse {
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata: MetadataObject;
+}
 /** Based plan overrides. */
 export interface PlanOverridesObject {
     /**
@@ -6152,32 +6581,63 @@ export interface PlanOverridesObject {
             conversion_rate?: string;
         };
     }[];
+    /** Additional fixed charges for this plan. */
+    fixed_charges?: {
+        /**
+         * Unique identifier of the fixed charge created by Lago.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        id: string;
+        /**
+         * 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 fee"
+         */
+        invoice_display_name?: string;
+        /**
+         * The number of units for the fixed charge. Defaults to 0 if not provided.
+         * @default 0
+         * @example 1
+         */
+        units?: number;
+        /**
+         * Determines if the units should be applied immediately upon assignment or deferred to the next billing cycle.
+         * @example true
+         */
+        apply_units_immediately?: boolean;
+        /** List of all thresholds utilized for calculating the fixed charge. */
+        properties?: FixedChargeProperties;
+        /** List of taxes applied to the fixed charge. */
+        tax_codes?: TaxCodes;
+    }[];
     /** List of usage thresholds applied to the subscription. */
     usage_thresholds?: UsageThresholdInput[];
+    /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+    metadata?: MetadataInput;
 }
 export interface SubscriptionCreateInput {
-    subscription: {
+    /**
+     * Optionally, you can create a pre-authorization on the customer's card before creating a subscription. This process places a temporary hold (capture) for a specified amount on the customer's account, but does not actually withdraw the funds.
+     *
+     * Important notes:
+     *   - The final amount due for the subscription is not known at the time of creation; it is determined only after the invoice is finalized.
+     *   - The payment intent generated for pre-authorization cannot be reused, as the final invoice amount may exceed the authorized amount.
+     *   - The payment intent is canceled immediately after creation, but this cancellation occurs asynchronously.
+     *   - For these reasons, it is recommended to use a small amount (such as $1) for pre-authorization. While this does not guarantee sufficient funds for the final payment, it helps reduce the likelihood of payment errors.
+     */
+    authorization?: {
         /**
-         * Optionally, you can create a pre-authorization on the customer's card before creating a subscription. This process places a temporary hold (capture) for a specified amount on the customer's account, but does not actually withdraw the funds.
-         *
-         * Important notes:
-         *   - The final amount due for the subscription is not known at the time of creation; it is determined only after the invoice is finalized.
-         *   - The payment intent generated for pre-authorization cannot be reused, as the final invoice amount may exceed the authorized amount.
-         *   - The payment intent is canceled immediately after creation, but this cancellation occurs asynchronously.
-         *   - For these reasons, it is recommended to use a small amount (such as $1) for pre-authorization. While this does not guarantee sufficient funds for the final payment, it helps reduce the likelihood of payment errors.
+         * The amount of the authorization in cents.
+         * @example 1000
          */
-        authorization?: {
-            /**
-             * The amount of the authorization in cents.
-             * @example 1000
-             */
-            amount_cents: number;
-            /**
-             * The currency of the authorization.
-             * @example "USD"
-             */
-            amount_currency: string;
-        };
+        amount_cents: number;
+        /**
+         * The currency of the authorization.
+         * @example "USD"
+         */
+        amount_currency: string;
+    };
+    subscription: {
         /**
          * The code of the billing entity to be used for the subscription. If not provided, the default billing entity will be used.
          * @example "default"
@@ -6374,12 +6834,12 @@ export interface AlertObject {
      * The subscription external unique identifier (provided by your own application).
      * @example "sub_1234567890"
      */
-    subscription_external_id: string;
+    external_subscription_id: string;
     /**
      * The customer external unique identifier (provided by your own application).
      * @example "cus_0987654321"
      */
-    customer_external_id: string;
+    external_customer_id: string;
     /** The billable metric associated with the alert. Only for alerts based on a billable metric. */
     billable_metric: BillableMetricObject;
     /**
@@ -6514,6 +6974,9 @@ export interface SubscriptionEntitlements {
 export interface SubscriptionEntitlement {
     entitlement: SubscriptionEntitlementObject;
 }
+export interface FixedCharges {
+    fixed_charges: FixedChargeObject[];
+}
 export interface TaxesPaginated {
     taxes: TaxObject[];
     meta: PaginationMeta;
@@ -6563,6 +7026,13 @@ export interface WalletCreateInput {
          * @example "Prepaid"
          */
         name?: string | null;
+        /**
+         * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+         * @min 1
+         * @max 50
+         * @example 50
+         */
+        priority?: number;
         /**
          * The rate of conversion between credits and the amount in the specified currency. It indicates the ratio or factor used to convert credits into the corresponding monetary value in the currency of the transaction.
          * @pattern ^[0-9]+.?[0-9]*$
@@ -6625,8 +7095,25 @@ export interface WalletCreateInput {
              */
             billable_metric_codes?: any[] | null;
         };
+        /**
+         * Minimum amount of cents that can be top-up with a single paid transaction.
+         * @example 100
+         */
+        paid_top_up_min_amount_cents?: number | null;
+        /**
+         * Maximum amount of cents that can be top-up with a single paid transaction.
+         * @example 1000
+         */
+        paid_top_up_max_amount_cents?: number | null;
+        /**
+         * If set to true, the wallet will ignore paid top-up limits on creation.
+         * @example false
+         */
+        ignore_paid_top_up_limits_on_creation?: boolean | null;
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
         recurring_transaction_rules?: any[] | null;
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
 export interface Wallet {
@@ -6639,6 +7126,13 @@ export interface WalletUpdateInput {
          * @example "new_name"
          */
         name?: string | null;
+        /**
+         * Wallet priority for ordering when a customer has multiple wallets. Allowed values: 1-50, where 1 is highest priority and 50 is lowest. Defaults to 50.
+         * @min 1
+         * @max 50
+         * @example 50
+         */
+        priority?: number;
         /**
          * 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).
          * @format date-time
@@ -6743,8 +7237,17 @@ export interface WalletUpdateInput {
              */
             billable_metric_codes?: any[] | null;
         };
+        /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
+        metadata?: MetadataInput;
     };
 }
+export interface WalletMetadataResponse {
+    /**
+     * Custom metadata stored as key-value pairs.
+     * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
+     */
+    metadata: MetadataObject;
+}
 export interface WalletTransactionCreateInput {
     wallet_transaction: {
         /**
@@ -6783,6 +7286,11 @@ export interface WalletTransactionCreateInput {
          * @example false
          */
         invoice_requires_successful_payment?: boolean;
+        /**
+         * When true, allows topping up the wallet with transactions that exceed the paid top-up limits. Defaults to false.
+         * @example false
+         */
+        ignore_paid_top_up_limits?: boolean;
         /**
          * This optional field allows you to store a list of key-value pairs that hold additional information or custom attributes related to the data.
          * @example [{"key":"example key","value":"example value"},{"key":"another key","value":"another value"}]
@@ -7004,7 +7512,7 @@ export interface TriggeredAlertObject {
      * The subscription external unique identifier (provided by your own application).
      * @example "sub_1234567890"
      */
-    subscription_external_id: string;
+    external_subscription_id: string;
     /**
      * The code of the billable metric associated with the alert. Only for alerts based on a billable metric.
      * @example "storage_usage"
@@ -7168,7 +7676,7 @@ export interface DunningCampaignFinishedObject {
      * The customer external unique identifier (provided by your own application).
      * @example "cus_0987654321"
      */
-    customer_external_id: string;
+    external_customer_id: string;
     /**
      * Identifier of the dunning campaign.
      * @example "dun_code_1234"
@@ -7468,7 +7976,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.33.3
+ * @version 1.40.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -8302,6 +8810,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         voidCreditNote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNote, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a credit note with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags credit_notes
+         * @name ReplaceCreditNoteMetadata
+         * @summary Replace credit note metadata
+         * @request POST:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        replaceCreditNoteMetadata: (lagoId: string, data: CreditNoteMetadataResponse, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the credit note. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags credit_notes
+         * @name MergeCreditNoteMetadata
+         * @summary Merge credit note metadata
+         * @request PATCH:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        mergeCreditNoteMetadata: (lagoId: string, data: CreditNoteMetadataResponse, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a credit note.
+         *
+         * @tags credit_notes
+         * @name DeleteAllCreditNoteMetadata
+         * @summary Delete all credit note metadata
+         * @request DELETE:/credit_notes/{lago_id}/metadata
+         * @secure
+         */
+        deleteAllCreditNoteMetadata: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a credit note.
+         *
+         * @tags credit_notes
+         * @name DeleteCreditNoteMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/credit_notes/{lago_id}/metadata/{key}
+         * @secure
+         */
+        deleteCreditNoteMetadataKey: (lagoId: string, key: string, params?: RequestParams) => Promise<HttpResponse<CreditNoteMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     customers: {
         /**
@@ -8344,6 +8892,51 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example ["billing_entity_code_1","billing_entity_code_2"]
              */
             "billing_entity_codes[]"?: string[];
+            /**
+             * Filter customers by search term. This will filter all customers whose name, firstname, lastname, legal name, external id or email contain the search term.
+             * @example "John Doe"
+             */
+            search_term?: string;
+            /**
+             * Filter customers by countries. Possible values are the ISO 3166-1 alpha-2 codes.
+             * @example ["US","FR"]
+             */
+            "countries[]"?: Country[];
+            /**
+             * Filter customers by states.
+             * @example ["CA","Paris"]
+             */
+            "states[]"?: string[];
+            /**
+             * Filter customers by zipcodes.
+             * @example ["10115","75001"]
+             */
+            "zipcodes[]"?: string[];
+            /**
+             * Filter customers by currencies.
+             * @example ["USD","EUR"]
+             */
+            "currencies[]"?: Currency[];
+            /**
+             * Filter customers by whether they have a tax identification number or not.
+             * @example true
+             */
+            has_tax_identification_number?: boolean;
+            /**
+             * Filter customers by metadata. Replace `key` with the actual metadata key you want to match, and provide the corresponding value. Providing empty value will search for customers without given metadata key. For example, `metadata[is_synced]=true&metadata[last_synced_at]=`.
+             * @example "value"
+             */
+            "metadata[key]"?: string;
+            /**
+             * Filter customers by customer type.
+             * @example "company"
+             */
+            customer_type?: "company" | "individual";
+            /**
+             * Filter customers by whether they have a customer type or not.
+             * @example true
+             */
+            has_customer_type?: boolean;
         }, params?: RequestParams) => Promise<HttpResponse<CustomersPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint retrieves an existing customer.
@@ -8799,6 +9392,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "event-123"
              */
             code?: string;
+            /**
+             * Requires `external_subscription_id` to be set. Filter events by timestamp after the subscription started at datetime.
+             * @example true
+             */
+            timestamp_from_started_at?: boolean;
             /**
              * Filter events by timestamp starting from a specific date.
              * @format date-time
@@ -8853,7 +9451,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         eventBatchEstimateInstantFees: (data: EventBatchEstimateInstantFeesInput, params?: RequestParams) => Promise<HttpResponse<FeesEstimate, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorForbidden | ApiErrorNotFound>>;
         /**
-         * @description This endpoint is used for retrieving a specific usage measurement event that has been sent to a customer or a subscription.
+         * @description This endpoint is used for retrieving a specific usage measurement event that has been sent to a customer or a subscription. Note that transaction_id is unique per external_subscription_id so multiple subscriptions can share the same transaction_id. This endpoint will only return the first event found with the given transaction_id. WARNING: If your Lago organization is configured to use the Clickhouse-based event pipeline, multiple events can share the same `transaction_id` (with different timestamps). This endpoint will only return the first event found.
          *
          * @tags events
          * @name FindEvent
@@ -9486,6 +10084,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         removeEntitlementPrivilege: (code: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a plan with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags plans
+         * @name ReplacePlanMetadata
+         * @summary Replace plan metadata
+         * @request POST:/plans/{code}/metadata
+         * @secure
+         */
+        replacePlanMetadata: (code: string, data: PlanMetadataResponse, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the plan. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags plans
+         * @name MergePlanMetadata
+         * @summary Merge plan metadata
+         * @request PATCH:/plans/{code}/metadata
+         * @secure
+         */
+        mergePlanMetadata: (code: string, data: PlanMetadataResponse, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a plan.
+         *
+         * @tags plans
+         * @name DeleteAllPlanMetadata
+         * @summary Delete all plan metadata
+         * @request DELETE:/plans/{code}/metadata
+         * @secure
+         */
+        deleteAllPlanMetadata: (code: string, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a plan.
+         *
+         * @tags plans
+         * @name DeletePlanMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/plans/{code}/metadata/{key}
+         * @secure
+         */
+        deletePlanMetadataKey: (code: string, key: string, params?: RequestParams) => Promise<HttpResponse<PlanMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     subscriptions: {
         /**
@@ -9717,6 +10355,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         destroySubscriptionEntitlementPrivilege: (externalId: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlement, ApiErrorUnauthorized | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves all fixed charges for a specific subscription.
+         *
+         * @tags subscriptions
+         * @name FindAllSubscriptionFixedCharges
+         * @summary List subscription fixed charges
+         * @request GET:/subscriptions/{external_id}/fixed_charges
+         * @secure
+         */
+        findAllSubscriptionFixedCharges: (externalId: string, params?: RequestParams) => Promise<HttpResponse<FixedCharges, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     taxes: {
         /**
@@ -9848,6 +10496,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         destroyWallet: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Wallet, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint replaces all existing metadata on a wallet with the provided key-value pairs. Any existing metadata keys not included in the request will be removed.
+         *
+         * @tags wallets
+         * @name ReplaceWalletMetadata
+         * @summary Replace wallet metadata
+         * @request POST:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        replaceWalletMetadata: (lagoId: string, data: WalletMetadataResponse, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint merges the provided metadata with existing metadata on the wallet. Existing keys not in the request are preserved. New keys are added, existing keys are updated.
+         *
+         * @tags wallets
+         * @name MergeWalletMetadata
+         * @summary Merge wallet metadata
+         * @request PATCH:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        mergeWalletMetadata: (lagoId: string, data: WalletMetadataResponse, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes all metadata from a wallet.
+         *
+         * @tags wallets
+         * @name DeleteAllWalletMetadata
+         * @summary Delete all wallet metadata
+         * @request DELETE:/wallets/{lago_id}/metadata
+         * @secure
+         */
+        deleteAllWalletMetadata: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a single metadata key from a wallet.
+         *
+         * @tags wallets
+         * @name DeleteWalletMetadataKey
+         * @summary Delete a metadata key
+         * @request DELETE:/wallets/{lago_id}/metadata/{key}
+         * @secure
+         */
+        deleteWalletMetadataKey: (lagoId: string, key: string, params?: RequestParams) => Promise<HttpResponse<WalletMetadataResponse, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint is used to list all wallet transactions.
          *