lago-javascript-client 1.30.0 → 1.31.0

package/esm/openapi/client.d.ts

@@ -572,14 +572,14 @@ export interface ActivityLogObject {
     /**
      * This field represents the final state of the object that the action was applied.
      * @format object
-     * @example "{ "id": "dad68bc7-c01a-4ad8-a87b-13e78693a5bc", "plan_id": "b9155544-e261-4e92-b54e-f65d7609294c", ... }"
+     * @example {"lago_id":"dad68bc7-c01a-4ad8-a87b-13e78693a5bc","plan_id":"b9155544-e261-4e92-b54e-f65d7609294c"}
      */
-    activity_object?: string | null;
+    activity_object?: object | null;
     /**
      * @format object
-     * @example "{ "plan_id": [null, "b9155544-e261-4e92-b54e-f65d7609294c"], ... }"
+     * @example {"plan_id":[null,"b9155544-e261-4e92-b54e-f65d7609294c"]}
      */
-    activity_object_changes?: string | null;
+    activity_object_changes?: object | null;
     /**
      * The customer external unique identifier (provided by your own application)
      * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
@@ -750,6 +750,73 @@ export interface AddOn {
 export interface AddOnUpdateInput {
     add_on: AddOnBaseInput;
 }
+export interface ApiLogObject {
+    /**
+     * Lago API version used in the request.
+     * @example "v1"
+     */
+    api_version: string;
+    /**
+     * The client used to make the request to the API.
+     * @example "Lago Ruby v1.26.0"
+     */
+    client: string;
+    /**
+     * This field represents the HTTP method of the request.
+     * @example "post"
+     */
+    http_method: "post" | "put" | "delete";
+    /**
+     * This field represents the HTTP status of the requests.
+     * @example 200
+     */
+    http_status: number;
+    /**
+     * The logged date of the api log, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
+     * @format date-time
+     * @example "2025-03-31T12:31:44Z"
+     */
+    logged_at: string;
+    /**
+     * @format object
+     * @example "{ "billable_metric": { "name": "Storage", "code": "storage" } }"
+     */
+    request_body: string;
+    /**
+     * This field represents the API origin of the requested URL
+     * @example "https://app.lago.dev/"
+     */
+    request_origin: string;
+    /**
+     * This field represents the API path of the requested URL
+     * @example "/billable_metrics"
+     */
+    request_path: string;
+    /**
+     * The creation date of the api log record in the Lago application, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
+     * @format date-time
+     * @example "2022-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * Unique identifier for the api log.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    request_id: string;
+    /**
+     * @format object
+     * @example "{ "lago_id": "b9155544-e261-4e92-b54e-f65d7609294c", ... }"
+     */
+    request_response?: string;
+}
+export interface ApiLogsPaginated {
+    api_logs: ApiLogObject[];
+    meta: PaginationMeta;
+}
+export interface ApiLog {
+    api_log: ApiLogObject;
+}
 export interface GrossRevenueObject {
     /**
      * Identifies the month to analyze revenue.
@@ -3918,6 +3985,26 @@ export interface InvoicePreviewInput {
      */
     billing_entity_code?: string;
 }
