lago-javascript-client 1.32.0 → 1.33.1

package/script/openapi/client.d.ts

@@ -3,7 +3,7 @@ export type Currency = "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "
 /** @example "US" */
 export type Country = "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" */
-export type Timezone = "UTC" | "Africa/Algiers" | "Africa/Cairo" | "Africa/Casablanca" | "Africa/Harare" | "Africa/Johannesburg" | "Africa/Monrovia" | "Africa/Nairobi" | "America/Argentina/Buenos_Aires" | "America/Bogota" | "America/Caracas" | "America/Chicago" | "America/Chihuahua" | "America/Denver" | "America/Godthab" | "America/Guatemala" | "America/Guyana" | "America/Halifax" | "America/Indiana/Indianapolis" | "America/Juneau" | "America/La_Paz" | "America/Lima" | "America/Los_Angeles" | "America/Mazatlan" | "America/Mexico_City" | "America/Monterrey" | "America/Montevideo" | "America/New_York" | "America/Phoenix" | "America/Puerto_Rico" | "America/Regina" | "America/Santiago" | "America/Sao_Paulo" | "America/St_Johns" | "America/Tijuana" | "Asia/Almaty" | "Asia/Baghdad" | "Asia/Baku" | "Asia/Bangkok" | "Asia/Chongqing" | "Asia/Colombo" | "Asia/Dhaka" | "Asia/Hong_Kong" | "Asia/Irkutsk" | "Asia/Jakarta" | "Asia/Jerusalem" | "Asia/Kabul" | "Asia/Kamchatka" | "Asia/Karachi" | "Asia/Kathmandu" | "Asia/Kolkata" | "Asia/Krasnoyarsk" | "Asia/Kuala_Lumpur" | "Asia/Kuwait" | "Asia/Magadan" | "Asia/Muscat" | "Asia/Novosibirsk" | "Asia/Rangoon" | "Asia/Riyadh" | "Asia/Seoul" | "Asia/Shanghai" | "Asia/Singapore" | "Asia/Srednekolymsk" | "Asia/Taipei" | "Asia/Tashkent" | "Asia/Tbilisi" | "Asia/Tehran" | "Asia/Tokyo" | "Asia/Ulaanbaatar" | "Asia/Urumqi" | "Asia/Vladivostok" | "Asia/Yakutsk" | "Asia/Yekaterinburg" | "Asia/Yerevan" | "Atlantic/Azores" | "Atlantic/Cape_Verde" | "Atlantic/South_Georgia" | "Australia/Adelaide" | "Australia/Brisbane" | "Australia/Darwin" | "Australia/Hobart" | "Australia/Melbourne" | "Australia/Perth" | "Australia/Sydney" | "Europe/Amsterdam" | "Europe/Athens" | "Europe/Belgrade" | "Europe/Berlin" | "Europe/Bratislava" | "Europe/Brussels" | "Europe/Bucharest" | "Europe/Budapest" | "Europe/Copenhagen" | "Europe/Dublin" | "Europe/Helsinki" | "Europe/Istanbul" | "Europe/Kaliningrad" | "Europe/Kiev" | "Europe/Lisbon" | "Europe/Ljubljana" | "Europe/London" | "Europe/Madrid" | "Europe/Minsk" | "Europe/Moscow" | "Europe/Paris" | "Europe/Prague" | "Europe/Riga" | "Europe/Rome" | "Europe/Samara" | "Europe/Sarajevo" | "Europe/Skopje" | "Europe/Sofia" | "Europe/Stockholm" | "Europe/Tallinn" | "Europe/Vienna" | "Europe/Vilnius" | "Europe/Volgograd" | "Europe/Warsaw" | "Europe/Zagreb" | "Europe/Zurich" | "GMT+12" | "Pacific/Apia" | "Pacific/Auckland" | "Pacific/Chatham" | "Pacific/Fakaofo" | "Pacific/Fiji" | "Pacific/Guadalcanal" | "Pacific/Guam" | "Pacific/Honolulu" | "Pacific/Majuro" | "Pacific/Midway" | "Pacific/Noumea" | "Pacific/Pago_Pago" | "Pacific/Port_Moresby" | "Pacific/Tongatapu";
+export type Timezone = "UTC" | "Africa/Algiers" | "Africa/Cairo" | "Africa/Casablanca" | "Africa/Harare" | "Africa/Johannesburg" | "Africa/Monrovia" | "Africa/Nairobi" | "America/Argentina/Buenos_Aires" | "America/Bogota" | "America/Caracas" | "America/Chicago" | "America/Chihuahua" | "America/Denver" | "America/Guatemala" | "America/Guyana" | "America/Halifax" | "America/Indiana/Indianapolis" | "America/Juneau" | "America/La_Paz" | "America/Lima" | "America/Los_Angeles" | "America/Mazatlan" | "America/Mexico_City" | "America/Monterrey" | "America/Montevideo" | "America/New_York" | "America/Nuuk" | "America/Phoenix" | "America/Puerto_Rico" | "America/Regina" | "America/Santiago" | "America/Sao_Paulo" | "America/St_Johns" | "America/Tijuana" | "Asia/Almaty" | "Asia/Baghdad" | "Asia/Baku" | "Asia/Bangkok" | "Asia/Chongqing" | "Asia/Colombo" | "Asia/Dhaka" | "Asia/Hong_Kong" | "Asia/Irkutsk" | "Asia/Jakarta" | "Asia/Jerusalem" | "Asia/Kabul" | "Asia/Kamchatka" | "Asia/Karachi" | "Asia/Kathmandu" | "Asia/Kolkata" | "Asia/Krasnoyarsk" | "Asia/Kuala_Lumpur" | "Asia/Kuwait" | "Asia/Magadan" | "Asia/Muscat" | "Asia/Novosibirsk" | "Asia/Riyadh" | "Asia/Seoul" | "Asia/Shanghai" | "Asia/Singapore" | "Asia/Srednekolymsk" | "Asia/Taipei" | "Asia/Tashkent" | "Asia/Tbilisi" | "Asia/Tehran" | "Asia/Tokyo" | "Asia/Ulaanbaatar" | "Asia/Urumqi" | "Asia/Vladivostok" | "Asia/Yakutsk" | "Asia/Yangon" | "Asia/Yekaterinburg" | "Asia/Yerevan" | "Atlantic/Azores" | "Atlantic/Cape_Verde" | "Atlantic/South_Georgia" | "Australia/Adelaide" | "Australia/Brisbane" | "Australia/Darwin" | "Australia/Hobart" | "Australia/Melbourne" | "Australia/Perth" | "Australia/Sydney" | "Europe/Amsterdam" | "Europe/Athens" | "Europe/Belgrade" | "Europe/Berlin" | "Europe/Bratislava" | "Europe/Brussels" | "Europe/Bucharest" | "Europe/Budapest" | "Europe/Copenhagen" | "Europe/Dublin" | "Europe/Helsinki" | "Europe/Istanbul" | "Europe/Kaliningrad" | "Europe/Kyiv" | "Europe/Lisbon" | "Europe/Ljubljana" | "Europe/London" | "Europe/Madrid" | "Europe/Minsk" | "Europe/Moscow" | "Europe/Paris" | "Europe/Prague" | "Europe/Riga" | "Europe/Rome" | "Europe/Samara" | "Europe/Sarajevo" | "Europe/Skopje" | "Europe/Sofia" | "Europe/Stockholm" | "Europe/Tallinn" | "Europe/Vienna" | "Europe/Vilnius" | "Europe/Volgograd" | "Europe/Warsaw" | "Europe/Zagreb" | "Europe/Zurich" | "GMT+12" | "Pacific/Apia" | "Pacific/Auckland" | "Pacific/Chatham" | "Pacific/Fakaofo" | "Pacific/Fiji" | "Pacific/Guadalcanal" | "Pacific/Guam" | "Pacific/Honolulu" | "Pacific/Majuro" | "Pacific/Midway" | "Pacific/Noumea" | "Pacific/Pago_Pago" | "Pacific/Port_Moresby" | "Pacific/Tongatapu";
 /** Billing entity object */
 export interface BillingEntityObject {
     /**
@@ -331,10 +331,10 @@ export interface TaxObject {
      */
     code: string;
     /**
-     * Internal description of the taxe
+     * Internal description of the tax
      * @example "French standard VAT"
      */
-    description?: string;
+    description?: string | null;
     /**
      * The percentage rate of the tax
      * @example 20
@@ -419,6 +419,11 @@ export interface ApiErrorNotFound {
     /** @example "object_not_found" */
     code: string;
 }
