lago-javascript-client 1.50.0 → 1.52.1

package/esm/openapi/client.d.ts

@@ -2645,6 +2645,54 @@ export interface CustomerBaseObject {
     shipping_address?: Address;
     metadata?: CustomerMetadata[];
 }
+/** Configuration specific to the accounting and tax integrations. This object contains settings and parameters necessary for syncing documents and payments. */
+export interface IntegrationCustomer {
+    /**
+     * A unique identifier for the integration customer object in the Lago application.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * The integration type used for accounting and tax syncs.
+     * Accepted values: `netsuite, anrok`.
+     * @example "netsuite"
+     */
+    type: "netsuite" | "anrok" | "xero" | "hubspot" | "salesforce";
+    /**
+     * Unique code used to identify an integration connection.
+     * @example "netsuite-eu-1"
+     */
+    integration_code: string;
+    /**
+     * The customer ID within the integration's system. If this field is not provided, Lago has the option to create a new customer record within the integration's system on behalf of the customer.
+     * @example "cus_12345"
+     */
+    external_customer_id: string;
+    /**
+     * Set this field to `true` if you want to create a customer record in the integration's system. This option is applicable only when the `external_customer_id` is null and the `sync_with_provider` field is set to `true`. By default, the value is set to `false`
+     * @example true
+     */
+    sync_with_provider?: boolean | null;
+    /**
+     * This optional field is needed only when working with `netsuite` connection.
+     * @example "2"
+     */
+    subsidiary_id?: string;
+    /**
+     * This optional field is present only when working with `hubspot` connection.
+     * @example "contacts"
+     */
+    targeted_object?: string | null;
+    /**
+     * This optional field is present only when working with `hubspot` connection.
+     * @example "dinesh@piedpiper.test"
+     */
+    email?: string | null;
+}
+export type CustomerObject = CustomerBaseObject & {
+    integration_customers?: IntegrationCustomer[];
+};
 /**
  * Custom metadata stored as key-value pairs.
  * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
@@ -2699,6 +2747,11 @@ export interface CreditNoteObject {
      * @example "LAG-1234"
      */
     invoice_number: string;
+    /**
+     * The purchase order number of the invoice the credit note belongs to.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
     /**
      * The date of creation of the credit note. It follows the ISO 8601 date format and provides the specific date when the credit note was created.
      * @format date
@@ -2809,7 +2862,7 @@ export interface CreditNoteObject {
      * @example false
      */
     self_billed?: boolean;
-    customer?: CustomerBaseObject;
+    customer?: CustomerObject;
     /**
      * Custom metadata stored as key-value pairs.
      * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
@@ -2882,7 +2935,7 @@ export interface CreditNoteCreateInput {
     };
 }
 export type CreditNoteExtendedObject = CreditNoteObject & {
-    customer?: CustomerBaseObject;
+    customer?: CustomerObject;
 };
 export interface CreditNoteExtended {
     credit_note: CreditNoteExtendedObject;
@@ -3069,54 +3122,6 @@ export interface CreditNoteMetadataResponse {
      */
     metadata: MetadataObject;
 }
