lago-javascript-client 0.39.1-beta → 0.43.0-beta

package/types/openapi/client.d.ts

@@ -360,29 +360,31 @@ export interface BaseAppliedTax {
      */
     lago_tax_id?: string;
     /**
-     * The name of the tax.
-     * @example "example name"
+     * Name of the tax.
+     * @example "TVA"
      */
     tax_name?: string;
     /**
-     * The code of the tax.
-     * @example "example_code"
+     * Unique code used to identify the tax associated with the API request.
+     * @example "french_standard_vat"
      */
     tax_code?: string;
     /**
-     * The rate of the tax.
-     * @format ^[0-9]+.?[0-9]*$
-     * @example "25.0"
+     * The percentage rate of the tax
+     * @example 20
      */
-    tax_rate?: string;
+    tax_rate?: number;
     /**
-     * The description of the tax.
-     * @example "description"
+     * Internal description of the taxe
+     * @example "French standard VAT"
      */
     tax_description?: string;
-    /** @example 20 */
+    /**
+     * Amount of the tax
+     * @example 2000
+     */
     amount_cents?: number;
-    /** The currency of the tax. */
+    /** Currency of the tax */
     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.
@@ -416,6 +418,15 @@ export interface BillableMetricObject {
      * @example "GB of storage used in my application"
      */
     description?: string | null;
+    /**
+     * Defines if the billable metric is persisted billing period over billing period.
+     *
+     * - If set to `true`: the accumulated number of units calculated from the previous billing period is persisted to the next billing period.
+     * - If set to `false`: the accumulated number of units is reset to 0 at the end of the billing period.
+     * - If not defined in the request, default value is `false`.
+     * @example false
+     */
+    recurring: boolean;
     /**
      * Creation date of the billable metric.
      * @format date-time
@@ -466,6 +477,15 @@ export interface BillableMetricBaseInput {
      * @example "GB of storage used in my application"
      */
     description?: string | null;
+    /**
+     * Defines if the billable metric is persisted billing period over billing period.
+     *
+     * - If set to `true`: the accumulated number of units calculated from the previous billing period is persisted to the next billing period.
+     * - If set to `false`: the accumulated number of units is reset to 0 at the end of the billing period.
+     * - If not defined in the request, default value is `false`.
+     * @example false
+     */
+    recurring?: boolean;
     /**
      * Property of the billable metric used for aggregating usage data. This field is not required for `count_agg`.
      * @example "gb"
@@ -549,6 +569,15 @@ export interface ChargeObject {
      * @example true
      */
     invoiceable?: boolean;
+    /**
+     * Specifies whether a 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;
     /**
      * The minimum spending amount required for the charge, measured in cents and excluding any applicable taxes. It indicates the minimum amount that needs to be charged for each billing period.
      * @example 1200
@@ -558,6 +587,8 @@ export interface ChargeObject {
     properties?: ChargeProperties;
     /** All charge information, sorted by groups. */
     group_properties?: GroupPropertiesObject[];
+    /** All taxes applied to the charge. */
+    taxes?: TaxObject[];
 }
 export interface ChargeProperties {
     /** Graduated ranges, sorted from bottom to top tiers, used for a `graduated` charge model. */
@@ -1125,7 +1156,7 @@ export interface CreditObject {
      * Indicates whether the credit is applied on the amount before taxes (coupons) or after taxes (credit notes). This flag helps determine the order in which credits are applied to the invoice calculation
      * @example false
      */
-    before_vat: boolean;
+    before_taxes: boolean;
     /** The item attached to the credit. */
     item: {
         /**
@@ -1267,10 +1298,9 @@ export interface CreditNoteObject {
     taxes_amount_cents: number;
     /**
      * The tax rate associated with this specific credit note.
-     * @format ^[0-9]+.?[0-9]*$
-     * @example "20.0"
+     * @example 20
      */
-    taxes_rate: string;
+    taxes_rate: number;
     /**
      * The subtotal of the credit note excluding any applicable taxes, expressed in cents.
      * @example 100
@@ -1524,54 +1554,6 @@ export declare enum Currency {
 export interface Customer {
     customer: CustomerObjectExtended;
 }
-export interface CustomerAppliedTax {
-    applied_tax: CustomerAppliedTaxObject;
-}
-export interface CustomerAppliedTaxInput {
-    applied_tax: {
-        /**
-         * Unique code used to identify the tax.
-         * @example "vat_fr"
-         */
-        tax_code: string;
-    };
-}
-export interface CustomerAppliedTaxObject {
-    /**
-     * Unique identifier of the applied tax, created by Lago.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_id: string;
-    /**
-     * Unique identifier of the customer, created by Lago.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_customer_id: string;
-    /**
-     * Unique identifier of the tax, created by Lago.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_tax_id: string;
-    /**
-     * The code of the tax.
-     * @example "example_code"
-     */
-    tax_code: string;
-    /**
-     * The customer external unique identifier (provided by your own application)
-     * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
-     */
-    external_customer_id: string;
-    /**
-     * 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;
-}
 /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
 export interface CustomerBillingConfiguration {
     /**
@@ -1605,6 +1587,11 @@ export interface CustomerBillingConfiguration {
      * @example "fr"
      */
     document_locale?: string;
+    /**
+     * Specifies the available payment methods that can be used for this customer when `payment_provider` is set to `stripe`. The `provider_payment_methods` field is an array that allows multiple payment options to be defined. If this field is not explicitly set, all the payment methods are selected. For now, possible values are `card` and `sepa_debit`.
+     * @example ["card","sepa_debit"]
+     */
+    provider_payment_methods?: string[] | null;
 }
 export interface CustomerChargeUsageObject {
     /**
@@ -1673,7 +1660,7 @@ export interface CustomerChargeUsageObject {
         key?: string | null;
         /**
          * The group value.
-         * @example "eruope"
+         * @example "europe"
          */
         value?: string;
         /**
@@ -1751,6 +1738,11 @@ export interface CustomerCreateInput {
          * @example "CA"
          */
         state?: string | null;
+        /**
+         * List of unique code used to identify the taxes.
+         * @example ["french_standard_vat"]
+         */
+        tax_codes?: string[];
         /**
          * The tax identification number of the customer
          * @example "EU123456789"
@@ -1768,6 +1760,11 @@ export interface CustomerCreateInput {
          * @example "91364"
          */
         zipcode?: string | null;
+        /**
+         * The net payment term, expressed in days, specifies the duration within which a customer is expected to remit payment after the invoice is finalized.
+         * @example 30
+         */
+        net_payment_term?: number | null;
         /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
         billing_configuration?: CustomerBillingConfiguration;
         /** Set of key-value pairs that you can attach to a customer. This can be useful for storing additional information about the customer in a structured format */
@@ -1922,20 +1919,31 @@ export interface CustomerObject {
      * @example "91364"
      */
     zipcode?: string | null;
+    /**
+     * The net payment term, expressed in days, specifies the duration within which a customer is expected to remit payment after the invoice is finalized.
+     * @example 30
+     */
+    net_payment_term?: number | null;
     /**
      * The date of the customer creation, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). The creation_date provides a standardized and internationally recognized timestamp for when the customer object was created
      * @format date-time
      * @example "2022-04-29T08:59:51Z"
      */
     created_at: string;
+    /**
+     * The date of the customer update, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). The update_date provides a standardized and internationally recognized timestamp for when the customer object was updated
+     * @format date-time
+     * @example "2022-04-29T08:59:51Z"
+     */
+    updated_at?: string;
     /** Configuration specific to the payment provider, utilized for billing the customer. This object contains settings and parameters necessary for processing payments and invoicing the customer. */
     billing_configuration?: CustomerBillingConfiguration;
     metadata?: CustomerMetadata[];
-    /** List of customer taxes */
-    taxes?: TaxObject[];
 }
 export type CustomerObjectExtended = CustomerObject & {
     metadata?: CustomerMetadata[];
+    /** List of customer taxes */
+    taxes?: TaxObject[];
 };
 export interface CustomersPaginated {
     customers: CustomerObjectExtended[];
@@ -2222,10 +2230,9 @@ export interface FeeObject {
     taxes_amount_cents: number;
     /**
      * The tax rate associated with this specific fee.
-     * @format ^[0-9]+.?[0-9]*$
-     * @example "20.0"
+     * @example 20
      */
-    taxes_rate: string;
+    taxes_rate: number;
     /**
      * The number of units used to charge the customer. This field indicates the quantity or count of units consumed or utilized in the context of the charge. It helps in determining the basis for calculating the fee or cost associated with the usage of the service or product provided to the customer.
      * @example "0.32"
@@ -2388,6 +2395,11 @@ export type InvoiceAppliedTaxObject = BaseAppliedTax & {
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
     lago_invoice_id?: string;
+    /**
+     * Fees total amount on which the tax is applied
+     * @example 20000
+     */
+    fees_amount_cents?: number;
 };
 export interface InvoiceMetadataObject {
     /**
@@ -2436,6 +2448,17 @@ export interface InvoiceObject {
      * @example "2022-04-30"
      */
     issuing_date: string;
+    /**
+     * The payment due date for the invoice, specified in the ISO 8601 date format.
+     * @format date
+     * @example "2022-04-30"
+     */
+    payment_due_date?: string;
+    /**
+     * The net payment term, expressed in days, specifies the duration within which a customer is expected to remit payment after the invoice is finalized.
+     * @example 30
+     */
+    net_payment_term?: number;
     /**
      * The type of invoice issued. Possible values are `subscription`, `one-off` or `credit`.
      * @example "subscription"
@@ -2681,6 +2704,11 @@ export interface OrganizationObject {
      * @example null
      */
     legal_number?: string | null;
+    /**
+     * The net payment term, expressed in days, specifies the duration within which a customer is expected to remit payment after the invoice is finalized.
+     * @example 30
+     */
+    net_payment_term?: number;
     /**
      * The tax identification number of your organization.
      * @example "US123456789"
@@ -2743,6 +2771,11 @@ export interface OrganizationUpdateInput {
          * @example null
          */
         legal_number?: string | null;
+        /**
+         * The net payment term, expressed in days, specifies the duration within which a customer is expected to remit payment after the invoice is finalized.
+         * @example 30
+         */
+        net_payment_term?: number;
         /**
          * The tax identification number of your organization.
          * @example "US123456789"
@@ -2789,7 +2822,7 @@ export interface PaginationMeta {
 export interface Plan {
     plan: PlanObject;
 }
-export interface PlanInput {
+export interface PlanCreateInput {
     plan: {
         /**
          * The name of the plan.
@@ -2833,9 +2866,123 @@ export interface PlanInput {
          * @example null
          */
         bill_charges_monthly?: boolean | null;
+        /**
+         * List of unique code used to identify the taxes.
+         * @example ["french_standard_vat"]
+         */
+        tax_codes?: string[];
         /**
          * Additional usage-based charges for this plan.
-         * @example [{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","charge_model":"package","invoiceable":true,"pay_in_advance":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","charge_model":"graduated","invoiceable":true,"pay_in_advance":false,"min_amount_cents":0,"properties":{"graduated_ranges":[{"to_value":10,"from_value":0,"flat_amount":"10","per_unit_amount":"0.5"},{"to_value":null,"from_value":11,"flat_amount":"0","per_unit_amount":"0.4"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","charge_model":"standard","invoiceable":true,"pay_in_advance":true,"min_amount_cents":0,"properties":{},"group_properties":[{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a01","values":{"amount":"10"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a02","values":{"amount":"5"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a03","values":{"amount":"8"}}]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","charge_model":"volume","invoiceable":true,"pay_in_advance":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"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","charge_model":"percentage","invoiceable":false,"pay_in_advance":true,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"group_properties":[]}]
+         * @example [{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","charge_model":"package","invoiceable":true,"pay_in_advance":false,"prorated":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"group_properties":[],"tax_codes":["french_standard_vat"]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","charge_model":"graduated","invoiceable":true,"pay_in_advance":false,"prorated":false,"min_amount_cents":0,"properties":{"graduated_ranges":[{"to_value":10,"from_value":0,"flat_amount":"10","per_unit_amount":"0.5"},{"to_value":null,"from_value":11,"flat_amount":"0","per_unit_amount":"0.4"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","charge_model":"standard","invoiceable":true,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{},"group_properties":[{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a01","values":{"amount":"10"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a02","values":{"amount":"5"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a03","values":{"amount":"8"}}]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","charge_model":"volume","invoiceable":true,"pay_in_advance":false,"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"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","charge_model":"percentage","invoiceable":false,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"group_properties":[]}]
+         */
+        charges?: {
+            /**
+             * Unique identifier of the billable metric created by Lago.
+             * @format uuid
+             * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+             */
+            billable_metric_id?: string;
+            /**
+             * Specifies the pricing model used for the calculation of the final fee. It can be `standard`, `graduated`, `package`, `percentage` or `volume`.
+             * @example "standard"
+             */
+            charge_model?: "standard" | "graduated" | "package" | "percentage" | "volume";
+            /**
+             * 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
+             */
+            pay_in_advance?: boolean;
+            /**
+             * This field specifies whether the charge should be included in a proper invoice. If set to false, no invoice will be issued for this charge. You can only set it to `false` when `pay_in_advance` is `true`.
+             * @example true
+             */
+            invoiceable?: boolean;
+            /**
+             * Specifies whether a 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;
+            /**
+             * The minimum spending amount required for the charge, measured in cents and excluding any applicable taxes. It indicates the minimum amount that needs to be charged for each billing period.
+             * @example 0
+             */
+            min_amount_cents?: number;
+            /** List of all thresholds utilized for calculating the charge. */
+            properties?: ChargeProperties;
+            /** All charge information, sorted by groups. */
+            group_properties?: {
+                /**
+                 * Unique identifier of a billable metric group, created by Lago.
+                 * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+                 */
+                group_id: string;
+                /** List of all thresholds utilized for calculating a charge, scoped by groups used as dimensions for a single charge. */
+                values: ChargeProperties;
+            }[];
+            /**
+             * List of unique code used to identify the taxes.
+             * @example ["french_standard_vat"]
+             */
+            tax_codes?: string[];
+        }[];
+    };
+}
+export interface PlanUpdateInput {
+    plan: {
+        /**
+         * The name of the plan.
+         * @example "Startup"
+         */
+        name?: string;
+        /**
+         * 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;
+        /**
+         * 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`, `monthly`, or `weekly`.
+         * @example "monthly"
+         */
+        interval?: "weekly" | "monthly" | "yearly";
+        /**
+         * The description on the plan.
+         * @example "Plan for early stage startups."
+         */
+        description?: string;
+        /**
+         * 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;
+        /** The currency of the plan. It indicates the monetary unit in which the plan's cost, including taxes and usage-based charges, is expressed. */
+        amount_currency?: Currency;
+        /**
+         * The duration in days during which the base cost of the plan is offered for free.
+         * @example 5
+         */
+        trial_period?: number;
+        /**
+         * 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;
+        /**
+         * This field, when set to `true`, enables to invoice usage-based charges on monthly basis, even if the cadence of the plan is yearly. 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`.
+         * @example null
+         */
+        bill_charges_monthly?: boolean | null;
+        /**
+         * List of unique code used to identify the taxes.
+         * @example ["french_standard_vat"]
+         */
+        tax_codes?: string[];
+        /**
+         * Additional usage-based charges for this plan.
+         * @example [{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a91","charge_model":"package","invoiceable":true,"pay_in_advance":false,"prorated":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"group_properties":[],"tax_codes":["french_standard_vat"]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a92","charge_model":"graduated","invoiceable":true,"pay_in_advance":false,"prorated":false,"min_amount_cents":0,"properties":{"graduated_ranges":[{"to_value":10,"from_value":0,"flat_amount":"10","per_unit_amount":"0.5"},{"to_value":null,"from_value":11,"flat_amount":"0","per_unit_amount":"0.4"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a93","charge_model":"standard","invoiceable":true,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{},"group_properties":[{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a01","values":{"amount":"10"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a02","values":{"amount":"5"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a03","values":{"amount":"8"}}]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a94","charge_model":"volume","invoiceable":true,"pay_in_advance":false,"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"}]},"group_properties":[]},{"billable_metric_id":"1a901a90-1a90-1a90-1a90-1a901a901a95","charge_model":"percentage","invoiceable":false,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"group_properties":[]}]
          */
         charges?: {
             /**
@@ -2865,6 +3012,15 @@ export interface PlanInput {
              * @example true
              */
             invoiceable?: boolean;
+            /**
+             * Specifies whether a 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;
             /**
              * The minimum spending amount required for the charge, measured in cents and excluding any applicable taxes. It indicates the minimum amount that needs to be charged for each billing period.
              * @example 0
@@ -2882,6 +3038,11 @@ export interface PlanInput {
                 /** List of all thresholds utilized for calculating a charge, scoped by groups used as dimensions for a single charge. */
                 values: ChargeProperties;
             }[];
+            /**
+             * List of unique code used to identify the taxes.
+             * @example ["french_standard_vat"]
+             */
+            tax_codes?: string[];
         }[];
     };
 }
@@ -2952,9 +3113,11 @@ export interface PlanObject {
     draft_invoices_count: number;
     /**
      * 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,"pay_in_advance":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"group_properties":[]},{"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,"pay_in_advance":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"}]},"group_properties":[]},{"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,"pay_in_advance":true,"min_amount_cents":0,"properties":{},"group_properties":[{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a01","values":{"amount":"10"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a02","values":{"amount":"5"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a03","values":{"amount":"8"}}]},{"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,"pay_in_advance":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"}]},"group_properties":[]},{"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,"pay_in_advance":true,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"group_properties":[]}]
+     * @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,"pay_in_advance":false,"prorated":false,"min_amount_cents":3000,"properties":{"amount":"30","free_units":100,"package_size":1000},"group_properties":[]},{"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,"pay_in_advance":false,"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"}]},"group_properties":[]},{"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,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{},"group_properties":[{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a01","values":{"amount":"10"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a02","values":{"amount":"5"}},{"group_id":"1a901a90-1a90-1a90-1a90-1a901a901a03","values":{"amount":"8"}}]},{"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,"pay_in_advance":false,"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"}]},"group_properties":[]},{"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,"pay_in_advance":true,"prorated":false,"min_amount_cents":0,"properties":{"rate":"1","fixed_amount":"0.5","free_units_per_events":5,"free_units_per_total_aggregation":"500"},"group_properties":[]}]
      */
     charges?: ChargeObject[];
+    /** All taxes applied to the plan. */
+    taxes?: TaxObject[];
 }
 export interface PlansPaginated {
     plans: PlanObject[];
@@ -3114,84 +3277,98 @@ export interface SubscriptionsPaginated {
 export interface Tax {
     tax: TaxObject;
 }
+export interface TaxBaseInput {
+    /**
+     * Name of the tax.
+     * @example "TVA"
+     */
+    name?: string;
+    /**
+     * Unique code used to identify the tax associated with the API request.
+     * @example "french_standard_vat"
+     */
+    code?: string;
+    /**
+     * The percentage rate of the tax
+     * @format ^[0-9]+.?[0-9]*$
+     * @example "20.0"
+     */
+    rate?: string;
+    /**
+     * Internal description of the taxe
+     * @example "French standard VAT"
+     */
+    description?: string | null;
+    /**
+     * Set to `true` if the tax is used as one of the organization's default
+     * @example true
+     */
+    applied_to_organization?: boolean;
+}
+export interface TaxCreateInput {
+    tax: TaxBaseInput;
+}
 export interface TaxesPaginated {
     taxes: TaxObject[];
     meta: PaginationMeta;
 }
-export interface TaxInput {
-    tax: {
-        /**
-         * The name of the tax.
-         * @example "French VAT"
-         */
-        name?: string;
-        /**
-         * Unique code used to identify the tax.
-         * @example "vat_fr"
-         */
-        code?: string;
-        /**
-         * The rate of the tax
-         * @format ^[0-9]+.?[0-9]*$
-         * @example "15.0"
-         */
-        rate?: string;
-        /**
-         * Description of the tax.
-         * @example "description"
-         */
-        description?: string;
-        /**
-         * Set to `true` if the tax is used as one of the organization's default.
-         * @example false
-         */
-        applied_to_organization?: boolean;
-    };
-}
 export interface TaxObject {
     /**
+     * Unique identifier of the tax, created by Lago.
      * @format uuid
      * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
     lago_id: string;
     /**
-     * The name of the tax.
-     * @example "French VAT"
+     * Name of the tax.
+     * @example "TVA"
      */
     name: string;
     /**
-     * Unique code used to identify the tax.
-     * @example "vat_fr"
+     * Unique code used to identify the tax associated with the API request.
+     * @example "french_standard_vat"
      */
     code: string;
     /**
-     * Description of the tax.
-     * @example "description"
+     * Internal description of the taxe
+     * @example "French standard VAT"
      */
     description?: string;
     /**
-     * The rate of the tax
-     * @format ^[0-9]+.?[0-9]*$
-     * @example "25.0"
+     * The percentage rate of the tax
+     * @example 20
      */
-    rate?: string;
+    rate: number;
     /**
-     * Set to `true` if the tax is used as one of the organization's default.
+     * Set to `true` if the tax is used as one of the organization's default
      * @example true
      */
     applied_to_organization: boolean;
+    /**
+     * Number of charges this tax is applied to.
+     * @example 0
+     */
+    charges_count?: number;
     /**
      * Number of customers this tax is applied to (directly or via the organization's default).
-     * @example 12
+     * @example 0
      */
     customers_count: number;
     /**
-     * The date and time when the 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 tax was initially created.
+     * Number of plans this tax is applied to.
+     * @example 0
+     */
+    plans_count?: number;
+    /**
+     * Creation date of the tax.
      * @format date-time
-     * @example "2022-09-14T16:35:31Z"
+     * @example "2023-07-06T14:35:58Z"
      */
     created_at: string;
 }
+export interface TaxUpdateInput {
+    tax: TaxBaseInput;
+}
 /** @example "America/Los_Angeles" */
 export declare enum Timezone {
     UTC = "UTC",
@@ -3612,7 +3789,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 0.39.0-beta
+ * @version 0.41.0-beta
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -4027,26 +4204,6 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         deleteAppliedCoupon: (externalCustomerId: string, appliedCouponId: string, params?: RequestParams) => Promise<HttpResponse<AppliedCoupon, ApiErrorUnauthorized | ApiErrorNotFound>>;
-        /**
-         * @description Apply an existing tax to a customer
-         *
-         * @tags customers
-         * @name ApplyTax
-         * @summary Apply a tax
-         * @request POST:/customers/{external_customer_id}/applied_taxes
-         * @secure
-         */
-        applyTax: (externalCustomerId: string, data: CustomerAppliedTaxInput, params?: RequestParams) => Promise<HttpResponse<CustomerAppliedTax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
-        /**
-         * @description Delete customer's appplied tax
-         *
-         * @tags customers
-         * @name DeleteAppliedTax
-         * @summary Delete customer's appplied tax
-         * @request DELETE:/customers/{external_customer_id}/applied_taxes/{tax_code}
-         * @secure
-         */
-        deleteAppliedTax: (externalCustomerId: string, taxCode: string, params?: RequestParams) => Promise<HttpResponse<CustomerAppliedTax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description Retrieves an embeddable link for displaying a customer portal. This endpoint allows you to fetch the URL that can be embedded to provide customers access to a dedicated portal
          *
@@ -4378,7 +4535,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/plans
          * @secure
          */
-        createPlan: (data: PlanInput, params?: RequestParams) => Promise<HttpResponse<Plan, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        createPlan: (data: PlanCreateInput, params?: RequestParams) => Promise<HttpResponse<Plan, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
         /**
          * @description This endpoint retrieves all existing plans.
          *
@@ -4409,7 +4566,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request PUT:/plans/{code}
          * @secure
          */
-        updatePlan: (code: string, data: PlanInput, params?: RequestParams) => Promise<HttpResponse<Plan, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        updatePlan: (code: string, data: PlanUpdateInput, params?: RequestParams) => Promise<HttpResponse<Plan, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
         /**
          * @description This endpoint retrieves a specific plan.
          *
@@ -4472,6 +4629,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "premium"
              */
             plan_code?: string;
+            /**
+             * If the field is not defined, Lago will return only `active` subscriptions. However, if you wish to fetch subscriptions by different status you can define them in a status[] query param. Available filter values: `pending`, `canceled`, `terminated`, `active`.
+             * @example ["active","pending"]
+             */
+            status?: ("pending" | "canceled" | "terminated" | "active")[];
         }, params?: RequestParams) => Promise<HttpResponse<SubscriptionsPaginated, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint allows you to update a subscription.
@@ -4492,11 +4654,17 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request DELETE:/subscriptions/{external_id}
          * @secure
          */
-        destroySubscription: (externalId: string, params?: RequestParams) => Promise<HttpResponse<Subscription, ApiErrorUnauthorized | ApiErrorNotAllowed | ApiErrorNotFound>>;
+        destroySubscription: (externalId: string, query?: {
+            /**
+             * If the field is not defined, Lago will terminate only `active` subscriptions. However, if you wish to cancel a `pending` subscription, please ensure that you include `status=pending` in your request.
+             * @example "pending"
+             */
+            status?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<Subscription, ApiErrorUnauthorized | ApiErrorNotAllowed | ApiErrorNotFound>>;
     };
     taxes: {
         /**
-         * @description Create a tax
+         * @description This endpoint creates a new tax representing a customizable tax rate applicable to either the organization or a specific customer.
          *
          * @tags taxes
          * @name CreateTax
@@ -4504,50 +4672,50 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/taxes
          * @secure
          */
-        createTax: (data: TaxInput, params?: RequestParams) => Promise<HttpResponse<Tax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity>>;
+        createTax: (data: TaxCreateInput, params?: RequestParams) => Promise<HttpResponse<Tax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity>>;
         /**
-         * @description Find all taxes in certain organization
+         * @description This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either the organization or a specific customer.
          *
          * @tags taxes
          * @name FindAllTaxes
-         * @summary Find taxes
+         * @summary List all taxes
          * @request GET:/taxes
          * @secure
          */
         findAllTaxes: (query?: {
             /**
-             * Number of page
-             * @example 2
+             * Page number.
+             * @example 1
              */
             page?: number;
             /**
-             * Number of records per page
+             * Number of records per page.
              * @example 20
              */
             per_page?: number;
         }, params?: RequestParams) => Promise<HttpResponse<TaxesPaginated, ApiErrorUnauthorized>>;
         /**
-         * @description Update an existing tax by code
+         * @description This endpoint updates an existing tax representing a customizable tax rate applicable to either the organization or a specific customer.
          *
          * @tags taxes
          * @name UpdateTax
-         * @summary Update an existing tax
+         * @summary Update a tax
          * @request PUT:/taxes/{code}
          * @secure
          */
-        updateTax: (code: string, data: TaxInput, params?: RequestParams) => Promise<HttpResponse<Tax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        updateTax: (code: string, data: TaxUpdateInput, params?: RequestParams) => Promise<HttpResponse<Tax, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
         /**
-         * @description Return a single tax
+         * @description This endpoint retrieves an existing tax representing a customizable tax rate applicable to either the organization or a specific customer. The tax is identified by its unique code.
          *
          * @tags taxes
          * @name FindTax
-         * @summary Find tax by code
+         * @summary Retrieve a Tax
          * @request GET:/taxes/{code}
          * @secure
          */
         findTax: (code: string, params?: RequestParams) => Promise<HttpResponse<Tax, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
-         * @description Delete a tax
+         * @description This endpoint is used to delete a tax.
          *
          * @tags taxes
          * @name DestroyTax
@@ -4680,5 +4848,128 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         fetchPublicKey: (params?: RequestParams) => Promise<HttpResponse<string, ApiErrorUnauthorized>>;
     };
+    webhookEndpoints: {
+        /**
+         * @description This endpoint is used to create a webhook endpoint.
+         *
+         * @tags webhook_endpoints
+         * @name CreateWebhookEndpoint
+         * @summary Create a webhook_endpoint
+         * @request POST:/webhook_endpoints
+         * @secure
+         */
+        createWebhookEndpoint: (data: {
+            webhook_endpoint?: {
+                /**
+                 * The URL of the webhook endpoint.
+                 * @example "https://foo.bar"
+                 */
+                webhook_url: string;
+                /**
+                 * The signature used for the webhook. If no value is passed,
+                 * @example "hmac"
+                 */
+                signature_algo?: "jwt" | "hmac" | null;
+            };
+        }, params?: RequestParams) => Promise<HttpResponse<{
+            webhook_endpoint: {
+                /**
+                 * Unique identifier assigned to the wallet within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the webhook endpoint's record within the Lago system.
+                 * @format uuid
+                 * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+                 */
+                lago_id: string;
+                /**
+                 * Unique identifier assigned to the organization attached to the webhook endpoint within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the organization’s record within the Lago system.
+                 * @format uuid
+                 * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+                 */
+                lago_organization_id: string;
+                /**
+                 * The name of the wallet.
+                 * @example "Prepaid"
+                 */
+                webhook_url: string;
+                /**
+                 * The signature algo for the webhook.
+                 * @example "hmac"
+                 */
+                signature_algo?: "jwt" | "hmac";
+                /**
+                 * The date of the webhook endpoint creation, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
+                 * @format date-time
+                 * @example "2022-04-29T08:59:51Z"
+                 */
+                created_at: string;
+            };
+        }, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity>>;
+        /**
+         * @description This endpoint is used to list all webhook endpoints.
+         *
+         * @tags webhook_endpoints
+         * @name FindAllWebhookEndpoints
+         * @summary List all webhook endpoints
+         * @request GET:/webhook_endpoints
+         * @secure
+         */
+        findAllWebhookEndpoints: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+        }, params?: RequestParams) => Promise<HttpResponse<{
+            webhook_endpoints: any[];
+            meta: PaginationMeta;
+        }, ApiErrorUnauthorized>>;
+        /**
+         * @description This endpoint is used to update an existing webhook endpoint.
+         *
+         * @tags webhook_endpoints
+         * @name UpdateWebhookEndpoint
+         * @summary Update a webhook endpoint
+         * @request PUT:/webhook_endpoints/{lago_id}
+         * @secure
+         */
+        updateWebhookEndpoint: (lagoId: string, data: {
+            webhook_endpoint?: {
+                /**
+                 * The URL of the webhook endpoint.
+                 * @example "https://foo.bar"
+                 */
+                webhook_url: string;
+                /**
+                 * The signature used for the webhook. If no value is passed,
+                 * @example "hmac"
+                 */
+                signature_algo?: "jwt" | "hmac" | null;
+            };
+        }, params?: RequestParams) => Promise<HttpResponse<any, ApiErrorBadRequest | ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint is used to retrieve an existing webhook endpoint.
+         *
+         * @tags webhook_endpoints
+         * @name FindWebhookEndpoint
+         * @summary Retrieve a webhook endpoint
+         * @request GET:/webhook_endpoints/{lago_id}
+         * @secure
+         */
+        findWebhookEndpoint: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<any, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint is used to delete an existing webhook endpoint.
+         *
+         * @tags webhook_endpoints
+         * @name DestroyWebhookEndpoint
+         * @summary Delete a webhook endpoint
+         * @request DELETE:/webhook_endpoints/{lago_id}
+         * @secure
+         */
+        destroyWebhookEndpoint: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<any, ApiErrorUnauthorized | ApiErrorNotAllowed | ApiErrorNotFound>>;
+    };
 }
 export {};