+/**
+ * List of unique code used to identify the taxes.
+ * @example ["french_standard_vat"]
+ */
+export type TaxCodes = string[];
 /** Billing entity update input */
 export interface BillingEntityUpdateInput {
     /**
@@ -522,11 +527,8 @@ export interface BillingEntityUpdateInput {
      * @example "UTC"
      */
     timezone?: Timezone;
-    /**
-     * The tax codes that should be associated with this billing entity
-     * @example ["french_standard_vat"]
-     */
-    tax_codes?: string[];
+    /** The tax codes that should be associated with this billing entity */
+    tax_codes?: TaxCodes;
     /** The email notification settings for this billing entity */
     email_settings?: ("invoice.finalized" | "credit_note.created")[];
     /**
@@ -735,11 +737,8 @@ export interface AddOnBaseInput {
      * @example "Implementation fee for new customers."
      */
     description?: string | null;
-    /**
-     * List of unique code used to identify the taxes.
-     * @example ["french_standard_vat"]
-     */
-    tax_codes?: string[];
+    /** List of unique code used to identify the taxes. */
+    tax_codes?: TaxCodes;
 }
 export interface AddOnCreateInput {
     add_on: AddOnBaseInput;
@@ -942,6 +941,55 @@ export interface OverdueBalanceObject {
 export interface OverdueBalances {
     overdue_balances: OverdueBalanceObject[];
 }
+export interface UsageObject {
+    /**
+     * The unique identifier of the organization for which the usage analytics is calculated.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    organization_id: string;
+    /**
+     * The start date of the period for which the usage analytics is calculated.
+     * @format date
+     * @example "2023-11-01"
+     */
+    start_of_period_dt?: string;
+    /**
+     * The end date of the period for which the usage analytics is calculated.
+     * @format date
+     * @example "2023-11-30"
+     */
+    end_of_period_dt?: string;
+    /**
+     * The currency of usage analytics. Format must be ISO 4217.
+     * @example "USD"
+     */
+    amount_currency: Currency;
+    /**
+     * The total amount for usages for a period, expressed in cents.
+     * @example 50000
+     */
+    amount_cents: number;
+    /**
+     * The code of the usage-based billable metrics.
+     * @example "code1"
+     */
+    billable_metric_code?: string;
+    /**
+     * The total number of units for the usage-based billable metrics.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.0"
+     */
+    units?: string;
+    /**
+     * Indicates whether the billable metric associated with the usage is deleted.
+     * @example false
+     */
+    is_billable_metric_deleted?: boolean;
+}
+export interface Usages {
+    usages: UsageObject[];
+}
 /** @example "USD" */
 export type CurrencyOrNull = "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BIF" | "BMD" | "BND" | "BOB" | "BRL" | "BSD" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHF" | "CLF" | "CLP" | "CNY" | "COP" | "CRC" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ETB" | "EUR" | "FJD" | "FKP" | "GBP" | "GEL" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "ISK" | "JMD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KRW" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRO" | "MUR" | "MVR" | "MWK" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SEK" | "SGD" | "SHP" | "SLL" | "SOS" | "SRD" | "STD" | "SZL" | "THB" | "TJS" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "UYU" | "UZS" | "VND" | "VUV" | "WST" | "XAF" | "XCD" | "XOF" | "XPF" | "YER" | "ZAR" | "ZMW";
 export interface AppliedCouponObject {
@@ -1349,6 +1397,150 @@ export interface BillableMetricEvaluateExpressionResult {
 export interface BillableMetricUpdateInput {
     billable_metric: BillableMetricBaseInput;
 }
+export interface FeaturePrivilegeObject {
+    /**
+     * Unique code for the privilege.
+     * @example "max"
+     */
+    code: string;
+    /**
+     * Display name for the privilege.
+     * @example "Maximum"
+     */
+    name?: string | null;
+    /**
+     * Data type of the privilege value. Default: string
+     * @example "integer"
+     */
+    value_type?: "integer" | "boolean" | "string" | "select";
+    config?: {
+        /**
+         * Array of string, required only when value_type is `select`.
+         * @example ["google","okta"]
+         */
+        select_options?: string[];
+    };
+}
+export interface FeatureObject {
+    /**
+     * Unique code used to identify the feature. Max 255 characters.
+     * @example "seats"
+     */
+    code: string;
+    /**
+     * Name of the feature. Max 255 characters.
+     * @example "Number of seats"
+     */
+    name?: string | null;
+    /**
+     * Description of the feature. Max 600 characters.
+     * @example "Number of users of the account"
+     */
+    description?: string | null;
+    /**
+     * Privileges associated with this feature. Can be empty.
+     * @example [{"code":"max","name":"Maximum","value_type":"integer"},{"code":"max_admins","name":"Max Admins","value_type":"integer"},{"code":"root","name":"Allow root user","value_type":"boolean"},{"code":"provider","name":"SSO Provider","value_type":"select","config":{"select_options":["google","okta"]}}]
+     */
+    privileges?: FeaturePrivilegeObject[];
+    /**
+     * Creation date of the feature.
+     * @format date-time
+     * @example "2025-07-17T12:34:35Z"
+     */
+    created_at: string;
+}
+export interface FeaturesPaginated {
+    features: FeatureObject[];
+    meta: PaginationMeta;
+}
+export interface FeatureCreateInput {
+    /**
+     * Unique code used to identify the feature.
+     * @example "seats"
+     */
+    code: string;
+    /**
+     * Name of the feature.
+     * @example "Number of seats"
+     */
+    name?: string | null;
+    /**
+     * Internal description of the feature.
+     * @example "Number of users of the account"
+     */
+    description?: string | null;
+    /**
+     * Privileges associated with this feature. Can be empty.
+     * @example [{"code":"max","name":"Maximum","value_type":"integer"},{"code":"max_admins","name":"Max Admins","value_type":"integer"},{"code":"root","name":"Allow root user","value_type":"boolean"},{"code":"provider","name":"SSO Provider","value_type":"select","config":{"select_options":["google","okta"]}}]
+     */
+    privileges?: {
+        /**
+         * Unique code for the privilege.
+         * @example "max"
+         */
+        code: string;
+        /**
+         * Display name for the privilege.
+         * @example "Maximum"
+         */
+        name?: string | null;
+        /**
+         * Data type of the privilege value. Default: string
+         * @example "integer"
+         */
+        value_type?: "integer" | "boolean" | "string" | "select";
+        config?: {
+            /**
+             * Array of string, required only when value_type is `select`.
+             * @example ["google","okta"]
+             */
+            select_options?: string[];
+        };
+    }[];
+}
+export interface Feature {
+    feature: FeatureObject;
+}
+export interface FeatureUpdateInput {
+    /**
+     * Name of the feature.
+     * @example "Number of seats"
+     */
+    name?: string | null;
+    /**
+     * Description of the feature.
+     * @example "Number of users of the account"
+     */
+    description?: string | null;
+    /**
+     * Existing privilege names can be updated or new privilege created.
+     * @example [{"code":"max","name":"Maximum"},{"code":"new_extra","name":"Extra","value_type":"string"},{"code":"providers","value_type":"select","config":{"select_options":["ms"]}}]
+     */
+    privileges?: {
+        /**
+         * Code of the privilege to update or create.
+         * @example "max"
+         */
+        code?: string;
+        /**
+         * Display name for the privilege.
+         * @example "Maximum"
+         */
+        name?: string;
+        /**
+         * Data type of the privilege value. Value_type cannot be modified for existing privilege but can be set for new privileges.
+         * @example "integer"
+         */
+        value_type?: "integer" | "boolean" | "string" | "select";
+        config?: {
+            /**
+             * Array of new string to add to existing options. Options cannot be deleted. Only used only when value_type is `select`.
+             * @example ["ms"]
+             */
+            select_options?: string[];
+        };
+    }[];
+}
 export interface CouponObject {
     /**
      * Unique identifier of the coupon, created by Lago.
@@ -1673,6 +1865,12 @@ export interface FeeAmountDetails {
      * @example "0.5"
      */
     per_package_unit_amount?: string;
+    /**
+     * Total amount of received units to be charged for the Volume or Percentage charge model.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "10.0"
+     */
+    per_unit_total_amount?: string;
     /**
      * The total units received in Lago for the Percentage charge model.
      * @pattern ^[0-9]+.?[0-9]*$
@@ -1690,11 +1888,6 @@ export interface FeeAmountDetails {
      * @example "1.0"
      */
     rate?: string;
-    /**
-     * Total amount of received units to be charged for the Percentage charge model.
-     * @example "10.0"
-     */
-    per_unit_total_amount?: string;
     /**
      * Total number of paid events for the Percentage charge model.
      * @example 20
@@ -1715,27 +1908,18 @@ export interface FeeAmountDetails {
      * @example "20.0"
      */
     min_max_adjustment_total_amount?: string;
-    /** Volume ranges, used for a `volume` charge model. */
-    volume_ranges?: {
-        /**
-         * The flat amount for a whole tier, excluding tax, for a `volume` charge model.
-         * @pattern ^[0-9]+.?[0-9]*$
-         * @example "0.5"
-         */
-        per_unit_amount: string;
-        /**
-         * The unit price, excluding tax, for a specific tier of a `volume` charge model.
-         * @pattern ^[0-9]+.?[0-9]*$
-         * @example "10.0"
-         */
-        flat_unit_amount: string;
-        /**
-         * Total amount of received units to be charged.
-         * @pattern ^[0-9]+.?[0-9]*$
-         * @example "10.0"
-         */
-        per_unit_total_amount: string;
-    }[];
+    /**
+     * The flat amount for a whole tier, excluding tax, for a `volume` charge model.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "0.5"
+     */
+    per_unit_amount?: string;
+    /**
+     * The unit price, excluding tax, for a specific tier of a `volume` charge model.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "10.0"
+     */
+    flat_unit_amount?: string;
 }
 export interface BaseAppliedTax {
     /**
@@ -1743,49 +1927,49 @@ export interface BaseAppliedTax {
      * @format uuid
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
-    lago_id?: string;
+    lago_id: string;
     /**
      * Unique identifier of the tax, created by Lago.
      * @format uuid
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
-    lago_tax_id?: string;
+    lago_tax_id: string | null;
     /**
      * Name of the tax.
      * @example "TVA"
      */
-    tax_name?: string;
+    tax_name: string;
     /**
      * Unique code used to identify the tax associated with the API request.
      * @example "french_standard_vat"
      */
-    tax_code?: string;
+    tax_code: string;
     /**
      * The percentage rate of the tax
      * @example 20
      */
-    tax_rate?: number;
+    tax_rate: number;
     /**
-     * Internal description of the taxe
+     * Internal description of the tax
      * @example "French standard VAT"
      */
-    tax_description?: string;
+    tax_description: string | null;
     /**
      * Amount of the tax
      * @example 2000
      */
-    amount_cents?: number;
+    amount_cents: number;
     /**
      * Currency of the tax
      * @example "USD"
      */
-    amount_currency?: Currency;
+    amount_currency: Currency;
     /**
      * The date and time when the applied tax was created. It is expressed in UTC format according to the ISO 8601 datetime standard. This field provides the timestamp for the exact moment when the applied tax was initially created.
      * @format date-time
      * @example "2022-09-14T16:35:31Z"
      */
-    created_at?: string;
+    created_at: string;
 }
 export type FeeAppliedTaxObject = BaseAppliedTax & {
     /**
@@ -1897,11 +2081,6 @@ export interface FeeObject {
      * @example "external_id"
      */
     external_subscription_id?: string | null;
-    /**
-     * 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 (SF1)"
-     */
-    invoice_display_name?: string;
     /**
      * The cost of this specific fee, excluding any applicable taxes.
      * @example 100
@@ -1961,7 +2140,7 @@ export interface FeeObject {
      * The number of events that have been sent and used to charge the customer. This field indicates the count or quantity of events that have been processed and considered in the charging process.
      * @example 23
      */
-    events_count?: number;
+    events_count?: number | null;
     /**
      * Flag that indicates whether the fee was paid in advance. It serves as a boolean value, where `true` represents that the fee was paid in advance (straightaway), and `false` indicates that the fee was not paid in arrears (at the end of the period).
      * @example true
@@ -2018,6 +2197,16 @@ export interface FeeObject {
      * @example "transaction_1234567890"
      */
     event_transaction_id?: string | null;
+    /**
+     * The description of the fee.
+     * @example "Fee description"
+     */
+    description?: string | null;
+    /**
+     * The coupon amount applied to the fee, with precision.
+     * @example "0.0"
+     */
+    precise_coupons_amount_cents?: string;
     /** List of all unit amount details for calculating the fee. */
     amount_details?: FeeAmountDetails;
     /**
@@ -2031,7 +2220,7 @@ export interface FeeObject {
          * The fee type. Possible values are `add-on`, `charge`, `credit`, `subscription` or `commitment`.
          * @example "subscription"
          */
-        type: "charge" | "add_on" | "subscription" | "credit";
+        type: "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`.
          * @example "startup"
@@ -2042,6 +2231,11 @@ export interface FeeObject {
          * @example "Startup"
          */
         name: string;
+        /**
+         * The description of the fee item. It can be the description of the `add-on`, the `charge`, the `credit`, the `subscription` or the `commitment`.
+         * @example "Startup"
+         */
+        description?: string | null;
         /**
          * 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 (SF1)"
@@ -2051,9 +2245,9 @@ export interface FeeObject {
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the actual charge filter values will be used as the default display name.
          * @example "AWS eu-east-1"
          */
-        filter_invoice_display_name?: string;
+        filter_invoice_display_name?: string | null;
         /** Key value list of event properties */
-        filters?: Record<string, string[]>;
+        filters?: object | null;
         /**
          * Unique identifier of the fee item, created by Lago. It can be the identifier of the `add-on`, the `charge`, the `credit`, the `subscription` or the `commitment`.
          * @format uuid
@@ -2907,11 +3101,8 @@ export interface CustomerCreateInput {
          * @example "CA"
          */
         state?: string | null;
-        /**
-         * List of unique code used to identify the taxes.
-         * @example ["french_standard_vat"]
-         */
-        tax_codes?: string[];
+        /** List of unique code used to identify the taxes. */
+        tax_codes?: TaxCodes;
         /**
          * The tax identification number of the customer
          * @example "EU123456789"
@@ -3064,9 +3255,9 @@ export type CustomerChargeFiltersUsageObject = {
     pricing_unit_details?: UsagePricingUnitDetailsObject;
     /**
      * List of filter values applied to the usage.
-     * @example {"region":"us-east-1"}
+     * @example {"region":["us-east-1"]}
      */
-    values?: Record<string, string>;
+    values?: Record<string, string[]>;
 }[];
 /** Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
 export type CustomerChargeGroupedUsageObject = {
@@ -3216,6 +3407,62 @@ export interface CustomerUsageObject {
 export interface CustomerUsage {
     customer_usage: CustomerUsageObject;
 }
+export interface CustomerProjectedUsageObject {
+    /**
+     * The lower bound of the billing period, expressed in the ISO 8601 datetime format in Coordinated Universal Time (UTC).
+     * @format date-time
+     * @example "2022-07-01T00:00:00Z"
+     */
+    from_datetime: string;
+    /**
+     * The upper bound of the billing period, expressed in the ISO 8601 datetime format in Coordinated Universal Time (UTC).
+     * @format date-time
+     * @example "2022-07-31T23:59:59Z"
+     */
+    to_datetime: string;
+    /**
+     * The date of creation of the invoice.
+     * @format date
+     * @example "2022-08-01"
+     */
+    issuing_date: string;
+    /**
+     * A unique identifier associated with the invoice related to this particular usage record.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_invoice_id?: string | null;
+    /**
+     * The currency of the customer's current usage.
+     * @example "EUR"
+     */
+    currency?: Currency;
+    /**
+     * The amount in cents, tax excluded.
+     * @example 123
+     */
+    amount_cents: number;
+    /**
+     * The projected amount in cents, tax excluded.
+     * @example 256
+     */
+    projected_amount_cents: number;
+    /**
+     * The tax amount in cents.
+     * @example 200
+     */
+    taxes_amount_cents: number;
+    /**
+     * The total amount in cents, tax included.
+     * @example 123
+     */
+    total_amount_cents: number;
+    /** Array of charges that comprise the current usage. It contains detailed information about individual charge items associated with the usage. */
+    charges_usage: CustomerChargeUsageObject[];
+}
+export interface CustomerProjectedUsage {
+    customer_projected_usage: CustomerProjectedUsageObject;
+}
 export interface CustomerPastUsage {
     usage_periods: CustomerUsage[];
     meta: PaginationMeta;
@@ -3606,9 +3853,10 @@ export interface EventBatchEstimateInstantFeesInput {
 export interface Event {
     event: EventObject;
 }
-export type FeesPaginated = Fees & {
+export interface FeesPaginated {
+    fees: FeeObject[];
     meta: PaginationMeta;
-};
+}
 export interface Fee {
     fee: FeeObject;
 }
@@ -3964,10 +4212,19 @@ export interface InvoiceOneOffCreateInput {
              */
             description?: string | null;
             /**
-             * List of unique code used to identify the taxes.
-             * @example ["french_standard_vat"]
+             * The lower boundary of the invoice billing interval. The `from_datetime` should be provided in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
+             * @format date-time
+             * @example "2022-08-08T00:00:00Z"
              */
-            tax_codes?: string[];
+            from_datetime?: string;
+            /**
+             * The upper boundary of the invoice billing interval. The `to_datetime` should be provided in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
+             * @format date-time
+             * @example "2022-08-08T00:00:00Z"
+             */
+            to_datetime?: string;
+            /** List of unique code used to identify the taxes. */
+            tax_codes?: TaxCodes;
             /**
              * If true, the invoice will be created but not sent to the payment provider.
              * @default false
@@ -4098,13 +4355,14 @@ export interface SubscriptionObject {
      * When a pay-in-advance subscription is terminated before the end of its billing period, we generate a credit note for the unused subscription time by default.
      * This field allows you to control the behavior of the credit note generation:
      *
-     * - `credit`: A credit note is generated for the unused subscription time. The unused amount is credited to the credit note wallet.
+     * - `credit`: A credit note is generated for the unused subscription time. The unused amount is credited back to the customer.
+     * - `refund`: A credit note is generated for the unused subscription time. If the invoice is paid or partially paid, the unused paid amount is refunded; any unpaid unused amount is credited back to the customer.
      * - `skip`: No credit note is generated for the unused subscription time.
      *
      * _Note: This field is only applicable to pay-in-advance plans and will be `null` for pay-in-arrears plans._
      * @example "credit"
      */
-    on_termination_credit_note: "credit" | "skip";
+    on_termination_credit_note: "credit" | "refund" | "skip";
     /**
      * When a subscription is terminated before the end of its billing period, we generate an invoice for the unbilled usage.
      * This field allows you to control the behavior of the invoice generation:
@@ -5122,6 +5380,38 @@ export interface ChargeObject {
         conversion_rate: string;
     };
 }
+export type PlanEntitlementPrivilegeObject = FeaturePrivilegeObject & {
+    /**
+     * Value assigned to this privilege in the entitlement. Type depends on the privilege's value_type.
+     * @example 10
+     */
+    value: number | boolean | string;
+};
+export interface PlanEntitlementObject {
+    /**
+     * Unique code used to identify the feature. Max 255 characters.
+     * @example "seats"
+     */
+    code: string;
+    /**
+     * Name of the feature. Max 255 characters.
+     * @example "Number of seats"
+     */
+    name: string | null;
+    /**
+     * Description of the feature. Max 600 characters.
+     * @example "Number of users of the account"
+     */
+    description: string | null;
+    /**
+     * Privileges associated with this feature. Each privilege must have a value assigned.
+     * @example [{"code":"max","name":"Maximum","value_type":"integer","value":10},{"code":"max_admins","name":"Max Admins","value_type":"integer","value":5},{"code":"root","name":"Allow root user","value_type":"boolean","value":true},{"code":"provider","name":"SSO Provider","value_type":"select","value":"google","config":{"select_options":["google","okta"]}}]
+     */
+    privileges: PlanEntitlementPrivilegeObject[];
+}
+export interface PlanEntitlement {
+    entitlement: PlanEntitlementObject;
+}
 export interface PlanObject {
     /**
      * Unique identifier of the plan created by Lago.
@@ -5195,6 +5485,8 @@ export interface PlanObject {
     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[];
 }
 export interface PlansPaginated {
     plans: PlanObject[];
@@ -5212,11 +5504,8 @@ export interface MinimumCommitmentInput {
      * @example "Minimum Commitment (C1)"
      */
     invoice_display_name?: string;
-    /**
-     * List of unique code used to identify the taxes.
-     * @example ["french_standard_vat"]
-     */
-    tax_codes?: string[];
+    /** List of unique code used to identify the taxes. */
+    tax_codes?: TaxCodes;
 }
 /** Values used to apply differentiated pricing based on additional event properties. */
 export interface ChargeFilterInput {
@@ -5308,11 +5597,8 @@ export interface PlanCreateInput {
          * @example null
          */
         bill_charges_monthly?: boolean | null;
-        /**
-         * List of unique code used to identify the taxes.
-         * @example ["french_standard_vat"]
-         */
-        tax_codes?: string[];
+        /** List of unique code used to identify the taxes. */
+        tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
         minimum_commitment?: MinimumCommitmentInput;
         /**
@@ -5373,11 +5659,8 @@ export interface PlanCreateInput {
             properties?: ChargeProperties;
             /** List of filters used to apply differentiated pricing based on additional event properties. */
             filters?: ChargeFilterInput[];
-            /**
-             * List of unique code used to identify the taxes.
-             * @example ["french_standard_vat"]
-             */
-            tax_codes?: string[];
+            /** List of unique code used to identify the taxes. */
+            tax_codes?: TaxCodes;
             /** The pricing unit to apply to the charge. */
             applied_pricing_unit?: {
                 /**
@@ -5453,11 +5736,8 @@ export interface PlanUpdateInput {
          * @example null
          */
         bill_charges_monthly?: boolean | null;
-        /**
-         * List of unique code used to identify the taxes.
-         * @example ["french_standard_vat"]
-         */
-        tax_codes?: string[];
+        /** List of unique code used to identify the taxes. */
+        tax_codes?: TaxCodes;
         /** Minimum commitment for this plan. */
         minimum_commitment?: MinimumCommitmentInput;
         /**
@@ -5524,11 +5804,8 @@ export interface PlanUpdateInput {
             properties?: ChargeProperties;
             /** List of filters used to apply differentiated pricing based on additional event properties. */
             filters?: ChargeFilterInput[];
-            /**
-             * List of unique code used to identify the taxes.
-             * @example ["french_standard_vat"]
-             */
-            tax_codes?: string[];
+            /** List of unique code used to identify the taxes. */
+            tax_codes?: TaxCodes;
             /** Updates the pricing unit conversion rate for this charge. Only applies if the charge has applied pricing unit. */
             applied_pricing_unit?: {
                 /**
@@ -5549,6 +5826,14 @@ export interface PlanUpdateInput {
         cascade_updates?: boolean;
     };
 }
+export interface PlanEntitlements {
+    entitlements: PlanEntitlementObject[];
+}
+/**
+ * Feature entitlements with their privilege values. Each key is a feature code, and the value is an object containing privilege codes with their associated values.
+ * @example {"seats":{"max":20,"max_admins":10,"root":false},"sso":{"provider":"okta"}}
+ */
+export type EntitlementUpdateInput = Record<string, Record<string, number | boolean | string>>;
 export interface SubscriptionsPaginated {
     subscriptions: SubscriptionObject[];
     meta: PaginationMeta;
@@ -5580,11 +5865,8 @@ export interface PlanOverridesObject {
      * @example "Startup"
      */
     name?: string;
-    /**
-     * List of unique code used to identify the taxes.
-     * @example ["french_standard_vat"]
-     */
-    tax_codes?: string[];
+    /** List of unique code used to identify the taxes. */
+    tax_codes?: TaxCodes;
     /**
      * The duration in days during which the base cost of the plan is offered for free.
      * @example 5
@@ -5619,11 +5901,8 @@ export interface PlanOverridesObject {
         properties?: ChargeProperties;
         /** List of filters used to apply differentiated pricing based on additional event properties. */
         filters?: ChargeFilterInput[];
-        /**
-         * List of unique code used to identify the taxes.
-         * @example ["french_standard_vat"]
-         */
-        tax_codes?: string[];
+        /** List of unique code used to identify the taxes. */
+        tax_codes?: TaxCodes;
         /** Updates the pricing unit conversion rate for this charge. Only applies if the charge has applied pricing unit. */
         applied_pricing_unit?: {
             /**
@@ -5924,6 +6203,51 @@ export interface Alert {
 export interface AlertUpdateInput {
     alert: AlertBaseInput;
 }
+export type SubscriptionEntitlementPrivilegeObject = FeaturePrivilegeObject & {
+    /**
+     * Applicable value this this subscription (override_value if set, plan_value otherwise). Type depends on the privilege's value_type.
+     * @example 10
+     */
+    value: number | boolean | string;
+    /**
+     * Value assigned to this privilege in the plan. Type depends on the privilege's value_type.
+     * @example 10
+     */
+    plan_value: number | boolean | string;
+    /**
+     * Value assigned to this subscription specifically. Type depends on the privilege's value_type. Null if no override is set.
+     * @example 10
+     */
+    override_value: number | boolean | string | null;
+};
+export interface SubscriptionEntitlementObject {
+    /**
+     * Unique code used to identify the feature. Max 255 characters.
+     * @example "seats"
+     */
+    code: string;
+    /**
+     * Name of the feature. Max 255 characters.
+     * @example "Number of seats"
+     */
+    name: string | null;
+    /**
+     * Description of the feature. Max 600 characters.
+     * @example "Number of users of the account"
+     */
+    description: string | null;
+    /**
+     * Privileges associated with this feature. Each privilege shows the plan value and any subscription override.
+     * @example [{"code":"max","name":"Maximum","value_type":"integer","value":15,"plan_value":10,"override_value":15},{"code":"max_admins","name":"Max Admins","value_type":"integer","value":5,"plan_value":5,"override_value":null},{"code":"root","name":"Allow root user","value_type":"boolean","value":true,"plan_value":true,"override_value":null},{"code":"provider","name":"SSO Provider","value_type":"select","value":"okta","plan_value":"google","override_value":"okta","config":{"select_options":["google","okta"]}}]
+     */
+    privileges: SubscriptionEntitlementPrivilegeObject[];
+}
+export interface SubscriptionEntitlements {
+    entitlements: SubscriptionEntitlementObject[];
+}
+export interface SubscriptionEntitlement {
+    entitlement: SubscriptionEntitlementObject;
+}
 export interface TaxesPaginated {
     taxes: TaxObject[];
     meta: PaginationMeta;
@@ -6150,6 +6474,11 @@ export interface WalletObject {
          * @example ["charge"]
          */
         fee_types?: ("charge" | "subscription" | "commitment")[];
+        /**
+         * An array of billable metric codes to which the wallet is applicable. By specifying the billable metric codes in this field, you can restrict the wallet's usage to specific metrics only.
+         * @example ["bm1"]
+         */
+        billable_metric_codes?: string[];
     };
     /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
     recurring_transaction_rules?: WalletRecurringTransactionRule[];
@@ -6238,6 +6567,11 @@ export interface WalletCreateInput {
              * @example ["charge"]
              */
             fee_types?: any[] | null;
+            /**
+             * An array of billable metric codes to which the wallet is applicable. By specifying the billable metric codes in this field, you can restrict the wallet's usage to specific metrics only.
+             * @example []
+             */
+            billable_metric_codes?: any[] | null;
         };
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
         recurring_transaction_rules?: any[] | null;
@@ -6346,6 +6680,11 @@ export interface WalletUpdateInput {
              * @example ["charge"]
              */
             fee_types?: any[] | null;
+            /**
+             * An array of billable metric codes to which the wallet is applicable. By specifying the billable metric codes in this field, you can restrict the wallet's usage to specific metrics only.
+             * @example []
+             */
+            billable_metric_codes?: any[] | null;
         };
     };
 }
@@ -6755,6 +7094,28 @@ export interface CreditNotePaymentProviderRefundError {
     payment_provider_code?: string;
     provider_error?: string | Record<string, any>;
 }
+export interface DunningCampaignFinishedObject {
+    /**
+     * The customer external unique identifier (provided by your own application).
+     * @example "cus_0987654321"
+     */
+    customer_external_id: string;
+    /**
+     * Identifier of the dunning campaign.
+     * @example "dun_code_1234"
+     */
+    dunning_campaign_code: string;
+    /**
+     * The amount of the overdue balance, expressed in cents.
+     * @example 120
+     */
+    overdue_balance_cents: number;
+    /**
+     * The currency of the balance.
+     * @example "EUR"
+     */
+    overdue_balance_currency: Currency;
+}
 export interface EventErrorsObject {
     /**
      * HTTP status code. It will always be 422
@@ -6975,6 +7336,7 @@ export interface WalletTransactionPaymentFailureObject {
     provider_error?: string | Record<string, any>;
 }
 export type CustomerPaymentProvidernErrorObject = CustomerPaymentProviderErrorObject;
+export type PrivilegeObject = FeaturePrivilegeObject;
 export type QueryParamsType = Record<string | number, any>;
 export type ResponseFormat = keyof Omit<Body, "body" | "bodyUsed">;
 export interface FullRequestParams extends Omit<RequestInit, "body"> {
@@ -7406,6 +7768,68 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             months?: number;
         }, params?: RequestParams) => Promise<HttpResponse<OverdueBalances, ApiErrorUnauthorized | ApiErrorForbidden>>;
+        /**
+         * @description Returns usages.
+         *
+         * @tags analytics
+         * @name FindAllUsages
+         * @summary List usage
+         * @request GET:/analytics/usage
+         * @secure
+         */
+        findAllUsages: (query?: {
+            /**
+             * The time granularity of usage analytics. Possible values are 'daily', 'weekly', 'monthly', 'yearly'.
+             * @example "monthly"
+             */
+            time_granularity?: "daily" | "weekly" | "monthly";
+            /** The currency of usage analytics. Format must be ISO 4217. */
+            currency?: Currency;
+            /**
+             * The start date of the period for which the usage analytics is calculated.
+             * @format date
+             * @example "2023-11-01"
+             */
+            from_date?: string;
+            /**
+             * The end date of the period for which the usage analytics is calculated.
+             * @format date
+             * @example "2023-11-30"
+             */
+            to_date?: string;
+            /**
+             * The type of customer for which the usage analytics is calculated. Possible values are 'individual', 'company'.
+             * @example "individual"
+             */
+            customer_type?: "individual" | "company";
+            /**
+             * The external identifier of the customer for which the usage analytics is calculated.
+             * @example "ext-customer-123"
+             */
+            external_customer_id?: string;
+            /** The country of the customer for which the usage analytics is calculated. */
+            customer_country?: Country;
+            /**
+             * The external identifier of the subscription for which the usage analytics is calculated.
+             * @example "ext-subscription-123"
+             */
+            external_subscription_id?: string;
+            /**
+             * Indicates whether the billable metric associated with the usage is recurring.
+             * @example true
+             */
+            is_billable_metric_recurring?: boolean;
+            /**
+             * The code of the plan for which the usage analytics is calculated.
+             * @example "plan-code-123"
+             */
+            plan_code?: string;
+            /**
+             * The code of the usage-based billable metrics for which the usage analytics is calculated.
+             * @example "code1"
+             */
+            billable_metric_code?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<Usages, ApiErrorUnauthorized>>;
     };
     appliedCoupons: {
         /**
@@ -7528,6 +7952,81 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         findBillableMetric: (code: string, params?: RequestParams) => Promise<HttpResponse<BillableMetric, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
+    features: {
+        /**
+         * @description This endpoint creates a new feature representing an entitlement component of your application.
+         *
+         * @tags features
+         * @name CreateFeature
+         * @summary Create a feature
+         * @request POST:/features
+         * @secure
+         */
+        createFeature: (data: FeatureCreateInput, params?: RequestParams) => Promise<HttpResponse<Feature, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest>>;
+        /**
+         * @description This endpoint retrieves all existing features that represent entitlement components of your application.
+         *
+         * @tags features
+         * @name FindAllFeatures
+         * @summary List all features
+         * @request GET:/features
+         * @secure
+         */
+        findAllFeatures: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /** Search in name, code and description. */
+            search_term?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<FeaturesPaginated, ApiErrorUnauthorized>>;
+        /**
+         * @description This endpoint updates an existing feature representing an entitlement component of your application.
+         *
+         * @tags features
+         * @name UpdateFeature
+         * @summary Update a feature
+         * @request PUT:/features/{code}
+         * @secure
+         */
+        updateFeature: (code: string, data: FeatureUpdateInput, params?: RequestParams) => Promise<HttpResponse<Feature, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint deletes an existing feature representing an entitlement component of your application. Deleting a feature will remove it from all plans and subscriptions.
+         *
+         * @tags features
+         * @name DestroyFeature
+         * @summary Delete a feature
+         * @request DELETE:/features/{code}
+         * @secure
+         */
+        destroyFeature: (code: string, params?: RequestParams) => Promise<HttpResponse<Feature, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves an existing feature that represents an entitlement component of your application. The feature is identified by its unique code.
+         *
+         * @tags features
+         * @name FindFeature
+         * @summary Retrieve a feature
+         * @request GET:/features/{code}
+         * @secure
+         */
+        findFeature: (code: string, params?: RequestParams) => Promise<HttpResponse<Feature, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description Delete privilege from feature. Deleting a privilege removes it from all plans and subscriptions.
+         *
+         * @tags features
+         * @name DeleteFeaturePrivilege
+         * @summary Delete a privilege. Deleting a privilege removes it from all plans and subscriptions.
+         * @request DELETE:/features/{code}/privileges/{privilege_code}
+         * @secure
+         */
+        deleteFeaturePrivilege: (code: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<Feature, ApiErrorUnauthorized | ApiErrorNotFound>>;
+    };
     coupons: {
         /**
          * @description This endpoint is used to create a coupon that can be then attached to a customer to create a discount.
@@ -7844,6 +8343,28 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             apply_taxes?: boolean;
         }, params?: RequestParams) => Promise<HttpResponse<CustomerUsage, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint enables the retrieval of the usage-based billing data for a customer within the current period. It also returns the projected usage for the current period based on the current usage.
+         *
+         * @tags customers
+         * @name FindCustomerProjectedUsage
+         * @summary Retrieve customer current and projected usage
+         * @request GET:/customers/{external_customer_id}/projected_usage
+         * @secure
+         */
+        findCustomerProjectedUsage: (externalCustomerId: string, query: {
+            /**
+             * The unique identifier of the subscription within your application.
+             * @example "sub_1234567890"
+             */
+            external_subscription_id: string;
+            /**
+             * Optional flag to determine if taxes should be applied. Defaults to `true` if not provided or if null.
+             * @default true
+             * @example true
+             */
+            apply_taxes?: boolean;
+        }, params?: RequestParams) => Promise<HttpResponse<CustomerProjectedUsage, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
         /**
          * @description This endpoint enables the retrieval of the usage-based billing data for a customer within past periods.
          *
@@ -8032,13 +8553,13 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "et_12345678"
              */
             event_transaction_id?: string;
-            /** Filter results by fee's currency. */
+            /** Filter results by fee"s currency. */
             currency?: Currency;
             /**
-             * The fee type. Possible values are `add-on`, `charge`, `credit` or `subscription`.
+             * The fee type. Possible values are `add-on`, `charge`, `credit`, `subscription` or "commitment".
              * @example "charge"
              */
-            fee_type?: "charge" | "add_on" | "subscription" | "credit" | "instant_charge";
+            fee_type?: "charge" | "add_on" | "subscription" | "credit" | "commitment";
             /**
              * Filter results by the `code` of the billable metric attached to the fee. Only applies to `charge` types.
              * @example "bm_code"
@@ -8432,6 +8953,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              */
             payment_status?: "pending" | "failed" | "succeeded";
         }, params?: RequestParams) => Promise<HttpResponse<PaymentRequestsPaginated, ApiErrorUnauthorized>>;
+        /**
+         * @description This endpoint retrieves a specific payment request by its ID.
+         *
+         * @tags payment_requests
+         * @name FindPaymentRequest
+         * @summary Retrieve a payment request
+         * @request GET:/payment_requests/{lago_id}
+         * @secure
+         */
+        findPaymentRequest: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<PaymentRequestObject, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     payments: {
         /**
@@ -8549,6 +9080,66 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         destroyPlan: (code: string, params?: RequestParams) => Promise<HttpResponse<Plan, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint creates new entitlements by adding features to a plan. Note that all existing entitlements will be deleted and replaced by the ones provided. To add a new entitlement without removing the existing ones, use PATCH. The feature must exist and all privileges must be valid for the feature.
+         *
+         * @tags entitlements
+         * @name CreateEntitlement
+         * @summary Create an entitlement
+         * @request POST:/plans/{code}/entitlements
+         * @secure
+         */
+        createEntitlement: (code: string, data: EntitlementUpdateInput, params?: RequestParams) => Promise<HttpResponse<PlanEntitlements, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves all entitlements for a specific plan.
+         *
+         * @tags entitlements
+         * @name FindAllEntitlements
+         * @summary List all entitlements
+         * @request GET:/plans/{code}/entitlements
+         * @secure
+         */
+        findAllEntitlements: (code: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlements, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint updates an existing entitlement by modifying privilege values. Notice that the update is partial. All new privileges or features are added. If there is already a value, it's overridden. All features and privileges not part of the payload are ignored. To remove privileges or features, use the DELETE endpoints. All privileges must be valid for the feature.
+         *
+         * @tags entitlements
+         * @name UpdateEntitlement
+         * @summary Partial update of an entitlement
+         * @request PATCH:/plans/{code}/entitlements
+         * @secure
+         */
+        updateEntitlement: (code: string, data: EntitlementUpdateInput, params?: RequestParams) => Promise<HttpResponse<PlanEntitlements, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves a specific entitlement for a plan.
+         *
+         * @tags entitlements
+         * @name FindEntitlement
+         * @summary Retrieve an entitlement
+         * @request GET:/plans/{code}/entitlements/{feature_code}
+         * @secure
+         */
+        findEntitlement: (code: string, featureCode: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint deletes an existing entitlement by removing the feature from the plan.
+         *
+         * @tags entitlements
+         * @name DestroyEntitlement
+         * @summary Delete an entitlement
+         * @request DELETE:/plans/{code}/entitlements/{feature_code}
+         * @secure
+         */
+        destroyEntitlement: (code: string, featureCode: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a specific privilege and its value from an entitlement. The privilege remains untouched on the original feature.
+         *
+         * @tags entitlements
+         * @name RemoveEntitlementPrivilege
+         * @summary Remove a privilege from an entitlement
+         * @request DELETE:/plans/{code}/entitlements/{feature_code}/privileges/{privilege_code}
+         * @secure
+         */
+        removeEntitlementPrivilege: (code: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<PlanEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     subscriptions: {
         /**
@@ -8644,13 +9235,14 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * When a pay-in-advance subscription is terminated before the end of its billing period, we generate a credit note for the unused subscription time by default.
              * This field allows you to control the behavior of the credit note generation:
              *
-             * - `credit`: A credit note is generated for the unused subscription time.
+             * - `credit`: A credit note is generated for the unused subscription time. The unused amount is credited back to the customer.
+             * - `refund`: A credit note is generated for the unused subscription time. If the invoice is paid or partially paid, the unused paid amount is refunded; any unpaid unused amount is credited back to the customer.
              * - `skip`: No credit note is generated for the unused subscription time.
              *
              * _Note: This field is only applicable to pay-in-advance plans and is ignored for pay-in-arrears plans._
              * @example "credit"
              */
-            on_termination_credit_note?: "credit" | "skip";
+            on_termination_credit_note?: "credit" | "refund" | "skip";
             /**
              * When a subscription is terminated before the end of its billing period, we generate an invoice for the unbilled usage.
              * This field allows you to control the behavior of the invoice generation:
@@ -8731,6 +9323,46 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         deleteSubscriptionAlert: (externalId: string, code: string, params?: RequestParams) => Promise<HttpResponse<Alert, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint retrieves all entitlements for a specific subscription, including both plan entitlements and any subscription-specific overrides.
+         *
+         * @tags entitlements
+         * @name FindAllSubscriptionEntitlements
+         * @summary List all subscription entitlements
+         * @request GET:/subscriptions/{external_id}/entitlements
+         * @secure
+         */
+        findAllSubscriptionEntitlements: (externalId: string, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlements, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint allows partial updates to subscription entitlements. New entitlements are added, provided values are overridden, but entitlements not included in the payload are ignored.
+         *
+         * @tags entitlements
+         * @name UpdateSubscriptionEntitlements
+         * @summary Update subscription entitlements
+         * @request PATCH:/subscriptions/{external_id}/entitlements
+         * @secure
+         */
+        updateSubscriptionEntitlements: (externalId: string, data: EntitlementUpdateInput, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlements, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorBadRequest | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a specific feature entitlement from a subscription. The entitlement remains available from the plan.
+         *
+         * @tags entitlements
+         * @name DestroySubscriptionEntitlement
+         * @summary Remove an entitlement from a subscription
+         * @request DELETE:/subscriptions/{external_id}/entitlements/{feature_code}
+         * @secure
+         */
+        destroySubscriptionEntitlement: (externalId: string, featureCode: string, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlement, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint removes a specific privilege from a subscription entitlement. The privilege entitlement remains available from the plan.
+         *
+         * @tags entitlements
+         * @name DestroySubscriptionEntitlementPrivilege
+         * @summary Remove a privilege from a subscription entitlement override
+         * @request DELETE:/subscriptions/{external_id}/entitlements/{feature_code}/privileges/{privilege_code}
+         * @secure
+         */
+        destroySubscriptionEntitlementPrivilege: (externalId: string, featureCode: string, privilegeCode: string, params?: RequestParams) => Promise<HttpResponse<SubscriptionEntitlement, ApiErrorUnauthorized | ApiErrorBadRequest | ApiErrorNotFound>>;
     };
     taxes: {
         /**