-/** Configuration specific to the accounting and tax integrations. This object contains settings and parameters necessary for syncing documents and payments. */
-export interface IntegrationCustomer {
-    /**
-     * A unique identifier for the integration customer object in the Lago application.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_id: string;
-    /**
-     * The integration type used for accounting and tax syncs.
-     * Accepted values: `netsuite, anrok`.
-     * @example "netsuite"
-     */
-    type: "netsuite" | "anrok" | "xero" | "hubspot" | "salesforce";
-    /**
-     * Unique code used to identify an integration connection.
-     * @example "netsuite-eu-1"
-     */
-    integration_code: string;
-    /**
-     * The customer ID within the integration's system. If this field is not provided, Lago has the option to create a new customer record within the integration's system on behalf of the customer.
-     * @example "cus_12345"
-     */
-    external_customer_id: string;
-    /**
-     * Set this field to `true` if you want to create a customer record in the integration's system. This option is applicable only when the `external_customer_id` is null and the `sync_with_provider` field is set to `true`. By default, the value is set to `false`
-     * @example true
-     */
-    sync_with_provider?: boolean | null;
-    /**
-     * This optional field is needed only when working with `netsuite` connection.
-     * @example "2"
-     */
-    subsidiary_id?: string;
-    /**
-     * This optional field is present only when working with `hubspot` connection.
-     * @example "contacts"
-     */
-    targeted_object?: string | null;
-    /**
-     * This optional field is present only when working with `hubspot` connection.
-     * @example "dinesh@piedpiper.test"
-     */
-    email?: string | null;
-}
-export type CustomerObject = CustomerBaseObject & {
-    integration_customers?: IntegrationCustomer[];
-};
 export interface ErrorDetailObject {
     /**
      * Unique identifier assigned to the error_detail within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the error's record within the Lago system.
@@ -3204,7 +3209,8 @@ export interface CustomerCreateInput {
          */
         logo_url?: string | null;
         /**
-         * The full name of the customer
+         * The full name of the customer (255 characters max).
+         * @maxLength 255
          * @example "Gavin Belson"
          */
         name?: string | null;
@@ -3372,6 +3378,11 @@ export interface InvoiceBaseObject {
      * @example "LAG-1234-001-002"
      */
     number: string;
+    /**
+     * The purchase order number associated with the invoice. It is inherited from the subscription, wallet or wallet transaction the invoice was generated for.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
     /**
      * The date when the invoice was issued. It is provided in the ISO 8601 date format.
      * @format date
@@ -3412,9 +3423,10 @@ export interface InvoiceBaseObject {
      * - `voided`: the invoice has been issued and subsequently voided. In this state, events cannot be ingested or added to the invoice anymore.
      * - `pending`: the invoice remains pending until the taxes are fetched from the external provider.
      * - `failed`: during an attempt of finalization of the invoice, an error happened. This invoice will have an array of error_details, explaining, in which part of the system an error happened and how it's possible to fix it. This invoice can't be edited or updated, only retried. This action will discard current error_details and will create new ones if the finalization failed again.
+     * - `deleted`: the draft invoice has been permanently deleted. This status is only returned by the delete endpoint and its webhook; a deleted invoice is no longer retrievable afterwards.
      * @example "finalized"
      */
-    status: "draft" | "finalized" | "voided" | "failed" | "pending";
+    status: "draft" | "finalized" | "voided" | "failed" | "pending" | "deleted";
     /**
      * The status of the payment associated with the invoice. It can have one of the following values:
      * - `pending`: the payment is pending, waiting for payment processing in Stripe or when the invoice is emitted but users have not updated the payment status through the endpoint.
@@ -3504,6 +3516,12 @@ export interface InvoiceBaseObject {
      * @example "https://getlago.com/invoice/file"
      */
     file_url?: string;
+    /**
+     * Contains the URL to the invoice page in the Lago dashboard. It is `null` for invoices that are not visible in the dashboard (for example while still generating). Use it to link users directly to the invoice overview page.
+     * @format uri
+     * @example "https://app.getlago.com/acme/customer/1a901a90-1a90-1a90-1a90-1a901a901a90/invoice/2b012b01-2b01-2b01-2b01-2b012b012b01/overview"
+     */
+    web_url?: string | null;
     /**
      * The date of the invoice 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 invoice object was created
      * @format date-time
@@ -3530,7 +3548,8 @@ export interface InvoiceMetadataObject {
      */
     key?: string;
     /**
-     * Represents the value of the metadata's key-value pair.
+     * Represents the value of the metadata's key-value pair (140 characters max).
+     * @maxLength 140
      * @example "INV-0123456-98765"
      */
     value?: string;
@@ -4057,13 +4076,14 @@ export interface SubscriptionObject {
      */
     consolidate_invoice?: boolean;
     /**
-     * The reason a payment-gated subscription was canceled before activation. Null unless the subscription was canceled by payment gating.
+     * The reason a payment-gated subscription was canceled while still `incomplete`. Null unless the subscription was canceled before activation.
      *
      * - `payment_failed`: the gating payment failed.
      * - `timeout`: the activation rule expired before the payment succeeded.
+     * - `manual`: the incomplete subscription was canceled on demand, via a terminate request with `status=incomplete`.
      * @example "payment_failed"
      */
-    cancellation_reason?: "payment_failed" | "timeout";
+    cancellation_reason?: "payment_failed" | "timeout" | "manual";
     /**
      * The date and time when a payment-gated subscription was activated (i.e. moved from `incomplete` to `active` once the gating payment succeeded), represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). Null while the subscription is still `incomplete`.
      * @format date-time
@@ -4072,11 +4092,24 @@ export interface SubscriptionObject {
     activated_at?: string | null;
     /** The activation rules attached to the subscription. A payment activation rule gates activation on a successful first payment, keeping the subscription in the `incomplete` state until the payment succeeds or the rule expires. */
     activation_rules?: SubscriptionActivationRuleObject[];
+    /**
+     * The purchase order number associated with the subscription. It will be added to invoices generated for this subscription.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
 }
 export interface SubscriptionsPaginated {
     subscriptions: SubscriptionObject[];
     meta: PaginationMeta;
 }
+/**
+ * Fee type to which a wallet can be restricted. It can be any of the following values:
+ *   - `charge`
+ *   - `subscription`
+ *   - `commitment`
+ *   - `fixed_charge`
+ */
+export type WalletFeeTypeEnum = "charge" | "subscription" | "commitment" | "fixed_charge";
 /** Object that represents rule for wallet recurring transactions. */
 export interface WalletRecurringTransactionRule {
     /**
@@ -4181,6 +4214,11 @@ export interface WalletRecurringTransactionRule {
     applied_invoice_custom_sections?: AppliedInvoiceCustomSectionObject[];
     /** The payment method assigned to this recurring transaction rule for processing top-up payments. */
     payment_method?: PaymentMethodReference;
+    /**
+     * The purchase order number associated with this recurring transaction rule. It will be added to invoices generated for the resulting wallet top-ups. If not set, falls back to the wallet's `purchase_order_number`.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
 }
 export interface WalletObject {
     /**
@@ -4296,7 +4334,7 @@ export interface WalletObject {
          * An array of fee types to which the wallet is applicable. By specifying the fee types in this field, you can restrict the wallet's usage to specific fee types only.
          * @example ["charge"]
          */
-        fee_types?: ("charge" | "subscription" | "commitment")[];
+        fee_types?: WalletFeeTypeEnum[];
         /**
          * 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"]
@@ -4341,6 +4379,11 @@ export interface WalletObject {
     applied_invoice_custom_sections?: AppliedInvoiceCustomSectionObject[];
     /** The payment method assigned to this wallet for processing top-up payments. */
     payment_method?: PaymentMethodReference;
+    /**
+     * The purchase order number associated with the wallet. It will be added to invoices generated for wallet top-ups, unless a more specific purchase order number is set on the wallet transaction or recurring transaction rule that triggered the top-up.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
     /**
      * Custom metadata stored as key-value pairs.
      * Keys are strings (max 100 characters), values can be strings (max 255 characters) or null.
@@ -4437,6 +4480,11 @@ export interface WalletCreateInput {
          * @example "Tokens for models 'high-fidelity-boost'"
          */
         transaction_name?: string | null;
+        /**
+         * The purchase order number associated with the wallet. It will be added to invoices generated for wallet top-ups, unless a more specific purchase order number is set on the wallet transaction or recurring transaction rule that triggered the top-up.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
         /** Set wallet limitations to fee types. */
         applies_to?: {
             /**
@@ -4513,6 +4561,11 @@ export interface WalletUpdateInput {
          * @example "default"
          */
         billing_entity_code?: string;
+        /**
+         * The purchase order number associated with the wallet. It will be added to invoices generated for wallet top-ups, unless a more specific purchase order number is set on the wallet transaction or recurring transaction rule that triggered the top-up.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
         /** Configuration for invoice custom sections to apply to invoices generated by this resource. */
         invoice_custom_section?: InvoiceCustomSectionInput;
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
@@ -4599,6 +4652,11 @@ export interface WalletUpdateInput {
              * @example "Tokens for models 'high-fidelity-boost'"
              */
             transaction_name?: string | null;
+            /**
+             * The purchase order number associated with this recurring transaction rule. It will be added to invoices generated for the resulting wallet top-ups. If not set, falls back to the wallet's `purchase_order_number`.
+             * @example "PO-123"
+             */
+            purchase_order_number?: string | null;
             /** Configuration for invoice custom sections to apply to invoices generated by this resource. */
             invoice_custom_section?: InvoiceCustomSectionInput;
             /** Optional payment method to use for processing recurring top-up payments. */
@@ -5712,6 +5770,11 @@ export interface InvoiceOneOffCreateInput {
          * @example "EUR"
          */
         currency?: Currency;
+        /**
+         * The purchase order number to associate with the invoice.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
         fees: {
             /**
              * The code of the add-on used as invoice item.
@@ -5844,7 +5907,8 @@ export interface InvoiceUpdateInput {
              */
             key?: string;
             /**
-             * The value in the key-value pair of the metadata.
+             * The value in the key-value pair of the metadata (140 characters max).
+             * @maxLength 140
              * @example "INV-0123456-98765"
              */
             value?: string;
@@ -6042,140 +6106,802 @@ export interface InvoiceVoidInput {
      */
     credit_amount?: number;
 }
-/** The custom billing settings for your organization. */
-export interface OrganizationBillingConfiguration {
+/**
+ * The status of the order form. It can be any of the following values:
+ *   - `generated`: the order form is waiting for the customer's signature.
+ *   - `signed`: the customer has signed, and an order has been created from the order form.
+ *   - `expired`: the order form reached its `expires_at` without being signed.
+ *   - `voided`: the order form has been voided before being signed.
+ *
+ * Only a `generated` order form is actionable. Reaching `expired` or `voided` also voids the quote version the order form was generated from; signing does not, since the deal it quotes goes on to be executed.
+ * @example "generated"
+ */
+export type OrderFormStatusEnum = "generated" | "signed" | "expired" | "voided";
+/**
+ * The reason why the order form is no longer actionable. It is `null` unless the `status` is `voided` or `expired`. It can be any of the following values:
+ *   - `manual`: the order form has been voided explicitly, through the API or the Lago user interface.
+ *   - `expired`: the order form reached its `expires_at` without being signed.
+ *   - `invalid`: reserved for an order form Lago voids because it can no longer be executed. No flow writes it yet.
+ * @example "manual"
+ */
+export type OrderFormVoidReasonEnum = "manual" | "expired" | "invalid";
+export interface OrderFormObject {
     /**
-     * The customer invoice message that appears at the bottom of each billing documents.
-     * @example "This is my customer footer"
+     * Unique identifier of the order form, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
      */
-    invoice_footer?: string | null;
+    lago_id: string;
     /**
-     * The grace period, expressed in days, for finalizing the invoice. This period refers to the additional time granted to your customers beyond the invoice due date to adjust usage and line items. Can be overwritten by the customer's grace period.
-     * @example 3
+     * The unique number assigned to the order form by Lago.
+     * @example "OF-2026-0001"
      */
-    invoice_grace_period?: number;
+    number: string;
     /**
-     * The locale of the billing documents, expressed in the ISO 639-1 format. This field indicates the language or regional variant used for the documents content issued or the embeddable customer portal.
-     * @example "en"
+     * The status of the order form. It can be any of the following values:
+     *   - `generated`: the order form is waiting for the customer's signature.
+     *   - `signed`: the customer has signed, and an order has been created from the order form.
+     *   - `expired`: the order form reached its `expires_at` without being signed.
+     *   - `voided`: the order form has been voided before being signed.
+     *
+     * Only a `generated` order form is actionable. Reaching `expired` or `voided` also voids the quote version the order form was generated from; signing does not, since the deal it quotes goes on to be executed.
      */
-    document_locale?: string;
-}
-export interface OrganizationUpdateInput {
-    organization: {
-        /**
-         * The URL of your newest updated webhook endpoint. This URL allows your organization to receive important messages, notifications, or data from the Lago system. By configuring your webhook endpoint to this URL, you can ensure that your organization stays informed and receives relevant information in a timely manner.
-         * @example "https://webhook.brex.com"
-         */
-        webhook_url?: string | null;
-        /**
-         * The country of your organization.
-         * @example "US"
-         */
-        country?: CountryOrNull;
-        /**
-         * The default currency of an organization.
-         * @example "USD"
-         */
-        default_currency?: Currency;
-        /**
-         * The first line of your organization's billing address.
-         * @example "100 Brex Street"
-         */
-        address_line1?: string | null;
-        /**
-         * The second line of your organization's billing address.
-         * @example null
-         */
-        address_line2?: string | null;
-        /**
-         * The state of your organization's billing address.
-         * @example "NYC"
-         */
-        state?: string | null;
-        /**
-         * The zipcode of your organization's billing address.
-         * @example "10000"
-         */
-        zipcode?: string | null;
-        /**
-         * The email address of your organization used to bill your customers.
-         * @format email
-         * @example "brex@brex.com"
-         */
-        email?: string | null;
-        /**
-         * The city of your organization's billing address.
-         * @example "New York"
-         */
-        city?: string | null;
-        /**
-         * The legal name of your organization.
-         * @example null
-         */
-        legal_name?: string | null;
-        /**
-         * The legal number of your organization.
-         * @example null
-         */
-        legal_number?: string | null;
-        /**
-         * This parameter configures the method of incrementing invoice numbers for your customers.
-         *
-         * - `per_customer`: Invoice numbers are incremented individually for each customer. This means every customer will have their own unique sequence of invoice numbers, separate from other customers. It ensures that each customer's invoice numbers follow a distinct and isolated numbering pattern.
-         * - `per_organization`: Invoice number incrementation is made across your entire organization. Rather than individual sequences for each customer, all invoices within the organization follow a single, unified numbering system. This creates a continuous and organization-wide sequence for all invoice numbers. Invoices are incremented per month (dynamic value used is YYYYMM), and invoice numbers are reset at the end of each month.
-         *
-         * The default value for `document_numbering` is set to `per_customer`, meaning that, unless changed, invoice numbers will increment uniquely for each customer.
-         * @example "per_customer"
-         */
-        document_numbering?: "per_customer" | "per_organization";
-        /**
-         * Sets the prefix for invoices and credit notes. Default is the first three letters of your organization name plus the last four digits of your organization ID. Customizable within 1-10 characters, and automatically capitalized by Lago.
-         * @example "ORG-1234"
-         */
-        document_number_prefix?: 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 tax identification number of your organization.
-         * @example "US123456789"
-         */
-        tax_identification_number?: string | null;
-        /**
-         * Your organization's timezone, used for billing purposes in your own local time. Can be overwritten by the customer's timezone.
-         * @example "America/New_York"
-         */
-        timezone?: Timezone;
-        /**
-         * Represents the email settings of the organization. It allows you to define which documents are sent by email. The field value determines the types of documents that trigger email notifications. Possible values for are `invoice.finalized` and `credit_note.created`. By configuring this field, you can specify whether invoices, credit notes, or both should be sent to recipients via email.
-         * @example ["invoice.finalized","credit_note.created"]
-         */
-        email_settings?: ("invoice.finalized" | "credit_note.created")[];
-        /** The custom billing settings for your organization. */
-        billing_configuration?: OrganizationBillingConfiguration;
-        /**
-         * Determines whether invoices with a zero total amount should be finalized. If set to true, zero amount invoices will be finalized. If set to false, zero amount invoices will not be finalized.
-         * @example false
-         */
-        finalize_zero_amount_invoice?: boolean;
-    };
-}
-export interface OrganizationObject {
+    status: OrderFormStatusEnum;
     /**
-     * Unique identifier assigned to the organization 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"
+     * The reason why the order form is no longer actionable. It is `null` unless the `status` is `voided` or `expired`. It can be any of the following values:
+     *   - `manual`: the order form has been voided explicitly, through the API or the Lago user interface.
+     *   - `expired`: the order form reached its `expires_at` without being signed.
+     *   - `invalid`: reserved for an order form Lago voids because it can no longer be executed. No flow writes it yet.
      */
-    lago_id: string;
+    void_reason: OrderFormVoidReasonEnum;
     /**
-     * The name of your organization.
-     * @example "Name1"
+     * The date and time in UTC (ISO 8601) after which the order form is meant to expire. It is `null` when the order form never expires. It is validated when the quote is approved, where a value on or after the day the quoted deal stops being executable is rejected rather than clamped. Expiry is then swept hourly and compared by calendar date, so signing keeps succeeding until the sweep moves the order form to `expired`.
+     * @format date-time
+     * @example "2026-06-30T23:59:59Z"
      */
-    name: string;
+    expires_at: string | null;
     /**
-     * The date of creation of your organization, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
+     * The date and time in UTC (ISO 8601) when the order form was marked as signed. It is `null` unless the `status` is `signed`.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    signed_at: string | null;
+    /**
+     * The date and time in UTC (ISO 8601) when the order form stopped being actionable. It is set both when the order form is voided and when it expires, and is `null` otherwise.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    voided_at: string | null;
+    /**
+     * The URL of the signed document attached to the order form. It is `null` when no document was uploaded.
+     * @format uri
+     * @example "https://api.getlago.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMi/OF-2026-0001"
+     */
+    signed_document_url: string | null;
+    /**
+     * Unique identifier of the organization, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_organization_id: string;
+    /**
+     * Unique identifier of the customer the order form is addressed to, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_customer_id: string;
+    /**
+     * Unique identifier of the quote the order form comes from, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_quote_id: string;
+    /**
+     * Unique identifier of the approved quote version the order form was generated from, created by Lago. A quote version carries at most one order form.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_quote_version_id: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the order form was created.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the order form was last updated.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    updated_at: string;
+}
+export interface OrderFormsPaginated {
+    order_forms: OrderFormObject[];
+    meta: PaginationMeta;
+}
+export interface OrderForm {
+    order_form: OrderFormObject;
+}
+/**
+ * How the order created from the order form is carried out. It can be any of the following values:
+ *   - `execute_in_lago`: Lago applies the quoted deal itself, creating the subscriptions, coupons, wallets or one-off invoice it describes.
+ *   - `order_only`: Lago records the order without applying it, leaving the execution to your own systems.
+ * @example "execute_in_lago"
+ */
+export type OrderExecutionModeEnum = "execute_in_lago" | "order_only";
+/** Parameters available when marking an order form as signed. Every parameter is optional, so an empty body records the signature without attaching a document, and creates an order that is not scheduled for execution. */
+export interface OrderFormMarkAsSignedInput {
+    order_form?: {
+        /**
+         * The document signed by the customer, as a base64 data URI (`data:<content_type>;base64,<data>`). Accepted content types are `application/pdf`, `image/jpeg` and `image/png`, for a maximum of 10 MB. Once attached, it is exposed as `signed_document_url` on the order form.
+         * @example "data:application/pdf;base64,JVBERi0xLjQKJcfs..."
+         */
+        signed_document?: string;
+        /** How the order created from the order form is carried out. It becomes mandatory as soon as `execute_at` is provided. */
+        execution_mode?: OrderExecutionModeEnum;
+        /**
+         * The date and time in UTC (ISO 8601) when Lago executes the order created from the order form. It must be in the future, requires `execution_mode` to be set, and must fall strictly before the day the quoted deal stops being executable, otherwise signing is rejected with a `422`. When it is omitted, the order is created but not scheduled, and waits to be executed on demand.
+         * @format date-time
+         * @example "2026-07-01T00:00:00Z"
+         */
+        execute_at?: string;
+    };
+}
+/**
+ * The status of the order. It can be any of the following values:
+ *   - `created`: the order has been created from a signed order form and is waiting to be executed.
+ *   - `executed`: the order has been carried out. What it produced is listed in `execution_record`.
+ *   - `failed`: the execution was attempted and rolled back. The reasons are listed in `execution_record.errors`. Lago does not retry on its own, so a new attempt has to be triggered through the execute endpoint.
+ * @example "created"
+ */
+export type OrderStatusEnum = "created" | "executed" | "failed";
+/**
+ * The commercial motion the quote describes. It can be any of the following values:
+ *   - `subscription_creation`: the quote creates one or more subscriptions.
+ *   - `subscription_amendment`: the quote amends an existing subscription, named by the quote's own `lago_subscription_id`.
+ *   - `one_off`: the quote bills add-ons once, without any subscription.
+ * @example "subscription_creation"
+ */
+export type QuoteOrderTypeEnum = "subscription_creation" | "subscription_amendment" | "one_off";
+/**
+ * How the order is carried out. It is `null` while the order has neither been scheduled nor executed. It can be any of the following values:
+ *   - `execute_in_lago`: Lago applies the quoted deal itself, creating the subscriptions, coupons, wallets or one-off invoice it describes.
+ *   - `order_only`: Lago records the order without applying it, leaving the execution to your own systems.
+ * @example "execute_in_lago"
+ */
+export type OrderExecutionModeEnumOrNull = "execute_in_lago" | "order_only";
+/**
+ * A trace of what the execution produced. Every key is always present, whichever the order type, so a reader never has to tell a missing key from an empty one; the keys that do not apply keep their empty value.
+ *
+ * Which ones are filled depends on the `order_type` of the quote, and only for an `execute_in_lago` order: `invoice_id` for `one_off`, `subscription_ids` with `applied_coupon_ids` and `wallet_ids` for `subscription_creation`, and the same plus `terminated_subscription_ids` for `subscription_amendment`. An `order_only` order records the mode and the timestamp alone.
+ */
+export interface OrderExecutionRecordObject {
+    /**
+     * The date and time in UTC (ISO 8601) when the execution succeeded. It is `null` until then, and stays `null` on a failed attempt.
+     * @format date-time
+     * @example "2026-07-01T00:00:00Z"
+     */
+    executed_at: string | null;
+    /** The mode the execution ran in. */
+    execution_mode: OrderExecutionModeEnumOrNull;
+    /**
+     * Unique identifier of the one-off invoice created by the execution, created by Lago. Only for a `one_off` order.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    invoice_id: string | null;
+    /**
+     * Unique identifiers of the subscriptions created by the execution, created by Lago.
+     * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+     */
+    subscription_ids: string[];
+    /**
+     * Unique identifiers of the subscriptions terminated by the execution, created by Lago. Only for a `subscription_amendment` order, and only when the amendment took effect immediately and terminated the subscription it replaced. It stays empty for an amendment scheduled for the next billing period.
+     * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+     */
+    terminated_subscription_ids: string[];
+    /**
+     * Unique identifiers of the coupons applied to the customer by the execution, created by Lago.
+     * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+     */
+    applied_coupon_ids: string[];
+    /**
+     * Unique identifiers of the prepaid credit wallets created by the execution, created by Lago.
+     * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+     */
+    wallet_ids: string[];
+    /**
+     * The reasons why the execution failed. It is empty unless the `status` is `failed`.
+     * @example ["plan_not_found"]
+     */
+    errors: string[];
+}
+export interface OrderObject {
+    /**
+     * Unique identifier of the order, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * The unique number assigned to the order by Lago.
+     * @example "OR-2026-0001"
+     */
+    number: string;
+    /**
+     * The status of the order. It can be any of the following values:
+     *   - `created`: the order has been created from a signed order form and is waiting to be executed.
+     *   - `executed`: the order has been carried out. What it produced is listed in `execution_record`.
+     *   - `failed`: the execution was attempted and rolled back. The reasons are listed in `execution_record.errors`. Lago does not retry on its own, so a new attempt has to be triggered through the execute endpoint.
+     */
+    status: OrderStatusEnum;
+    /**
+     * The commercial motion the quote describes. It can be any of the following values:
+     *   - `subscription_creation`: the quote creates one or more subscriptions.
+     *   - `subscription_amendment`: the quote amends an existing subscription, named by the quote's own `lago_subscription_id`.
+     *   - `one_off`: the quote bills add-ons once, without any subscription.
+     */
+    order_type: QuoteOrderTypeEnum;
+    /**
+     * How the order is carried out. It is `null` while the order has neither been scheduled nor executed. It can be any of the following values:
+     *   - `execute_in_lago`: Lago applies the quoted deal itself, creating the subscriptions, coupons, wallets or one-off invoice it describes.
+     *   - `order_only`: Lago records the order without applying it, leaving the execution to your own systems.
+     */
+    execution_mode: OrderExecutionModeEnumOrNull;
+    /** The currency the order is denominated in, inherited from the quote version it comes from. */
+    currency: CurrencyOrNull;
+    /**
+     * The date and time in UTC (ISO 8601) when the order was executed. It is `null` unless the `status` is `executed`.
+     * @format date-time
+     * @example "2026-07-01T00:00:00Z"
+     */
+    executed_at: string | null;
+    /**
+     * A trace of what the execution produced. Every key is always present, whichever the order type, so a reader never has to tell a missing key from an empty one; the keys that do not apply keep their empty value.
+     *
+     * Which ones are filled depends on the `order_type` of the quote, and only for an `execute_in_lago` order: `invoice_id` for `one_off`, `subscription_ids` with `applied_coupon_ids` and `wallet_ids` for `subscription_creation`, and the same plus `terminated_subscription_ids` for `subscription_amendment`. An `order_only` order records the mode and the timestamp alone.
+     */
+    execution_record: OrderExecutionRecordObject;
+    /**
+     * Unique identifier of the organization, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_organization_id: string;
+    /**
+     * Unique identifier of the customer the order was placed for, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_customer_id: string;
+    /**
+     * Unique identifier of the signed order form the order comes from, created by Lago. An order form carries at most one order.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_order_form_id: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the order was created.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the order was last updated.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    updated_at: string;
+}
+export interface QuoteBillingItemAddOnObject {
+    /**
+     * Unique identifier of the add-on in Lago, pinned when the entry was added to the quote.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    id: string;
+    /**
+     * Identifier of the entry within the quote version, assigned by the Lago user interface. It allows the quote document to reference the entry.
+     * @example "b5c1e2a4-4e1e-4a7f-9f0e-9c1a0c7e1f2b"
+     */
+    localId: string;
+    /**
+     * The kind of billing item.
+     * @example "add_on"
+     */
+    type: "add_on";
+    /** A snapshot of the add-on as it was added to the quote. `code`, `units`, `unitAmountCents` and `totalAmountCents` are required to approve the version. */
+    payload: {
+        /**
+         * Unique code identifying the add-on.
+         * @example "setup_fee"
+         */
+        code?: string;
+        /**
+         * The number of units billed. It must be greater than 0.
+         * @example 1
+         */
+        units?: number;
+        /**
+         * The amount of one unit, in cents, in the currency of the quote version.
+         * @example 10000
+         */
+        unitAmountCents?: number;
+        /**
+         * The total amount billed for the entry, in cents, in the currency of the quote version.
+         * @example 10000
+         */
+        totalAmountCents?: number;
+        /**
+         * The beginning of the period covered by the entry, in UTC (ISO 8601).
+         * @format date-time
+         * @example "2026-01-01T00:00:00Z"
+         */
+        fromDatetime?: string | null;
+        /**
+         * The end of the period covered by the entry, in UTC (ISO 8601).
+         * @format date-time
+         * @example "2026-12-31T23:59:59Z"
+         */
+        toDatetime?: string | null;
+    };
+    /** The deviations from the add-on snapshot negotiated on the quote. Only the properties set here are overridden. */
+    overrides?: {
+        /**
+         * Overrides the description of the add-on.
+         * @example "Onboarding package, discounted for the first year"
+         */
+        description?: string;
+        /**
+         * Overrides the number of units billed. It must be greater than 0.
+         * @example 2
+         */
+        units?: number;
+        /**
+         * Overrides the amount of one unit, in cents.
+         * @example 8000
+         */
+        unitAmountCents?: number;
+        /**
+         * Overrides the total amount billed for the entry, in cents.
+         * @example 16000
+         */
+        totalAmountCents?: number;
+        /**
+         * Overrides the name of the add-on as it appears on the invoice.
+         * @example "Onboarding"
+         */
+        invoiceDisplayName?: string;
+        /**
+         * Overrides the beginning of the period covered by the entry, in UTC (ISO 8601).
+         * @format date-time
+         * @example "2026-01-01T00:00:00Z"
+         */
+        fromDatetime?: string | null;
+        /**
+         * Overrides the end of the period covered by the entry, in UTC (ISO 8601).
+         * @format date-time
+         * @example "2026-12-31T23:59:59Z"
+         */
+        toDatetime?: string | null;
+    };
+}
+export interface QuoteBillingItemPlanObject {
+    /**
+     * Unique identifier of the plan in Lago, pinned when the entry was added to the quote.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    id: string;
+    /**
+     * Identifier of the entry within the quote version, assigned by the Lago user interface. It allows the quote document to reference the entry.
+     * @example "b5c1e2a4-4e1e-4a7f-9f0e-9c1a0c7e1f2b"
+     */
+    localId?: string | null;
+    /**
+     * The kind of billing item.
+     * @example "plan"
+     */
+    type: "plan";
+    /** A snapshot of the plan as it was added to the quote, and of the subscription to create from it. Additional catalog properties may be present, as only the ones Lago reads when the quote is executed are documented here. `code` is required to approve the version. */
+    payload: {
+        /**
+         * Unique code identifying the plan.
+         * @example "premium_plan"
+         */
+        code?: string;
+        /**
+         * The external unique identifier to assign to the subscription created from the entry. For a `subscription_amendment` quote, it identifies the subscription being amended.
+         * @example "sub_1234567890"
+         */
+        subscriptionExternalId?: string | null;
+        /**
+         * The name to assign to the subscription created from the entry.
+         * @example "Premium plan - Acme Corp"
+         */
+        subscriptionName?: string | null;
+        /**
+         * The billing time of the subscription created from the entry.
+         * @example "calendar"
+         */
+        billingTime?: "calendar" | "anniversary";
+        /**
+         * The date and time in UTC (ISO 8601) when the subscription starts. It is optional, and a plan naming none starts the moment the order is executed.
+         * @example "2026-01-01T00:00:00Z"
+         */
+        startDate?: string | null;
+        /**
+         * The date and time in UTC (ISO 8601) when the subscription ends. Leaving it unset makes the deal open-ended, and on a `subscription_amendment` quote it leaves the amended subscription's own ending date in place. It bounds the deal, so the signing window and the execution date must both fall strictly before it.
+         * @example "2027-01-01T00:00:00Z"
+         */
+        endDate?: string | null;
+        /**
+         * Unique identifier of the payment method to charge for the subscription, created by Lago.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        paymentMethodId?: string | null;
+        /** A snapshot of the usage-based charges of the plan. It pins the charge each entry of `overrides.charges` applies to. */
+        charges?: any[] | null;
+        /** A snapshot of the fixed charges of the plan. It pins the fixed charge each entry of `overrides.fixedCharges` applies to. */
+        fixedCharges?: any[] | null;
+    };
+    /** The deviations from the plan snapshot negotiated on the quote. Only the properties set here are overridden. */
+    overrides?: {
+        /**
+         * Overrides the base amount of the plan, in cents.
+         * @example 50000
+         */
+        amountCents?: number | null;
+        /** Overrides the currency the plan is priced in, which is how a catalog plan is quoted in the currency of the deal. The figure in `amountCents` is not converted, it is restated in this currency. It is set only while it differs from the catalog record, and removed once they agree. */
+        amountCurrency?: CurrencyOrNull;
+        /**
+         * Overrides the name of the plan as it appears on the invoice.
+         * @example "Premium"
+         */
+        invoiceDisplayName?: string | null;
+        /**
+         * Overrides the name of the plan.
+         * @example "Premium plan - Acme Corp"
+         */
+        name?: string | null;
+        /**
+         * Overrides the description of the plan.
+         * @example "Negotiated premium plan"
+         */
+        description?: string | null;
+        /**
+         * Overrides the trial period of the plan, in days.
+         * @example 30
+         */
+        trialPeriod?: number | null;
+        /** Overrides the minimum commitment of the plan. */
+        minimumCommitment?: {
+            /**
+             * The amount of the minimum commitment, in cents. It must be greater than 0.
+             * @example 100000
+             */
+            amountCents?: number | null;
+            /**
+             * The name of the minimum commitment as it appears on the invoice.
+             * @example "Annual commitment"
+             */
+            invoiceDisplayName?: string | null;
+        };
+        /** Overrides the progressive billing thresholds of the plan. */
+        usageThresholds?: any[] | null;
+        /** Overrides the usage-based charges of the plan. Each entry applies to the charge of the same billable metric in `payload.charges`. */
+        charges?: any[] | null;
+        /** Overrides the fixed charges of the plan. Each entry applies to the fixed charge of the same add-on in `payload.fixedCharges`. */
+        fixedCharges?: any[] | null;
+    };
+}
+export interface QuoteBillingItemCouponObject {
+    /**
+     * Unique identifier of the coupon in Lago, pinned when the entry was added to the quote.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    id: string;
+    /**
+     * Identifier of the entry within the quote version, assigned by the Lago user interface. It allows the quote document to reference the entry.
+     * @example "b5c1e2a4-4e1e-4a7f-9f0e-9c1a0c7e1f2b"
+     */
+    localId: string;
+    /**
+     * The kind of billing item.
+     * @example "coupon"
+     */
+    type: "coupon";
+    /** A snapshot of the coupon as it was added to the quote. `code` and `type` are required to approve the version. */
+    payload: {
+        /**
+         * Unique code identifying the coupon.
+         * @example "welcome_offer"
+         */
+        code?: string;
+        /**
+         * Whether the coupon deducts a fixed amount or a percentage.
+         * @example "fixed_amount"
+         */
+        type?: "fixed_amount" | "percentage";
+        /**
+         * The amount deducted by the coupon, in cents. Only for a `fixed_amount` coupon.
+         * @example 10000
+         */
+        amountCents?: number | null;
+        /** The currency of `amountCents`. Only for a `fixed_amount` coupon. */
+        currency?: CurrencyOrNull;
+        /**
+         * The percentage deducted by the coupon. Only for a `percentage` coupon. It must be greater than 0.
+         * @example 10.5
+         */
+        percentageRate?: number | null;
+        /**
+         * How often the coupon is deducted.
+         * @example "once"
+         */
+        frequency?: "once" | "recurring" | "forever";
+        /**
+         * The number of billing periods the coupon is deducted over. Only for a `recurring` coupon. It must be greater than 0.
+         * @example 3
+         */
+        frequencyDuration?: number | null;
+    };
+    /** The deviations from the coupon snapshot negotiated on the quote. Only the properties set here are overridden. */
+    overrides?: {
+        /**
+         * Overrides the amount deducted by the coupon, in cents.
+         * @example 15000
+         */
+        amountCents?: number | null;
+        /** Overrides the currency the coupon is priced in, which is how a catalog coupon is quoted in the currency of the deal. The figure in `amountCents` is not converted, it is restated in this currency. It is set only while it differs from the catalog record, and removed once they agree. */
+        amountCurrency?: CurrencyOrNull;
+        /**
+         * Overrides the percentage deducted by the coupon. It must be greater than 0.
+         * @example 15
+         */
+        percentageRate?: number | null;
+        /**
+         * Overrides how often the coupon is deducted.
+         * @example "recurring"
+         */
+        frequency?: "once" | "recurring" | "forever";
+        /**
+         * Overrides the number of billing periods the coupon is deducted over. It must be greater than 0.
+         * @example 6
+         */
+        frequencyDuration?: number | null;
+    };
+}
+export interface QuoteBillingItemWalletCreditObject {
+    /**
+     * Identifier of the entry within the quote version, assigned by the Lago user interface. It allows the quote document to reference the entry.
+     * @example "b5c1e2a4-4e1e-4a7f-9f0e-9c1a0c7e1f2b"
+     */
+    localId: string;
+    /**
+     * The kind of billing item.
+     * @example "wallet_credit"
+     */
+    type: "wallet_credit";
+    /** The prepaid credit wallet to create for the customer. Unlike the other billing items, a wallet credit is not built from an existing record, so it carries no `id` and no `overrides`. `paidCredits`, `grantedCredits` and `rateAmount` are required to approve the version. */
+    payload: {
+        /**
+         * The number of credits the customer pays for.
+         * @example "100.0"
+         */
+        paidCredits?: string | null;
+        /**
+         * The number of credits granted for free.
+         * @example "20.0"
+         */
+        grantedCredits?: string | null;
+        /**
+         * The value of one credit, in the currency of the wallet.
+         * @example "1.0"
+         */
+        rateAmount?: string | null;
+        /** The currency of the wallet. */
+        currency?: CurrencyOrNull;
+        /**
+         * The date and time in UTC (ISO 8601) when the credits expire.
+         * @format date-time
+         * @example "2027-01-01T00:00:00Z"
+         */
+        expirationAt?: string | null;
+        /** The limitations restricting what the credits can be spent on. */
+        appliesTo?: {
+            /**
+             * The fee types the credits can be spent on.
+             * @example ["charge"]
+             */
+            feeTypes?: any[] | null;
+            /**
+             * The codes of the billable metrics the credits can be spent on.
+             * @example ["api_calls"]
+             */
+            billableMetricCodes?: any[] | null;
+        };
+        /** The rule automatically topping the wallet up. At most one rule is allowed, and its `trigger` is required, to approve the version. */
+        recurringTransactionRules?: any[] | null;
+    };
+}
+/**
+ * A snapshot of everything the quote bills. Unlike the rest of the Lago API, the keys nested in this object are camelCased: the object is stored and returned as it is authored in the Lago user interface.
+ *
+ * Which top-level keys are present depends on the `order_type` of the parent quote:
+ *   - `one_off`: `addOns`.
+ *   - `subscription_creation` and `subscription_amendment`: `plans`, plus the optional `coupons` and `walletCredits`.
+ *
+ * Every entry pins the catalog record it was built from through its `id` and its `payload`, so that an approved quote keeps billing what was approved even if the catalog changes afterwards. The optional `overrides` object carries the deviations from that record negotiated on the quote.
+ *
+ * This object is the single source of truth for the term of the deal. Three of its nested dates bound that term, because the execution flow refuses them once past: `plans[].payload.endDate`, `walletCredits[].payload.expirationAt` and the `expirationAt` of a wallet credit's recurring top-up rule. The earliest of them is the day the deal stops being executable, and both the signing window and the execution date must fall strictly before it. A `one_off` quote carries none of them and is never bounded.
+ *
+ * On a `draft` version this object may be incomplete: only the properties documented as required below are enforced on every save, the others are enforced when the version is approved.
+ */
+export interface QuoteBillingItems {
+    /** The add-ons billed once by a `one_off` quote. At least one entry is required to approve the version. */
+    addOns?: QuoteBillingItemAddOnObject[];
+    /** The plans subscribed to, or amended, by a `subscription_creation` or `subscription_amendment` quote. At least one entry is required to approve the version. */
+    plans?: QuoteBillingItemPlanObject[];
+    /** The coupons applied to the customer when the quote is executed. */
+    coupons?: QuoteBillingItemCouponObject[];
+    /** The prepaid credit wallets created for the customer when the quote is executed. */
+    walletCredits?: QuoteBillingItemWalletCreditObject[];
+}
+export type OrderObjectExtended = OrderObject & {
+    /** The billing items of the quote version the order comes from, as they stood when it was approved. This is what the execution applies. It is omitted from the webhook payloads, being a heavy blob. */
+    billing_snapshot: QuoteBillingItems;
+};
+export interface OrdersPaginated {
+    orders: OrderObjectExtended[];
+    meta: PaginationMeta;
+}
+export interface Order {
+    order: OrderObjectExtended;
+}
+/** Parameters available when executing an order. The body is optional, as the execution mode is normally chosen when the order form is signed. */
+export interface OrderExecuteInput {
+    order?: {
+        /** How the order is carried out. It is only persisted when it differs from the mode already stored on the order, so restating the current mode never fails. Changing the mode of an order that has already been executed is rejected. */
+        execution_mode?: OrderExecutionModeEnum;
+    };
+}
+/** The custom billing settings for your organization. */
+export interface OrganizationBillingConfiguration {
+    /**
+     * The customer invoice message that appears at the bottom of each billing documents.
+     * @example "This is my customer footer"
+     */
+    invoice_footer?: string | null;
+    /**
+     * The grace period, expressed in days, for finalizing the invoice. This period refers to the additional time granted to your customers beyond the invoice due date to adjust usage and line items. Can be overwritten by the customer's grace period.
+     * @example 3
+     */
+    invoice_grace_period?: number;
+    /**
+     * The locale of the billing documents, expressed in the ISO 639-1 format. This field indicates the language or regional variant used for the documents content issued or the embeddable customer portal.
+     * @example "en"
+     */
+    document_locale?: string;
+}
+export interface OrganizationUpdateInput {
+    organization: {
+        /**
+         * The URL of your newest updated webhook endpoint. This URL allows your organization to receive important messages, notifications, or data from the Lago system. By configuring your webhook endpoint to this URL, you can ensure that your organization stays informed and receives relevant information in a timely manner.
+         * @example "https://webhook.brex.com"
+         */
+        webhook_url?: string | null;
+        /**
+         * The country of your organization.
+         * @example "US"
+         */
+        country?: CountryOrNull;
+        /**
+         * The default currency of an organization.
+         * @example "USD"
+         */
+        default_currency?: Currency;
+        /**
+         * The first line of your organization's billing address.
+         * @example "100 Brex Street"
+         */
+        address_line1?: string | null;
+        /**
+         * The second line of your organization's billing address.
+         * @example null
+         */
+        address_line2?: string | null;
+        /**
+         * The state of your organization's billing address.
+         * @example "NYC"
+         */
+        state?: string | null;
+        /**
+         * The zipcode of your organization's billing address.
+         * @example "10000"
+         */
+        zipcode?: string | null;
+        /**
+         * The email address of your organization used to bill your customers.
+         * @format email
+         * @example "brex@brex.com"
+         */
+        email?: string | null;
+        /**
+         * The city of your organization's billing address.
+         * @example "New York"
+         */
+        city?: string | null;
+        /**
+         * The legal name of your organization.
+         * @example null
+         */
+        legal_name?: string | null;
+        /**
+         * The legal number of your organization.
+         * @example null
+         */
+        legal_number?: string | null;
+        /**
+         * This parameter configures the method of incrementing invoice numbers for your customers.
+         *
+         * - `per_customer`: Invoice numbers are incremented individually for each customer. This means every customer will have their own unique sequence of invoice numbers, separate from other customers. It ensures that each customer's invoice numbers follow a distinct and isolated numbering pattern.
+         * - `per_organization`: Invoice number incrementation is made across your entire organization. Rather than individual sequences for each customer, all invoices within the organization follow a single, unified numbering system. This creates a continuous and organization-wide sequence for all invoice numbers. Invoices are incremented per month (dynamic value used is YYYYMM), and invoice numbers are reset at the end of each month.
+         *
+         * The default value for `document_numbering` is set to `per_customer`, meaning that, unless changed, invoice numbers will increment uniquely for each customer.
+         * @example "per_customer"
+         */
+        document_numbering?: "per_customer" | "per_organization";
+        /**
+         * Sets the prefix for invoices and credit notes. Default is the first three letters of your organization name plus the last four digits of your organization ID. Customizable within 1-10 characters, and automatically capitalized by Lago.
+         * @example "ORG-1234"
+         */
+        document_number_prefix?: 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 tax identification number of your organization.
+         * @example "US123456789"
+         */
+        tax_identification_number?: string | null;
+        /**
+         * Your organization's timezone, used for billing purposes in your own local time. Can be overwritten by the customer's timezone.
+         * @example "America/New_York"
+         */
+        timezone?: Timezone;
+        /**
+         * Represents the email settings of the organization. It allows you to define which documents are sent by email. The field value determines the types of documents that trigger email notifications. Possible values for are `invoice.finalized` and `credit_note.created`. By configuring this field, you can specify whether invoices, credit notes, or both should be sent to recipients via email.
+         * @example ["invoice.finalized","credit_note.created"]
+         */
+        email_settings?: ("invoice.finalized" | "credit_note.created")[];
+        /** The custom billing settings for your organization. */
+        billing_configuration?: OrganizationBillingConfiguration;
+        /**
+         * Determines whether invoices with a zero total amount should be finalized. If set to true, zero amount invoices will be finalized. If set to false, zero amount invoices will not be finalized.
+         * @example false
+         */
+        finalize_zero_amount_invoice?: boolean;
+    };
+}
+export interface OrganizationObject {
+    /**
+     * Unique identifier assigned to the organization 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_id: string;
+    /**
+     * The name of your organization.
+     * @example "Name1"
+     */
+    name: string;
+    /**
+     * The date of creation of your organization, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
      * @format date-time
      * @example "2022-05-02T13:04:09Z"
      */
@@ -7748,41 +8474,249 @@ export type FixedChargeInput = FixedChargeOverridableInput & {
     /**
      * Specifies whether a fixed charge is prorated based on the remaining number of days in the billing period or billed fully.
      *
-     * - If set to `true`, the charge is prorated based on the remaining days in the current billing period.
-     * - If set to `false`, the charge is billed in full.
-     * @example false
+     * - 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.
+     * @example false
+     */
+    prorated?: boolean;
+};
+export interface FixedChargeCreateInput {
+    fixed_charge: FixedChargeInput & {
+        /**
+         * This field determines whether the creation of the fixed charge should be cascaded to the children plans. When set to `true`, the fixed charge will be created in children plans. Conversely, when set to `false`, the fixed charge will only be created in the plan itself. If not defined in the request, default value is `false`.
+         * @example true
+         */
+        cascade_updates?: boolean;
+    };
+}
+export interface FixedCharge {
+    fixed_charge: FixedChargeObject;
+}
+export interface FixedChargeUpdateInput {
+    fixed_charge: FixedChargeInput & {
+        /**
+         * This field determines whether the changes made to the fixed charge should be cascaded to the children plans. When set to `true`, the changes will be cascaded into children. Conversely, when set to `false`, the changes will only be applied to the plan itself. If not defined in the request, default value is `false`.
+         * @example true
+         */
+        cascade_updates?: boolean;
+    };
+}
+export interface FixedChargeDeleteInput {
+    fixed_charge?: {
+        /**
+         * When set to `true`, the deletion will be cascaded to the children plans.
+         * @example true
+         */
+        cascade_updates?: boolean;
+    };
+}
+export interface QuoteBaseObject {
+    /**
+     * Unique identifier of the quote, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * The unique number assigned to the quote by Lago.
+     * @example "QT-2026-0001"
+     */
+    number: string;
+    /**
+     * The commercial motion the quote describes. It can be any of the following values:
+     *   - `subscription_creation`: the quote creates one or more subscriptions.
+     *   - `subscription_amendment`: the quote amends an existing subscription, named by the quote's own `lago_subscription_id`.
+     *   - `one_off`: the quote bills add-ons once, without any subscription.
+     */
+    order_type: QuoteOrderTypeEnum;
+    /**
+     * Unique identifier of the customer the quote is addressed to, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_customer_id: string;
+    /**
+     * Unique identifier of the subscription the quote amends, created by Lago. It is set only when the `order_type` is `subscription_amendment`.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_subscription_id: string | null;
+    /**
+     * Unique identifier of the organization, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_organization_id: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the quote was created.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the quote was last updated.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    updated_at: string;
+}
+/**
+ * The status of the quote version. It can be any of the following values:
+ *   - `draft`: the version is still editable.
+ *   - `approved`: the version has been approved and an order form has been generated from it.
+ *   - `voided`: the version is no longer actionable.
+ *
+ * A quote has at most one version in `draft` or `approved` status at any time; all the other versions are `voided`.
+ * @example "draft"
+ */
+export type QuoteVersionStatusEnum = "draft" | "approved" | "voided";
+/**
+ * The reason why the quote version was voided. It is `null` unless the `status` is `voided`. It can be any of the following values:
+ *   - `manual`: voided explicitly, through the API or the Lago user interface.
+ *   - `superseded`: voided because the version was cloned into a new draft.
+ *   - `cascade_of_expired`: voided because the order form generated from the version expired.
+ *   - `cascade_of_voided`: voided because the order form generated from the version was voided.
+ * @example "manual"
+ */
+export type QuoteVersionVoidReasonEnum = "manual" | "superseded" | "cascade_of_expired" | "cascade_of_voided";
+export interface QuoteVersionObject {
+    /**
+     * Unique identifier of the quote version, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * Unique identifier of the quote the version belongs to, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_quote_id: string;
+    /**
+     * Unique identifier of the organization, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_organization_id: string;
+    /**
+     * The number of the version within the quote. It starts at 1 and increases by 1 for every new version created by cloning.
+     * @example 1
+     */
+    version: number;
+    /**
+     * The status of the quote version. It can be any of the following values:
+     *   - `draft`: the version is still editable.
+     *   - `approved`: the version has been approved and an order form has been generated from it.
+     *   - `voided`: the version is no longer actionable.
+     *
+     * A quote has at most one version in `draft` or `approved` status at any time; all the other versions are `voided`.
+     */
+    status: QuoteVersionStatusEnum;
+    /** The currency the version is quoted in. */
+    currency: CurrencyOrNull;
+    /**
+     * Unique code identifying the billing entity that issues the deal. It is resolved rather than stored: the version's own entity when it names one, then the entity of the subscription being amended for a `subscription_amendment` quote, then the customer's own. It is `null` when none of them resolves. An amendment cannot name an entity itself, since the subscription it restates is already bound to one, and naming one on an amendment is rejected.
+     * @example "acme_corp"
+     */
+    billing_entity_code: string | null;
+    /**
+     * The reason why the quote version was voided. It is `null` unless the `status` is `voided`. It can be any of the following values:
+     *   - `manual`: voided explicitly, through the API or the Lago user interface.
+     *   - `superseded`: voided because the version was cloned into a new draft.
+     *   - `cascade_of_expired`: voided because the order form generated from the version expired.
+     *   - `cascade_of_voided`: voided because the order form generated from the version was voided.
+     */
+    void_reason: QuoteVersionVoidReasonEnum;
+    /**
+     * The date and time in UTC (ISO 8601) when the version was approved. It is `null` unless the `status` is `approved`.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    approved_at: string | null;
+    /**
+     * The date and time in UTC (ISO 8601) when the version was voided. It is `null` unless the `status` is `voided`.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    voided_at: string | null;
+    /**
+     * The date and time in UTC (ISO 8601) when the version was created.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * The date and time in UTC (ISO 8601) when the version was last updated.
+     * @format date-time
+     * @example "2026-04-29T08:59:51Z"
+     */
+    updated_at: string;
+}
+export type QuoteObject = QuoteBaseObject & {
+    /** The latest version of the quote. Its `content` and `billing_items` are omitted here; retrieve the version to get them. */
+    current_version: QuoteVersionObject | null;
+};
+export interface QuotesPaginated {
+    quotes: QuoteObject[];
+    meta: PaginationMeta;
+}
+export interface QuoteOwnerObject {
+    /**
+     * Unique identifier of the user owning the quote, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_id: string;
+    /**
+     * The email address of the user owning the quote.
+     * @format email
+     * @example "sales@getlago.com"
+     */
+    email: string | null;
+}
+export type QuoteObjectExtended = QuoteObject & {
+    /** The users of the organization responsible for the quote. */
+    owners: QuoteOwnerObject[];
+};
+export interface Quote {
+    quote: QuoteObjectExtended;
+}
+export interface QuoteVersionsPaginated {
+    quote_versions: QuoteVersionObject[];
+    meta: PaginationMeta;
+}
+export type QuoteVersionObjectExtended = QuoteVersionObject & {
+    /**
+     * The HTML body of the quote document, as authored in the Lago user interface. It may reference the entries of `billing_items` through their `localId`.
+     * @example "<h1>Quote QT-2026-0001</h1><p>Prepared for Acme Corp.</p>"
+     */
+    content: string | null;
+    /**
+     * A snapshot of everything the quote bills. Unlike the rest of the Lago API, the keys nested in this object are camelCased: the object is stored and returned as it is authored in the Lago user interface.
+     *
+     * Which top-level keys are present depends on the `order_type` of the parent quote:
+     *   - `one_off`: `addOns`.
+     *   - `subscription_creation` and `subscription_amendment`: `plans`, plus the optional `coupons` and `walletCredits`.
+     *
+     * Every entry pins the catalog record it was built from through its `id` and its `payload`, so that an approved quote keeps billing what was approved even if the catalog changes afterwards. The optional `overrides` object carries the deviations from that record negotiated on the quote.
+     *
+     * This object is the single source of truth for the term of the deal. Three of its nested dates bound that term, because the execution flow refuses them once past: `plans[].payload.endDate`, `walletCredits[].payload.expirationAt` and the `expirationAt` of a wallet credit's recurring top-up rule. The earliest of them is the day the deal stops being executable, and both the signing window and the execution date must fall strictly before it. A `one_off` quote carries none of them and is never bounded.
+     *
+     * On a `draft` version this object may be incomplete: only the properties documented as required below are enforced on every save, the others are enforced when the version is approved.
      */
-    prorated?: boolean;
+    billing_items: QuoteBillingItems;
 };
-export interface FixedChargeCreateInput {
-    fixed_charge: FixedChargeInput & {
-        /**
-         * This field determines whether the creation of the fixed charge should be cascaded to the children plans. When set to `true`, the fixed charge will be created in children plans. Conversely, when set to `false`, the fixed charge will only be created in the plan itself. If not defined in the request, default value is `false`.
-         * @example true
-         */
-        cascade_updates?: boolean;
-    };
-}
-export interface FixedCharge {
-    fixed_charge: FixedChargeObject;
+export interface QuoteVersion {
+    quote_version: QuoteVersionObjectExtended;
 }
-export interface FixedChargeUpdateInput {
-    fixed_charge: FixedChargeInput & {
-        /**
-         * This field determines whether the changes made to the fixed charge should be cascaded to the children plans. When set to `true`, the changes will be cascaded into children. Conversely, when set to `false`, the changes will only be applied to the plan itself. If not defined in the request, default value is `false`.
-         * @example true
-         */
-        cascade_updates?: boolean;
-    };
-}
-export interface FixedChargeDeleteInput {
-    fixed_charge?: {
-        /**
-         * When set to `true`, the deletion will be cascaded to the children plans.
-         * @example true
-         */
-        cascade_updates?: boolean;
-    };
+/** Parameters available when approving a quote version. */
+export interface QuoteVersionApproveInput {
+    /**
+     * The date and time in UTC (ISO 8601) when the order form generated by the approval expires. It must be in the future, and must fall strictly before the day the quoted deal stops being executable, otherwise the approval is rejected with a `422`. That boundary is the earliest of the `endDate` of any quoted plan and the `expirationAt` of any quoted wallet credit or recurring top-up rule. A `one_off` quote carries none of them, so its signing window is never bounded. When `expires_at` is omitted, the order form never expires.
+     * @format date-time
+     * @example "2026-06-30T23:59:59Z"
+     */
+    expires_at?: string;
 }
 /** Based plan overrides. */
 export interface PlanOverridesObject {
@@ -7906,7 +8840,10 @@ export interface PlanOverridesObject {
         /** List of taxes applied to the fixed charge. */
         tax_codes?: TaxCodes;
     }[];
-    /** List of usage thresholds applied to the subscription. */
+    /**
+     * **Deprecated.** Managing usage thresholds through `plan_overrides` is deprecated and its behavior is inconsistent: an empty array does not reliably clear thresholds (it is ignored the first time a subscription is overridden), and it never affects thresholds inherited from a parent plan. Use the top-level `usage_thresholds` array on the subscription instead, or `progressive_billing_disabled` to switch progressive billing off.
+     * @deprecated
+     */
     usage_thresholds?: UsageThresholdInput[];
     /** Metadata to set as key-value pairs. Keys are strings (max 100 characters), values can be strings (max 255 characters) or null. */
     metadata?: MetadataInput;
@@ -8003,6 +8940,25 @@ export interface SubscriptionCreateInput {
          * @example true
          */
         consolidate_invoice?: boolean;
+        /**
+         * The purchase order number associated with the subscription. It will be added to invoices generated for this subscription.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
+        /**
+         * Disables progressive billing for this subscription, regardless of any usage thresholds defined on the plan (including thresholds inherited from a parent plan when the subscription runs on a plan override).
+         *
+         * Set to `true` to switch progressive billing off for this subscription specifically, without changing the plan's thresholds.
+         * @default false
+         * @example true
+         */
+        progressive_billing_disabled?: boolean;
+        /**
+         * Usage thresholds managed directly on the subscription. This is the recommended way to set progressive billing thresholds per subscription; when present, they take precedence over the thresholds defined on the plan.
+         *
+         * This field cannot be combined with `plan_overrides.usage_thresholds` in the same request.
+         */
+        usage_thresholds?: UsageThresholdInput[];
         /** Optional list of activation rules that gate the subscription activation. When a `payment` rule is provided and the plan is paid in advance (and the subscription is not in a trial), the subscription is created in the `incomplete` state and is only activated once the gating payment succeeds. If the payment fails or the rule's `timeout_hours` elapses, the subscription is canceled. */
         activation_rules?: SubscriptionActivationRuleInput[];
     };
@@ -8075,6 +9031,25 @@ export interface SubscriptionUpdateInput {
          * @example "default"
          */
         billing_entity_code?: string;
+        /**
+         * The purchase order number associated with the subscription. It will be added to invoices generated for this subscription.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
+        /**
+         * Disables progressive billing for this subscription, regardless of any usage thresholds defined on the plan (including thresholds inherited from a parent plan when the subscription runs on a plan override).
+         *
+         * Set to `true` to switch progressive billing off for this subscription specifically. This is the recommended way to stop progressive billing on a subscription that inherits thresholds from its plan, since clearing `usage_thresholds` only removes subscription-level thresholds and does not remove those defined on (or inherited from) the plan.
+         * @default false
+         * @example true
+         */
+        progressive_billing_disabled?: boolean;
+        /**
+         * Usage thresholds managed directly on the subscription. This is the recommended way to set progressive billing thresholds per subscription; when present, they take precedence over the thresholds defined on the plan.
+         *
+         * Sending an empty array removes all subscription-level thresholds. This field cannot be combined with `plan_overrides.usage_thresholds` in the same request. To fully disable progressive billing on a subscription that inherits thresholds from its plan, use `progressive_billing_disabled` instead.
+         */
+        usage_thresholds?: UsageThresholdInput[];
         /** Optional list of activation rules that gate the subscription activation. Activation rules can only be set or modified while the subscription is `pending` (future-dated and not yet activated); the request is rejected for `incomplete`, `active`, or `terminated` subscriptions. */
         activation_rules?: SubscriptionActivationRuleInput[];
     };
@@ -8417,6 +9392,11 @@ export interface WalletTransactionCreateInput {
          * @example false
          */
         ignore_paid_top_up_limits?: boolean;
+        /**
+         * The purchase order number associated with this wallet transaction. It will be added to invoices generated for the resulting wallet top-up. If not set, falls back to the wallet's `purchase_order_number`.
+         * @example "PO-123"
+         */
+        purchase_order_number?: string | null;
         /** Configuration for invoice custom sections to apply to invoices generated by this resource. */
         invoice_custom_section?: InvoiceCustomSectionInput;
         /** Optional payment method to use for processing the wallet transaction payment. */
@@ -8549,6 +9529,11 @@ export interface WalletTransactionObject {
     applied_invoice_custom_sections?: AppliedInvoiceCustomSectionObject[];
     /** The payment method assigned to this wallet transaction for processing the payment. */
     payment_method: PaymentMethodReference;
+    /**
+     * The purchase order number associated with this wallet transaction. It will be added to invoices generated for the resulting wallet top-up. If not set, falls back to the wallet's `purchase_order_number`.
+     * @example "PO-123"
+     */
+    purchase_order_number?: string | null;
 }
 export interface WalletTransactions {
     wallet_transactions: WalletTransactionObject[];
@@ -8674,8 +9659,8 @@ export interface WebhookEndpointObject {
      */
     lago_organization_id: string;
     /**
-     * The name of the wallet.
-     * @example "Prepaid"
+     * The URL of the webhook endpoint.
+     * @example "https://foo.bar"
      */
     webhook_url: string;
     /**
@@ -8683,6 +9668,16 @@ export interface WebhookEndpointObject {
      * @example "hmac"
      */
     signature_algo?: "jwt" | "hmac";
+    /**
+     * The name of the webhook.
+     * @example "EC2-production"
+     */
+    name?: string | null;
+    /**
+     * A list of event types that will trigger the webhook. Passing null means that all event types will be sent.
+     * @example ["invoice.voided","customer.created"]
+     */
+    event_types?: any[] | null;
     /**
      * The date of the webhook endpoint creation, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC).
      * @format date-time
@@ -8706,6 +9701,16 @@ export interface WebhookEndpointCreateInput {
          * @example "hmac"
          */
         signature_algo?: "jwt" | "hmac";
+        /**
+         * The name of the webhook.
+         * @example "EC2-production"
+         */
+        name?: string | null;
+        /**
+         * A list of event types that will trigger the webhook. Passing null means that all event types will be sent.
+         * @example ["invoice.voided","customer.created"]
+         */
+        event_types?: any[] | null;
     };
 }
 export interface WebhookEndpoint {
@@ -8723,6 +9728,16 @@ export interface WebhookEndpointUpdateInput {
          * @example "hmac"
          */
         signature_algo?: "jwt" | "hmac";
+        /**
+         * The name of the webhook.
+         * @example "EC2-production"
+         */
+        name?: string | null;
+        /**
+         * A list of event types that will trigger the webhook. Passing null means that all event types will be sent.
+         * @example ["invoice.voided","customer.created"]
+         */
+        event_types?: any[] | null;
     };
 }
 export interface TriggeredAlertObject {
@@ -9132,6 +10147,10 @@ export interface PaymentRequestPaymentFailureObject {
     payment_provider_code?: string;
     provider_error?: string | Record<string, any>;
 }
+export type QuoteWithVersionObject = QuoteBaseObject & {
+    /** The version of the quote the event happened to. It is not necessarily the current version of the quote, as a `quote.voided` event triggered by a clone names the version that was voided while the quote already carries its replacement. Its `content` and `billing_items` are omitted here; retrieve the version to get them. */
+    version: QuoteVersionObject;
+};
 export type SubscriptionWithCustomerObject = SubscriptionObject & {
     plan: PlanObject;
     customer: CustomerObject;
@@ -9242,7 +10261,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.50.0
+ * @version 1.52.0
  * @license AGPLv3 (https://github.com/getlago/lago-openapi/blob/main/LICENSE)
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -10005,6 +11024,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "INV-001-002"
              */
             invoice_number?: string;
+            /**
+             * Filter by the invoice purchase order number. The match is exact but case-insensitive.
+             * @example "PO-123"
+             */
+            purchase_order_number?: string;
             /**
              * Filter credit notes of at least a specific amount. This parameter must be defined in cents to ensure consistent handling for all currency types.
              * @example 9000
@@ -10313,6 +11337,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "INV-001-002"
              */
             invoice_number?: string;
+            /**
+             * Filter by the invoice purchase order number. The match is exact but case-insensitive.
+             * @example "PO-123"
+             */
+            purchase_order_number?: string;
             /**
              * Filter credit notes of at least a specific amount. This parameter must be defined in cents to ensure consistent handling for all currency types.
              * @example 9000
@@ -10402,6 +11431,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "someValue"
              */
             "metadata[key]"?: string;
+            /**
+             * Filter by the invoice purchase order number. The match is exact but case-insensitive.
+             * @example "PO-123"
+             */
+            purchase_order_number?: string;
         }, params?: RequestParams) => Promise<HttpResponse<InvoicesPaginated, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorNotFound>>;
         /**
          * @description This endpoint is used to list all payments of a customer
@@ -11208,6 +12242,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example "someValue"
              */
             "metadata[key]"?: string;
+            /**
+             * Filter by the invoice purchase order number. The match is exact but case-insensitive.
+             * @example "PO-123"
+             */
+            purchase_order_number?: string;
         }, params?: RequestParams) => Promise<HttpResponse<InvoicesPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint is used for updating an existing invoice.
@@ -11229,6 +12268,16 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @secure
          */
         findInvoice: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint is used for permanently deleting a `draft` invoice. Deleting a draft invoice removes it entirely: it never becomes accounts receivable, consumes no invoice number, and disappears from every list, export, and analytics surface. Only invoices in the `draft` status can be deleted; for a `finalized` invoice, void it instead.
+         *
+         * @tags invoices
+         * @name DeleteInvoice
+         * @summary Delete a draft invoice
+         * @request DELETE:/invoices/{lago_id}
+         * @secure
+         */
+        deleteInvoice: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
         /**
          * @description This endpoint is used for downloading a specific invoice PDF document.
          *
@@ -11323,6 +12372,201 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         voidInvoice: (lagoId: string, data?: InvoiceVoidInput, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
+    orderForms: {
+        /**
+         * @description This endpoint is used to list all existing order forms. This is a premium feature.
+         *
+         * @tags order_forms
+         * @name FindAllOrderForms
+         * @summary List all order forms
+         * @request GET:/order_forms
+         * @secure
+         */
+        findAllOrderForms: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /** Filter order forms by status. Possible values are `generated`, `signed`, `expired` and `voided`. */
+            "status[]"?: ("generated" | "signed" | "expired" | "voided")[];
+            /**
+             * Filter order forms by the Lago identifiers of their customers.
+             * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+             */
+            "customer_id[]"?: string[];
+            /**
+             * Filter order forms by their number, as assigned by Lago.
+             * @example ["OF-2026-0001","OF-2026-0002"]
+             */
+            "number[]"?: string[];
+            /**
+             * Filter order forms by the number of the quote they come from.
+             * @example ["QT-2026-0001"]
+             */
+            "quote_number[]"?: string[];
+            /**
+             * Filter order forms by the Lago identifiers of the users owning the quote they come from.
+             * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+             */
+            "owner_id[]"?: string[];
+            /**
+             * Search order forms by number.
+             * @example "OF-2026"
+             */
+            search_term?: string;
+            /**
+             * Filter order forms created from a specific date and time, in UTC (ISO 8601).
+             * @format date-time
+             * @example "2026-01-01T00:00:00Z"
+             */
+            created_at_from?: string;
+            /**
+             * Filter order forms created up to a specific date and time, in UTC (ISO 8601).
+             * @format date-time
+             * @example "2026-12-31T23:59:59Z"
+             */
+            created_at_to?: string;
+            /**
+             * Filter order forms expiring from a specific date and time, in UTC (ISO 8601). Order forms that never expire are excluded.
+             * @format date-time
+             * @example "2026-01-01T00:00:00Z"
+             */
+            expires_at_from?: string;
+            /**
+             * Filter order forms expiring up to a specific date and time, in UTC (ISO 8601). Order forms that never expire are excluded.
+             * @format date-time
+             * @example "2026-12-31T23:59:59Z"
+             */
+            expires_at_to?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<OrderFormsPaginated, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden>>;
+        /**
+         * @description This endpoint retrieves a specific order form. This is a premium feature.
+         *
+         * @tags order_forms
+         * @name FindOrderForm
+         * @summary Retrieve an order form
+         * @request GET:/order_forms/{lago_id}
+         * @secure
+         */
+        findOrderForm: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<OrderForm, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint records the customer's signature on an order form, and creates the order that carries the quoted deal out. Only a `generated` order form can be signed, so a `422` is returned once the order form has been signed, has expired or has been voided. An `execute_at` landing on or after the day the quoted deal stops being executable is rejected as well, so the order can never be scheduled past the term it bills. A concurrent write on the same quote is reported as a `422` rather than retried, so a duplicated call can fail while the first one is still in flight. This is a premium feature.
+         *
+         * @tags order_forms
+         * @name MarkOrderFormAsSigned
+         * @summary Mark an order form as signed
+         * @request POST:/order_forms/{lago_id}/mark_as_signed
+         * @secure
+         */
+        markOrderFormAsSigned: (lagoId: string, data?: OrderFormMarkAsSignedInput, params?: RequestParams) => Promise<HttpResponse<OrderForm, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint voids an order form, with the `manual` reason, and cascades to the quote version it was generated from, which is voided with the `cascade_of_voided` reason. Only a `generated` order form can be voided, so a `422` is returned once the order form has been signed, has expired or has already been voided. A concurrent write on the same quote is reported as a `422` rather than retried, so a duplicated call can fail while the first one is still in flight. This is a premium feature.
+         *
+         * @tags order_forms
+         * @name VoidOrderForm
+         * @summary Void an order form
+         * @request POST:/order_forms/{lago_id}/void
+         * @secure
+         */
+        voidOrderForm: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<OrderForm, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+    };
+    orders: {
+        /**
+         * @description This endpoint is used to list all existing orders. This is a premium feature.
+         *
+         * @tags orders
+         * @name FindAllOrders
+         * @summary List all orders
+         * @request GET:/orders
+         * @secure
+         */
+        findAllOrders: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /** Filter orders by status. Possible values are `created`, `executed` and `failed`. */
+            "status[]"?: ("created" | "executed" | "failed")[];
+            /** Filter orders by the order type of the quote they come from. Possible values are `subscription_creation`, `subscription_amendment` and `one_off`. */
+            "order_type[]"?: ("subscription_creation" | "subscription_amendment" | "one_off")[];
+            /** Filter orders by execution mode. Possible values are `execute_in_lago` and `order_only`. */
+            "execution_mode[]"?: ("execute_in_lago" | "order_only")[];
+            /**
+             * Filter orders by the Lago identifiers of their customers.
+             * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+             */
+            "customer_id[]"?: string[];
+            /**
+             * Filter orders by their number, as assigned by Lago.
+             * @example ["OR-2026-0001","OR-2026-0002"]
+             */
+            "number[]"?: string[];
+            /**
+             * Filter orders by the number of the order form they come from.
+             * @example ["OF-2026-0001"]
+             */
+            "order_form_number[]"?: string[];
+            /**
+             * Filter orders by the number of the quote they come from.
+             * @example ["QT-2026-0001"]
+             */
+            "quote_number[]"?: string[];
+            /**
+             * Filter orders by the Lago identifiers of the users owning the quote they come from.
+             * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+             */
+            "owner_id[]"?: string[];
+            /**
+             * Search orders by number.
+             * @example "OR-2026"
+             */
+            search_term?: string;
+            /**
+             * Filter orders executed from a specific date and time, in UTC (ISO 8601). Orders that have not been executed are excluded.
+             * @format date-time
+             * @example "2026-01-01T00:00:00Z"
+             */
+            executed_at_from?: string;
+            /**
+             * Filter orders executed up to a specific date and time, in UTC (ISO 8601). Orders that have not been executed are excluded.
+             * @format date-time
+             * @example "2026-12-31T23:59:59Z"
+             */
+            executed_at_to?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<OrdersPaginated, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden>>;
+        /**
+         * @description This endpoint retrieves a specific order, along with the `billing_snapshot` its execution applies and the `execution_record` of what it produced. This is a premium feature.
+         *
+         * @tags orders
+         * @name FindOrder
+         * @summary Retrieve an order
+         * @request GET:/orders/{lago_id}
+         * @secure
+         */
+        findOrder: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Order, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint carries out an order on demand, without waiting for its `execute_at` schedule. It runs synchronously, so the response carries the resulting status and, when the execution fails, the reason it failed. An `execute_in_lago` order applies the quoted deal, creating the subscriptions, coupons, wallets or one-off invoice it describes; an `order_only` order is simply marked as executed. What the execution produced is listed in `execution_record`. Executing is idempotent: an order that has already been executed is returned untouched. An order whose previous execution failed is executed again, and a `422` is returned when the order carries no execution mode and none is provided in the body. Restating an `execution_mode` that differs from the one stored on the order updates it first, which only succeeds while the order is still `created`: a `failed` order can be retried, but not switched to another mode. That update also re-validates the order's own `execute_at` against the day the quoted deal stops being executable, so a `422` is possible even though no date was sent. An order carrying no `execute_at` is not bounded that way, and a deal whose term has passed then only fails when the execution runs. A `404` is not limited to an unknown order: when the execution cannot find a catalog record the quote pinned, such as a deleted plan, charge, coupon or the subscription being amended, the missing resource is reported as a `404` and the order is left `failed`. Concurrency is reported two ways. A mode change losing the race on the quote comes back as a `422` validation error, while the execution itself losing it comes back as a `422` carrying a lock code, because a scheduled execution relies on that error to be retried. This is a premium feature.
+         *
+         * @tags orders
+         * @name ExecuteOrder
+         * @summary Execute an order
+         * @request POST:/orders/{lago_id}/execute
+         * @secure
+         */
+        executeOrder: (lagoId: string, data?: OrderExecuteInput, params?: RequestParams) => Promise<HttpResponse<Order, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+    };
     organizations: {
         /**
          * @description This endpoint is used to update your own organization's settings.
@@ -11836,6 +13080,133 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         destroyPlanFixedCharge: (code: string, fixedChargeCode: string, data: FixedChargeDeleteInput, params?: RequestParams) => Promise<HttpResponse<FixedCharge, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
+    quotes: {
+        /**
+         * @description This endpoint is used to list all existing quotes. Quotes are ordered by creation date, from the most recent to the oldest. This is a premium feature.
+         *
+         * @tags quotes
+         * @name FindAllQuotes
+         * @summary List all quotes
+         * @request GET:/quotes
+         * @secure
+         */
+        findAllQuotes: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /** Filter quotes by the status of their current version. Possible values are `draft`, `approved` and `voided`. */
+            "status[]"?: ("draft" | "approved" | "voided")[];
+            /** Filter quotes by order type. Possible values are `subscription_creation`, `subscription_amendment` and `one_off`. */
+            "order_type[]"?: ("subscription_creation" | "subscription_amendment" | "one_off")[];
+            /**
+             * Filter quotes by their number, as assigned by Lago.
+             * @example ["QT-2026-0001","QT-2026-0002"]
+             */
+            "number[]"?: string[];
+            /**
+             * Filter quotes by the Lago identifiers of the users owning them.
+             * @example ["1a901a90-1a90-1a90-1a90-1a901a901a90"]
+             */
+            "owner_id[]"?: string[];
+            /**
+             * Filter quotes by the external unique identifiers of their customers (provided by your own application).
+             * @example ["external_id_1234"]
+             */
+            "external_customer_id[]"?: string[];
+            /**
+             * Filter quotes created from a specific date.
+             * @format date
+             * @example "2026-01-01"
+             */
+            from_date?: string;
+            /**
+             * Filter quotes created up to a specific date.
+             * @format date
+             * @example "2026-12-31"
+             */
+            to_date?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<QuotesPaginated, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden>>;
+        /**
+         * @description This endpoint retrieves a specific quote, along with its owners and its current version. This is a premium feature.
+         *
+         * @tags quotes
+         * @name FindQuote
+         * @summary Retrieve a quote
+         * @request GET:/quotes/{lago_id}
+         * @secure
+         */
+        findQuote: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Quote, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint is used to list all the versions of a specific quote, from the most recent to the oldest. The `content` and `billing_items` of each version are omitted; retrieve a version to get them. This is a premium feature.
+         *
+         * @tags quotes
+         * @name FindAllQuoteVersions
+         * @summary List all versions of a quote
+         * @request GET:/quotes/{lago_id}/versions
+         * @secure
+         */
+        findAllQuoteVersions: (lagoId: string, query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+        }, params?: RequestParams) => Promise<HttpResponse<QuoteVersionsPaginated, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
+    };
+    quoteVersions: {
+        /**
+         * @description This endpoint retrieves a specific quote version, along with its document `content` and its `billing_items`. This is a premium feature.
+         *
+         * @tags quotes
+         * @name FindQuoteVersion
+         * @summary Retrieve a quote version
+         * @request GET:/quote_versions/{lago_id}
+         * @secure
+         */
+        findQuoteVersion: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<QuoteVersion, ApiErrorUnauthorized | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint approves a quote version and generates the order form to send to the customer for signature. Only a `draft` version can be approved, and its `billing_items` must be complete: approval validates them against the catalog and against the customer, and returns a `422` when the deal cannot be executed as quoted. The `expires_at` of the generated order form is bounded by the deal's own term, so a signing window reaching beyond the day the deal stops being executable is rejected. A concurrent write on the same quote is reported as a `422` rather than retried, so a duplicated call can fail while the first one is still in flight. This is a premium feature.
+         *
+         * @tags quotes
+         * @name ApproveQuoteVersion
+         * @summary Approve a quote version
+         * @request POST:/quote_versions/{lago_id}/approve
+         * @secure
+         */
+        approveQuoteVersion: (lagoId: string, data?: QuoteVersionApproveInput, params?: RequestParams) => Promise<HttpResponse<QuoteVersion, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint voids a quote version, which makes it definitive: a voided version can neither be edited nor approved again. Only a `draft` version can be voided through this endpoint, and the resulting `void_reason` is `manual`. An `approved` version is voided by Lago itself, through the order form generated from it. A concurrent write on the same quote is reported as a `422` rather than retried, so a duplicated call can fail while the first one is still in flight. This is a premium feature.
+         *
+         * @tags quotes
+         * @name VoidQuoteVersion
+         * @summary Void a quote version
+         * @request POST:/quote_versions/{lago_id}/void
+         * @secure
+         */
+        voidQuoteVersion: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<QuoteVersion, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+        /**
+         * @description This endpoint copies a quote version into a new `draft` version of the same quote, so that the deal can be renegotiated. Any version of the quote can be cloned, but a quote can only carry one active version: the draft the quote currently holds, if any, is voided with the `superseded` reason. Cloning is therefore rejected with a `422` once a version of the quote has been approved. A concurrent write on the same quote is reported as a `422` rather than retried, so a duplicated call can fail while the first one is still in flight. This is a premium feature.
+         *
+         * @tags quotes
+         * @name CloneQuoteVersion
+         * @summary Clone a quote version
+         * @request POST:/quote_versions/{lago_id}/clone
+         * @secure
+         */
+        cloneQuoteVersion: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<QuoteVersion, ApiErrorUnauthorized | ApiErrorUnprocessableEntity | ApiErrorForbidden | ApiErrorNotFound>>;
+    };
     subscriptions: {
         /**
          * @description This endpoint assigns a plan to a customer, creating or modifying a subscription. Ideal for initial subscriptions or plan changes (upgrades/downgrades).
@@ -11940,8 +13311,12 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         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"
+             * Selects which subscription to terminate for the given `external_id`, based on its status. If the field is not defined, Lago targets only `active` subscriptions.
+             *
+             * - `pending`: cancel a subscription scheduled for a future activation (include `status=pending`).
+             * - `incomplete`: cancel a payment-gated subscription that is still awaiting its activation payment (include `status=incomplete`). The subscription is canceled with `cancellation_reason: manual`, its invoice is closed and nothing is billed, and any pending payment is canceled on a best-effort basis with the payment provider (some provider statuses cannot be canceled). Applied coupons, credit notes and wallet credits are recredited. Termination behaviours (`on_termination_credit_note`, `on_termination_invoice`) are ignored, as an incomplete subscription has never been billed.
+             * @default "active"
+             * @example "incomplete"
              */
             status?: string;
             /**