+/** Parameters available when voiding an invoice that optionally generate credit notes. */
+export interface InvoiceVoidInput {
+    /**
+     * Set to `true` to force voiding the invoice and generate a credit note.
+     * @example true
+     */
+    generate_credit_note?: boolean;
+    /**
+     * Portion of the invoice amount (in cents) to be refunded to the customer in the generated credit note.
+     * @min 0
+     * @example 2000
+     */
+    refund_amount?: number;
+    /**
+     * Portion of the invoice amount (in cents) to be credited to the customer's balance in the generated credit note.
+     * @min 0
+     * @example 1150
+     */
+    credit_amount?: number;
+}
 /** The custom billing settings for your organization. */
 export interface OrganizationBillingConfiguration {
     /**
@@ -4436,7 +4523,7 @@ export interface MinimumCommitmentObject {
 export interface ChargeProperties {
     /**
      * The list of event properties that are used to group the events on the invoice for a `standard` charge model.
-     * **DEPRECATED** Replaced by pricing_group_keys
+     * **DEPRECATED** Replaced by `pricing_group_keys`.
      * @deprecated
      * @example ["agent_name"]
      */
@@ -5652,6 +5739,14 @@ export interface WalletObject {
      * @example false
      */
     invoice_requires_successful_payment?: boolean;
+    /** Set wallet limitations to fee types. */
+    applies_to?: {
+        /**
+         * 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?: any[] | null;
+    };
     /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
     recurring_transaction_rules?: WalletRecurringTransactionRule[];
     /**
@@ -5737,6 +5832,14 @@ export interface WalletCreateInput {
             /** The corresponding value for the key. */
             value?: string;
         }[];
+        /** Set wallet limitations to fee types. */
+        applies_to?: {
+            /**
+             * 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?: any[] | null;
+        };
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
         recurring_transaction_rules?: {
             /**
@@ -5904,6 +6007,14 @@ export interface WalletUpdateInput {
                 value?: string;
             }[];
         }[];
+        /** Set wallet limitations to fee types. */
+        applies_to?: {
+            /**
+             * 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?: any[] | null;
+        };
     };
 }
 export interface WalletTransactionCreateInput {
@@ -6598,7 +6709,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.28.1
+ * @version 1.31.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -6690,17 +6801,17 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter results by activity types
              * @example ["billing_metric.created","billing_metric.updated"]
              */
-            activity_types?: string[];
+            "activity_types[]"?: string[];
             /**
              * Filter results by activity sources
              * @example ["api","front"]
              */
-            activity_sources?: ("api" | "front" | "system")[];
+            "activity_sources[]"?: ("api" | "front" | "system")[];
             /**
              * Filter results by user emails
              * @example ["dinesh@piedpiper.test"]
              */
-            user_emails?: string[];
+            "user_emails[]"?: string[];
             /**
              * Unique identifier assigned to the customer in your application.
              * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
@@ -6715,12 +6826,12 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter results by resources unique identifiers
              * @example ["5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba","1a901a90-1a90-1a90-1a90-1a901a901a90"]
              */
-            resource_ids?: string[];
+            "resource_ids[]"?: string[];
             /**
              * Filter results by resource class types
              * @example ["BillableMetric","Invoice"]
              */
-            resource_types?: string[];
+            "resource_types[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<ActivityLogsPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint retrieves an existing activity log that represents an action performed on some resource. The activity log is identified by its unique activity_id.
@@ -6796,6 +6907,71 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         destroyAddOn: (code: string, params?: RequestParams) => Promise<HttpResponse<AddOn, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
+    apiLogs: {
+        /**
+         * @description This endpoint retrieves all existing api logs that represent requests performed to Lago's API.
+         *
+         * @tags api_logs
+         * @name FindAllApiLogs
+         * @summary List all api logs
+         * @request GET:/api_logs
+         * @secure
+         */
+        findAllApiLogs: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /**
+             * Filter api logs from a specific date.
+             * @format date
+             * @example "2022-08-09"
+             */
+            from_date?: string;
+            /**
+             * Filter api logs up to a specific date.
+             * @format date
+             * @example "2022-08-09"
+             */
+            to_date?: string;
+            /**
+             * Filter results by HTTP methods
+             * @example ["post","put"]
+             */
+            "http_methods[]"?: ("post" | "put" | "delete")[];
+            /**
+             * Filter results by HTTP status or by generic request status
+             * @example ["failed","succeeded",404]
+             */
+            "http_statuses[]"?: ("succeeded" | "failed" | number)[];
+            /**
+             * Filter results by API version
+             * @example ["v1"]
+             */
+            "api_version[]"?: string[];
+            /**
+             * Filter results by the path of the request
+             * @example "/billable_metrics/"
+             */
+            request_paths?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<ApiLogsPaginated, ApiErrorUnauthorized>>;
+        /**
+         * @description This endpoint retrieves an existing api log that represents a request made to the API. The api log is identified by its unique request_id.
+         *
+         * @tags api_logs
+         * @name FindApiLog
+         * @summary Retrieve an api log
+         * @request GET:/api_logs/{request_id}
+         * @secure
+         */
+        findApiLog: (requestId: string, params?: RequestParams) => Promise<HttpResponse<ApiLog, ApiErrorUnauthorized | ApiErrorNotFound>>;
+    };
     analytics: {
         /**
          * @description Gross revenue is the sum of monthly `finalized` invoice payments and fees paid in advance that are not invoiceable. This total is calculated after deducting taxes and discounts.
@@ -7177,7 +7353,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter credit notes by billing entity codes.
              * @example ["billing_entity_code_1","billing_entity_code_2"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<CreditNotesPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint updates an existing credit note.
@@ -7265,12 +7441,12 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter customers by account type.
              * @example ["customer","partner"]
              */
-            account_type?: ("customer" | "partner")[];
+            "account_type[]"?: ("customer" | "partner")[];
             /**
              * Filter customers by billing entity codes.
              * @example ["billing_entity_code_1","billing_entity_code_2"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<CustomersPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint retrieves an existing customer.
@@ -7700,7 +7876,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter invoices by billing entity codes. Possible values are the billing entity codes you have created.
              * @example ["acme_corp","foo_bar"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
             /**
              * Filter invoices by metadata. Replace `key` with the actual metadata key you want to match, and provide the corresponding value. Providing empty value will search for invoice without given metadata key. For example, `metadata[color]=blue`.
              * @example "someValue"
@@ -7808,7 +7984,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         retryPayment: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<void, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
         /**
-         * @description This endpoint is used for voiding an invoice. You can void an invoice only when it's in a `finalized` status, and the payment status is not `succeeded`.
+         * @description This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this validation is bypassed: the invoice is forcibly voided and a credit note is generated. If the specified refund/credit amounts do not cover the full invoice total, the remainder is issued on a second credit note that is created and immediately voided.
          *
          * @tags invoices
          * @name VoidInvoice
@@ -7816,7 +7992,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/invoices/{lago_id}/void
          * @secure
          */
-        voidInvoice: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        voidInvoice: (lagoId: string, data?: InvoiceVoidInput, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     organizations: {
         /**

package/esm/openapi/client.js

@@ -148,7 +148,7 @@ export class HttpClient {
 }
 /**
  * @title Lago API documentation
- * @version 1.28.1
+ * @version 1.31.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -349,6 +349,41 @@ export class Api extends HttpClient {
             ...params,
         }),
     };
+    apiLogs = {
+        /**
+         * @description This endpoint retrieves all existing api logs that represent requests performed to Lago's API.
+         *
+         * @tags api_logs
+         * @name FindAllApiLogs
+         * @summary List all api logs
+         * @request GET:/api_logs
+         * @secure
+         */
+        findAllApiLogs: (query, params = {}) => this.request({
+            path: `/api_logs`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description This endpoint retrieves an existing api log that represents a request made to the API. The api log is identified by its unique request_id.
+         *
+         * @tags api_logs
+         * @name FindApiLog
+         * @summary Retrieve an api log
+         * @request GET:/api_logs/{request_id}
+         * @secure
+         */
+        findApiLog: (requestId, params = {}) => this.request({
+            path: `/api_logs/${requestId}`,
+            method: "GET",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+    };
     analytics = {
         /**
          * @description Gross revenue is the sum of monthly `finalized` invoice payments and fees paid in advance that are not invoiceable. This total is calculated after deducting taxes and discounts.
@@ -1294,7 +1329,7 @@ export class Api extends HttpClient {
             ...params,
         }),
         /**
-         * @description This endpoint is used for voiding an invoice. You can void an invoice only when it's in a `finalized` status, and the payment status is not `succeeded`.
+         * @description This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this validation is bypassed: the invoice is forcibly voided and a credit note is generated. If the specified refund/credit amounts do not cover the full invoice total, the remainder is issued on a second credit note that is created and immediately voided.
          *
          * @tags invoices
          * @name VoidInvoice
@@ -1302,10 +1337,12 @@ export class Api extends HttpClient {
          * @request POST:/invoices/{lago_id}/void
          * @secure
          */
-        voidInvoice: (lagoId, params = {}) => this.request({
+        voidInvoice: (lagoId, data, params = {}) => this.request({
             path: `/invoices/${lagoId}/void`,
             method: "POST",
+            body: data,
             secure: true,
+            type: ContentType.Json,
             format: "json",
             ...params,
         }),

package/package.json

@@ -3,7 +3,7 @@
   "main": "./script/mod.js",
   "name": "lago-javascript-client",
   "sideEffects": false,
-  "version": "v1.30.0",
+  "version": "v1.31.0",
   "description": "Lago JavaScript API Client",
   "repository": {
     "type": "git",

package/script/openapi/client.d.ts

@@ -572,14 +572,14 @@ export interface ActivityLogObject {
     /**
      * This field represents the final state of the object that the action was applied.
      * @format object
-     * @example "{ "id": "dad68bc7-c01a-4ad8-a87b-13e78693a5bc", "plan_id": "b9155544-e261-4e92-b54e-f65d7609294c", ... }"
+     * @example {"lago_id":"dad68bc7-c01a-4ad8-a87b-13e78693a5bc","plan_id":"b9155544-e261-4e92-b54e-f65d7609294c"}
      */
-    activity_object?: string | null;
+    activity_object?: object | null;
     /**
      * @format object
-     * @example "{ "plan_id": [null, "b9155544-e261-4e92-b54e-f65d7609294c"], ... }"
+     * @example {"plan_id":[null,"b9155544-e261-4e92-b54e-f65d7609294c"]}
      */
-    activity_object_changes?: string | null;
+    activity_object_changes?: object | null;
     /**
      * The customer external unique identifier (provided by your own application)
      * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
@@ -750,6 +750,73 @@ export interface AddOn {
 export interface AddOnUpdateInput {
     add_on: AddOnBaseInput;
 }
+export interface ApiLogObject {
+    /**
+     * Lago API version used in the request.
+     * @example "v1"
+     */
+    api_version: string;
+    /**
+     * The client used to make the request to the API.
+     * @example "Lago Ruby v1.26.0"
+     */
+    client: string;
+    /**
+     * This field represents the HTTP method of the request.
+     * @example "post"
+     */
+    http_method: "post" | "put" | "delete";
+    /**
+     * This field represents the HTTP status of the requests.
+     * @example 200
+     */
+    http_status: number;
+    /**
+     * The logged date of the api log, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
+     * @format date-time
+     * @example "2025-03-31T12:31:44Z"
+     */
+    logged_at: string;
+    /**
+     * @format object
+     * @example "{ "billable_metric": { "name": "Storage", "code": "storage" } }"
+     */
+    request_body: string;
+    /**
+     * This field represents the API origin of the requested URL
+     * @example "https://app.lago.dev/"
+     */
+    request_origin: string;
+    /**
+     * This field represents the API path of the requested URL
+     * @example "/billable_metrics"
+     */
+    request_path: string;
+    /**
+     * The creation date of the api log record in the Lago application, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
+     * @format date-time
+     * @example "2022-04-29T08:59:51Z"
+     */
+    created_at: string;
+    /**
+     * Unique identifier for the api log.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    request_id: string;
+    /**
+     * @format object
+     * @example "{ "lago_id": "b9155544-e261-4e92-b54e-f65d7609294c", ... }"
+     */
+    request_response?: string;
+}
+export interface ApiLogsPaginated {
+    api_logs: ApiLogObject[];
+    meta: PaginationMeta;
+}
+export interface ApiLog {
+    api_log: ApiLogObject;
+}
 export interface GrossRevenueObject {
     /**
      * Identifies the month to analyze revenue.
@@ -3918,6 +3985,26 @@ export interface InvoicePreviewInput {
      */
     billing_entity_code?: string;
 }
+/** Parameters available when voiding an invoice that optionally generate credit notes. */
+export interface InvoiceVoidInput {
+    /**
+     * Set to `true` to force voiding the invoice and generate a credit note.
+     * @example true
+     */
+    generate_credit_note?: boolean;
+    /**
+     * Portion of the invoice amount (in cents) to be refunded to the customer in the generated credit note.
+     * @min 0
+     * @example 2000
+     */
+    refund_amount?: number;
+    /**
+     * Portion of the invoice amount (in cents) to be credited to the customer's balance in the generated credit note.
+     * @min 0
+     * @example 1150
+     */
+    credit_amount?: number;
+}
 /** The custom billing settings for your organization. */
 export interface OrganizationBillingConfiguration {
     /**
@@ -4436,7 +4523,7 @@ export interface MinimumCommitmentObject {
 export interface ChargeProperties {
     /**
      * The list of event properties that are used to group the events on the invoice for a `standard` charge model.
-     * **DEPRECATED** Replaced by pricing_group_keys
+     * **DEPRECATED** Replaced by `pricing_group_keys`.
      * @deprecated
      * @example ["agent_name"]
      */
@@ -5652,6 +5739,14 @@ export interface WalletObject {
      * @example false
      */
     invoice_requires_successful_payment?: boolean;
+    /** Set wallet limitations to fee types. */
+    applies_to?: {
+        /**
+         * 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?: any[] | null;
+    };
     /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
     recurring_transaction_rules?: WalletRecurringTransactionRule[];
     /**
@@ -5737,6 +5832,14 @@ export interface WalletCreateInput {
             /** The corresponding value for the key. */
             value?: string;
         }[];
+        /** Set wallet limitations to fee types. */
+        applies_to?: {
+            /**
+             * 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?: any[] | null;
+        };
         /** List of recurring transaction rules. Currently, we only allow one recurring rule per wallet. */
         recurring_transaction_rules?: {
             /**
@@ -5904,6 +6007,14 @@ export interface WalletUpdateInput {
                 value?: string;
             }[];
         }[];
+        /** Set wallet limitations to fee types. */
+        applies_to?: {
+            /**
+             * 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?: any[] | null;
+        };
     };
 }
 export interface WalletTransactionCreateInput {
@@ -6598,7 +6709,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.28.1
+ * @version 1.31.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -6690,17 +6801,17 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter results by activity types
              * @example ["billing_metric.created","billing_metric.updated"]
              */
-            activity_types?: string[];
+            "activity_types[]"?: string[];
             /**
              * Filter results by activity sources
              * @example ["api","front"]
              */
-            activity_sources?: ("api" | "front" | "system")[];
+            "activity_sources[]"?: ("api" | "front" | "system")[];
             /**
              * Filter results by user emails
              * @example ["dinesh@piedpiper.test"]
              */
-            user_emails?: string[];
+            "user_emails[]"?: string[];
             /**
              * Unique identifier assigned to the customer in your application.
              * @example "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
@@ -6715,12 +6826,12 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter results by resources unique identifiers
              * @example ["5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba","1a901a90-1a90-1a90-1a90-1a901a901a90"]
              */
-            resource_ids?: string[];
+            "resource_ids[]"?: string[];
             /**
              * Filter results by resource class types
              * @example ["BillableMetric","Invoice"]
              */
-            resource_types?: string[];
+            "resource_types[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<ActivityLogsPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint retrieves an existing activity log that represents an action performed on some resource. The activity log is identified by its unique activity_id.
@@ -6796,6 +6907,71 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         destroyAddOn: (code: string, params?: RequestParams) => Promise<HttpResponse<AddOn, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
+    apiLogs: {
+        /**
+         * @description This endpoint retrieves all existing api logs that represent requests performed to Lago's API.
+         *
+         * @tags api_logs
+         * @name FindAllApiLogs
+         * @summary List all api logs
+         * @request GET:/api_logs
+         * @secure
+         */
+        findAllApiLogs: (query?: {
+            /**
+             * Page number.
+             * @example 1
+             */
+            page?: number;
+            /**
+             * Number of records per page.
+             * @example 20
+             */
+            per_page?: number;
+            /**
+             * Filter api logs from a specific date.
+             * @format date
+             * @example "2022-08-09"
+             */
+            from_date?: string;
+            /**
+             * Filter api logs up to a specific date.
+             * @format date
+             * @example "2022-08-09"
+             */
+            to_date?: string;
+            /**
+             * Filter results by HTTP methods
+             * @example ["post","put"]
+             */
+            "http_methods[]"?: ("post" | "put" | "delete")[];
+            /**
+             * Filter results by HTTP status or by generic request status
+             * @example ["failed","succeeded",404]
+             */
+            "http_statuses[]"?: ("succeeded" | "failed" | number)[];
+            /**
+             * Filter results by API version
+             * @example ["v1"]
+             */
+            "api_version[]"?: string[];
+            /**
+             * Filter results by the path of the request
+             * @example "/billable_metrics/"
+             */
+            request_paths?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<ApiLogsPaginated, ApiErrorUnauthorized>>;
+        /**
+         * @description This endpoint retrieves an existing api log that represents a request made to the API. The api log is identified by its unique request_id.
+         *
+         * @tags api_logs
+         * @name FindApiLog
+         * @summary Retrieve an api log
+         * @request GET:/api_logs/{request_id}
+         * @secure
+         */
+        findApiLog: (requestId: string, params?: RequestParams) => Promise<HttpResponse<ApiLog, ApiErrorUnauthorized | ApiErrorNotFound>>;
+    };
     analytics: {
         /**
          * @description Gross revenue is the sum of monthly `finalized` invoice payments and fees paid in advance that are not invoiceable. This total is calculated after deducting taxes and discounts.
@@ -7177,7 +7353,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter credit notes by billing entity codes.
              * @example ["billing_entity_code_1","billing_entity_code_2"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<CreditNotesPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint updates an existing credit note.
@@ -7265,12 +7441,12 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter customers by account type.
              * @example ["customer","partner"]
              */
-            account_type?: ("customer" | "partner")[];
+            "account_type[]"?: ("customer" | "partner")[];
             /**
              * Filter customers by billing entity codes.
              * @example ["billing_entity_code_1","billing_entity_code_2"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
         }, params?: RequestParams) => Promise<HttpResponse<CustomersPaginated, ApiErrorUnauthorized>>;
         /**
          * @description This endpoint retrieves an existing customer.
@@ -7700,7 +7876,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * Filter invoices by billing entity codes. Possible values are the billing entity codes you have created.
              * @example ["acme_corp","foo_bar"]
              */
-            billing_entity_codes?: string[];
+            "billing_entity_codes[]"?: string[];
             /**
              * Filter invoices by metadata. Replace `key` with the actual metadata key you want to match, and provide the corresponding value. Providing empty value will search for invoice without given metadata key. For example, `metadata[color]=blue`.
              * @example "someValue"
@@ -7808,7 +7984,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         retryPayment: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<void, ApiErrorUnauthorized | ApiErrorNotFound | ApiErrorNotAllowed>>;
         /**
-         * @description This endpoint is used for voiding an invoice. You can void an invoice only when it's in a `finalized` status, and the payment status is not `succeeded`.
+         * @description This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this validation is bypassed: the invoice is forcibly voided and a credit note is generated. If the specified refund/credit amounts do not cover the full invoice total, the remainder is issued on a second credit note that is created and immediately voided.
          *
          * @tags invoices
          * @name VoidInvoice
@@ -7816,7 +7992,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/invoices/{lago_id}/void
          * @secure
          */
-        voidInvoice: (lagoId: string, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
+        voidInvoice: (lagoId: string, data?: InvoiceVoidInput, params?: RequestParams) => Promise<HttpResponse<Invoice, ApiErrorUnauthorized | ApiErrorNotFound>>;
     };
     organizations: {
         /**

package/script/openapi/client.js

@@ -152,7 +152,7 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Lago API documentation
- * @version 1.28.1
+ * @version 1.31.0
  * @license AGPLv3
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -353,6 +353,41 @@ class Api extends HttpClient {
             ...params,
         }),
     };
+    apiLogs = {
+        /**
+         * @description This endpoint retrieves all existing api logs that represent requests performed to Lago's API.
+         *
+         * @tags api_logs
+         * @name FindAllApiLogs
+         * @summary List all api logs
+         * @request GET:/api_logs
+         * @secure
+         */
+        findAllApiLogs: (query, params = {}) => this.request({
+            path: `/api_logs`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description This endpoint retrieves an existing api log that represents a request made to the API. The api log is identified by its unique request_id.
+         *
+         * @tags api_logs
+         * @name FindApiLog
+         * @summary Retrieve an api log
+         * @request GET:/api_logs/{request_id}
+         * @secure
+         */
+        findApiLog: (requestId, params = {}) => this.request({
+            path: `/api_logs/${requestId}`,
+            method: "GET",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+    };
     analytics = {
         /**
          * @description Gross revenue is the sum of monthly `finalized` invoice payments and fees paid in advance that are not invoiceable. This total is calculated after deducting taxes and discounts.
@@ -1298,7 +1333,7 @@ class Api extends HttpClient {
             ...params,
         }),
         /**
-         * @description This endpoint is used for voiding an invoice. You can void an invoice only when it's in a `finalized` status, and the payment status is not `succeeded`.
+         * @description This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this validation is bypassed: the invoice is forcibly voided and a credit note is generated. If the specified refund/credit amounts do not cover the full invoice total, the remainder is issued on a second credit note that is created and immediately voided.
          *
          * @tags invoices
          * @name VoidInvoice
@@ -1306,10 +1341,12 @@ class Api extends HttpClient {
          * @request POST:/invoices/{lago_id}/void
          * @secure
          */
-        voidInvoice: (lagoId, params = {}) => this.request({
+        voidInvoice: (lagoId, data, params = {}) => this.request({
             path: `/invoices/${lagoId}/void`,
             method: "POST",
+            body: data,
             secure: true,
+            type: ContentType.Json,
             format: "json",
             ...params,
         }),