@flexprice/sdk 2.1.25 → 2.1.30

package/src/sdk/models/webhook-dto-subscription-line-item.ts

@@ -0,0 +1,108 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import {
+  BillingPeriod,
+  BillingPeriod$inboundSchema,
+} from "./billing-period.js";
+import {
+  InvoiceCadence,
+  InvoiceCadence$inboundSchema,
+} from "./invoice-cadence.js";
+import { PriceType, PriceType$inboundSchema } from "./price-type.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+import {
+  SubscriptionLineItemEntityType,
+  SubscriptionLineItemEntityType$inboundSchema,
+} from "./subscription-line-item-entity-type.js";
+import {
+  WebhookDtoPrice,
+  WebhookDtoPrice$inboundSchema,
+} from "./webhook-dto-price.js";
+
+export type WebhookDtoSubscriptionLineItem = {
+  billingPeriod?: BillingPeriod | undefined;
+  billingPeriodCount?: number | undefined;
+  currency?: string | undefined;
+  displayName?: string | undefined;
+  endDate?: Date | undefined;
+  entityId?: string | undefined;
+  entityType?: SubscriptionLineItemEntityType | undefined;
+  id?: string | undefined;
+  invoiceCadence?: InvoiceCadence | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  meterDisplayName?: string | undefined;
+  meterId?: string | undefined;
+  planDisplayName?: string | undefined;
+  price?: WebhookDtoPrice | undefined;
+  priceId?: string | undefined;
+  priceType?: PriceType | undefined;
+  priceUnit?: string | undefined;
+  quantity?: string | undefined;
+  startDate?: Date | undefined;
+  subscriptionId?: string | undefined;
+};
+
+/** @internal */
+export const WebhookDtoSubscriptionLineItem$inboundSchema: z.ZodMiniType<
+  WebhookDtoSubscriptionLineItem,
+  unknown
+> = z.pipe(
+  z.object({
+    billing_period: types.optional(BillingPeriod$inboundSchema),
+    billing_period_count: types.optional(types.number()),
+    currency: types.optional(types.string()),
+    display_name: types.optional(types.string()),
+    end_date: types.optional(types.date()),
+    entity_id: types.optional(types.string()),
+    entity_type: types.optional(SubscriptionLineItemEntityType$inboundSchema),
+    id: types.optional(types.string()),
+    invoice_cadence: types.optional(InvoiceCadence$inboundSchema),
+    metadata: types.optional(z.record(z.string(), types.string())),
+    meter_display_name: types.optional(types.string()),
+    meter_id: types.optional(types.string()),
+    plan_display_name: types.optional(types.string()),
+    price: types.optional(WebhookDtoPrice$inboundSchema),
+    price_id: types.optional(types.string()),
+    price_type: types.optional(PriceType$inboundSchema),
+    price_unit: types.optional(types.string()),
+    quantity: types.optional(types.string()),
+    start_date: types.optional(types.date()),
+    subscription_id: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "billing_period": "billingPeriod",
+      "billing_period_count": "billingPeriodCount",
+      "display_name": "displayName",
+      "end_date": "endDate",
+      "entity_id": "entityId",
+      "entity_type": "entityType",
+      "invoice_cadence": "invoiceCadence",
+      "meter_display_name": "meterDisplayName",
+      "meter_id": "meterId",
+      "plan_display_name": "planDisplayName",
+      "price_id": "priceId",
+      "price_type": "priceType",
+      "price_unit": "priceUnit",
+      "start_date": "startDate",
+      "subscription_id": "subscriptionId",
+    });
+  }),
+);
+
+export function webhookDtoSubscriptionLineItemFromJSON(
+  jsonString: string,
+): SafeParseResult<WebhookDtoSubscriptionLineItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WebhookDtoSubscriptionLineItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WebhookDtoSubscriptionLineItem' from JSON`,
+  );
+}

package/src/sdk/models/webhook-dto-subscription-webhook-payload.ts

@@ -8,6 +8,10 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "./sdk-validation-error.js";
+import {
+  WebhookDtoCustomer,
+  WebhookDtoCustomer$inboundSchema,
+} from "./webhook-dto-customer.js";
 import {
   WebhookDtoSubscription,
   WebhookDtoSubscription$inboundSchema,
@@ -18,6 +22,7 @@ import {
 } from "./webhook-event-name.js";
 
 export type WebhookDtoSubscriptionWebhookPayload = {
+  customer?: WebhookDtoCustomer | undefined;
   eventType?: WebhookEventName | undefined;
   subscription?: WebhookDtoSubscription | undefined;
 };
@@ -28,6 +33,7 @@ export const WebhookDtoSubscriptionWebhookPayload$inboundSchema: z.ZodMiniType<
   unknown
 > = z.pipe(
   z.object({
+    customer: types.optional(WebhookDtoCustomer$inboundSchema),
     event_type: types.optional(WebhookEventName$inboundSchema),
     subscription: types.optional(WebhookDtoSubscription$inboundSchema),
   }),

package/src/sdk/models/webhook-dto-subscription.ts

@@ -25,10 +25,22 @@ import {
   SubscriptionType,
   SubscriptionType$inboundSchema,
 } from "./subscription-type.js";
+import {
+  WebhookDtoCouponAssociation,
+  WebhookDtoCouponAssociation$inboundSchema,
+} from "./webhook-dto-coupon-association.js";
 import {
   WebhookDtoCustomer,
   WebhookDtoCustomer$inboundSchema,
 } from "./webhook-dto-customer.js";
+import {
+  WebhookDtoPlan,
+  WebhookDtoPlan$inboundSchema,
+} from "./webhook-dto-plan.js";
+import {
+  WebhookDtoSubscriptionLineItem,
+  WebhookDtoSubscriptionLineItem$inboundSchema,
+} from "./webhook-dto-subscription-line-item.js";
 
 export type WebhookDtoSubscription = {
   billingCadence?: BillingCadence | undefined;
@@ -37,6 +49,7 @@ export type WebhookDtoSubscription = {
   cancelAt?: Date | undefined;
   cancelAtPeriodEnd?: boolean | undefined;
   cancelledAt?: Date | undefined;
+  couponAssociations?: Array<WebhookDtoCouponAssociation> | undefined;
   currency?: string | undefined;
   currentPeriodEnd?: Date | undefined;
   currentPeriodStart?: Date | undefined;
@@ -44,10 +57,13 @@ export type WebhookDtoSubscription = {
   customerId?: string | undefined;
   endDate?: Date | undefined;
   id?: string | undefined;
+  invoicingCustomerId?: string | undefined;
+  lineItems?: Array<WebhookDtoSubscriptionLineItem> | undefined;
   lookupKey?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
   parentSubscriptionId?: string | undefined;
   pauseStatus?: PauseStatus | undefined;
+  plan?: WebhookDtoPlan | undefined;
   planId?: string | undefined;
   startDate?: Date | undefined;
   subscriptionStatus?: SubscriptionStatus | undefined;
@@ -68,6 +84,9 @@ export const WebhookDtoSubscription$inboundSchema: z.ZodMiniType<
     cancel_at: types.optional(types.date()),
     cancel_at_period_end: types.optional(types.boolean()),
     cancelled_at: types.optional(types.date()),
+    coupon_associations: types.optional(
+      z.array(WebhookDtoCouponAssociation$inboundSchema),
+    ),
     currency: types.optional(types.string()),
     current_period_end: types.optional(types.date()),
     current_period_start: types.optional(types.date()),
@@ -75,10 +94,15 @@ export const WebhookDtoSubscription$inboundSchema: z.ZodMiniType<
     customer_id: types.optional(types.string()),
     end_date: types.optional(types.date()),
     id: types.optional(types.string()),
+    invoicing_customer_id: types.optional(types.string()),
+    line_items: types.optional(
+      z.array(WebhookDtoSubscriptionLineItem$inboundSchema),
+    ),
     lookup_key: types.optional(types.string()),
     metadata: types.optional(z.record(z.string(), types.string())),
     parent_subscription_id: types.optional(types.string()),
     pause_status: types.optional(PauseStatus$inboundSchema),
+    plan: types.optional(WebhookDtoPlan$inboundSchema),
     plan_id: types.optional(types.string()),
     start_date: types.optional(types.date()),
     subscription_status: types.optional(SubscriptionStatus$inboundSchema),
@@ -94,10 +118,13 @@ export const WebhookDtoSubscription$inboundSchema: z.ZodMiniType<
       "cancel_at": "cancelAt",
       "cancel_at_period_end": "cancelAtPeriodEnd",
       "cancelled_at": "cancelledAt",
+      "coupon_associations": "couponAssociations",
       "current_period_end": "currentPeriodEnd",
       "current_period_start": "currentPeriodStart",
       "customer_id": "customerId",
       "end_date": "endDate",
+      "invoicing_customer_id": "invoicingCustomerId",
+      "line_items": "lineItems",
       "lookup_key": "lookupKey",
       "parent_subscription_id": "parentSubscriptionId",
       "pause_status": "pauseStatus",

package/src/sdk/models/webhook-dto-tax-applied.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+import { TaxBehavior, TaxBehavior$inboundSchema } from "./tax-behavior.js";
+import {
+  WebhookDtoTaxRate,
+  WebhookDtoTaxRate$inboundSchema,
+} from "./webhook-dto-tax-rate.js";
+
+export type WebhookDtoTaxApplied = {
+  appliedAt?: Date | undefined;
+  currency?: string | undefined;
+  id?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  taxAmount?: string | undefined;
+  taxBehavior?: TaxBehavior | undefined;
+  taxRate?: WebhookDtoTaxRate | undefined;
+  taxRateId?: string | undefined;
+  taxableAmount?: string | undefined;
+};
+
+/** @internal */
+export const WebhookDtoTaxApplied$inboundSchema: z.ZodMiniType<
+  WebhookDtoTaxApplied,
+  unknown
+> = z.pipe(
+  z.object({
+    applied_at: types.optional(types.date()),
+    currency: types.optional(types.string()),
+    id: types.optional(types.string()),
+    metadata: types.optional(z.record(z.string(), types.string())),
+    tax_amount: types.optional(types.string()),
+    tax_behavior: types.optional(TaxBehavior$inboundSchema),
+    tax_rate: types.optional(WebhookDtoTaxRate$inboundSchema),
+    tax_rate_id: types.optional(types.string()),
+    taxable_amount: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "applied_at": "appliedAt",
+      "tax_amount": "taxAmount",
+      "tax_behavior": "taxBehavior",
+      "tax_rate": "taxRate",
+      "tax_rate_id": "taxRateId",
+      "taxable_amount": "taxableAmount",
+    });
+  }),
+);
+
+export function webhookDtoTaxAppliedFromJSON(
+  jsonString: string,
+): SafeParseResult<WebhookDtoTaxApplied, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WebhookDtoTaxApplied$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WebhookDtoTaxApplied' from JSON`,
+  );
+}

package/src/sdk/models/webhook-dto-tax-rate.ts

@@ -0,0 +1,51 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+import { TaxRateType, TaxRateType$inboundSchema } from "./tax-rate-type.js";
+
+export type WebhookDtoTaxRate = {
+  code?: string | undefined;
+  description?: string | undefined;
+  id?: string | undefined;
+  name?: string | undefined;
+  percentageValue?: string | undefined;
+  taxRateType?: TaxRateType | undefined;
+};
+
+/** @internal */
+export const WebhookDtoTaxRate$inboundSchema: z.ZodMiniType<
+  WebhookDtoTaxRate,
+  unknown
+> = z.pipe(
+  z.object({
+    code: types.optional(types.string()),
+    description: types.optional(types.string()),
+    id: types.optional(types.string()),
+    name: types.optional(types.string()),
+    percentage_value: types.optional(types.string()),
+    tax_rate_type: types.optional(TaxRateType$inboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "percentage_value": "percentageValue",
+      "tax_rate_type": "taxRateType",
+    });
+  }),
+);
+
+export function webhookDtoTaxRateFromJSON(
+  jsonString: string,
+): SafeParseResult<WebhookDtoTaxRate, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WebhookDtoTaxRate$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WebhookDtoTaxRate' from JSON`,
+  );
+}

package/src/sdk/models/webhook-dto-wallet-webhook-payload.ts

@@ -8,6 +8,10 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "./sdk-validation-error.js";
+import {
+  WebhookDtoCustomer,
+  WebhookDtoCustomer$inboundSchema,
+} from "./webhook-dto-customer.js";
 import {
   WebhookDtoWalletAlertInfo,
   WebhookDtoWalletAlertInfo$inboundSchema,
@@ -23,6 +27,7 @@ import {
 
 export type WebhookDtoWalletWebhookPayload = {
   alert?: WebhookDtoWalletAlertInfo | undefined;
+  customer?: WebhookDtoCustomer | undefined;
   eventType?: WebhookEventName | undefined;
   wallet?: WebhookDtoWallet | undefined;
 };
@@ -34,6 +39,7 @@ export const WebhookDtoWalletWebhookPayload$inboundSchema: z.ZodMiniType<
 > = z.pipe(
   z.object({
     alert: types.optional(WebhookDtoWalletAlertInfo$inboundSchema),
+    customer: types.optional(WebhookDtoCustomer$inboundSchema),
     event_type: types.optional(WebhookEventName$inboundSchema),
     wallet: types.optional(WebhookDtoWallet$inboundSchema),
   }),

package/src/sdk/models/webhook-event-name.ts

@@ -35,6 +35,9 @@ export const WebhookEventName = {
   PaymentFailed: "payment.failed",
   PaymentSuccess: "payment.success",
   PaymentPending: "payment.pending",
+  RefundCreated: "refund.created",
+  RefundSucceeded: "refund.succeeded",
+  RefundFailed: "refund.failed",
   CustomerCreated: "customer.created",
   CustomerUpdated: "customer.updated",
   CustomerDeleted: "customer.deleted",

package/src/sdk/refunds.ts

@@ -0,0 +1,63 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { refundsGetRefund } from "../funcs/refunds-get-refund.js";
+import { refundsListRefunds } from "../funcs/refunds-list-refunds.js";
+import { refundsRetryRefund } from "../funcs/refunds-retry-refund.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import * as models from "./models/index.js";
+
+export class Refunds extends ClientSDK {
+  /**
+   * List refunds
+   *
+   * @remarks
+   * Use to see where refunded money actually went and whether it has settled. Filter by invoice_ids to get every settlement row for one invoice.
+   */
+  async listRefunds(
+    request?: models.ListRefundsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListRefundsResponse> {
+    return unwrapAsync(refundsListRefunds(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get refund
+   *
+   * @remarks
+   * Use to inspect a single refund: its destination, settled amount and failure reason.
+   */
+  async getRefund(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.RefundResponse> {
+    return unwrapAsync(refundsGetRefund(
+      this,
+      id,
+      options,
+    ));
+  }
+
+  /**
+   * Retry refund
+   *
+   * @remarks
+   * Use when a refund failed or is stuck pending. A failed gateway refund is retried into the customer's wallet; an already-settled refund is rejected.
+   */
+  async retryRefund(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<models.RefundResponse> {
+    return unwrapAsync(refundsRetryRefund(
+      this,
+      id,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -26,6 +26,7 @@ import { Plans } from "./plans.js";
 import { PriceUnits } from "./price-units.js";
 import { Prices } from "./prices.js";
 import { Rbac } from "./rbac.js";
+import { Refunds } from "./refunds.js";
 import { ScheduledTasks } from "./scheduled-tasks.js";
 import { Secrets } from "./secrets.js";
 import { Subscriptions } from "./subscriptions.js";
@@ -33,6 +34,7 @@ import { Tasks } from "./tasks.js";
 import { TaxAssociations } from "./tax-associations.js";
 import { TaxRates } from "./tax-rates.js";
 import { Tenants } from "./tenants.js";
+import { UsageRecords } from "./usage-records.js";
 import { Users } from "./users.js";
 import { Wallets } from "./wallets.js";
 import { WebhookEvents } from "./webhook-events.js";
@@ -159,6 +161,11 @@ export class Flexprice extends ClientSDK {
     return (this._rbac ??= new Rbac(this._options));
   }
 
+  private _refunds?: Refunds;
+  get refunds(): Refunds {
+    return (this._refunds ??= new Refunds(this._options));
+  }
+
   private _secrets?: Secrets;
   get secrets(): Secrets {
     return (this._secrets ??= new Secrets(this._options));
@@ -194,6 +201,11 @@ export class Flexprice extends ClientSDK {
     return (this._tenants ??= new Tenants(this._options));
   }
 
+  private _usageRecords?: UsageRecords;
+  get usageRecords(): UsageRecords {
+    return (this._usageRecords ??= new UsageRecords(this._options));
+  }
+
   private _users?: Users;
   get users(): Users {
     return (this._users ??= new Users(this._options));

package/src/sdk/subscriptions.ts

@@ -146,6 +146,65 @@ export class Subscriptions extends ClientSDK {
     ));
   }
 
+  /**
+   * List all subscription schedules
+   *
+   * @remarks
+   * Use when listing or searching scheduled changes across subscriptions (e.g. admin view). Returns schedules with optional filtering.
+   */
+  async listAllSubscriptionSchedules(
+    pendingOnly?: boolean | undefined,
+    subscriptionId?: string | undefined,
+    limit?: number | undefined,
+    offset?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<models.GetPendingSchedulesResponse> {
+    return unwrapAsync(subscriptionsListAllSubscriptionSchedules(
+      this,
+      pendingOnly,
+      subscriptionId,
+      limit,
+      offset,
+      options,
+    ));
+  }
+
+  /**
+   * Get subscription schedule
+   *
+   * @remarks
+   * Use when you need to load a single scheduled change (e.g. to show when a plan change or renewal takes effect).
+   */
+  async getSubscriptionSchedule(
+    scheduleId: string,
+    options?: RequestOptions,
+  ): Promise<models.SubscriptionScheduleResponse> {
+    return unwrapAsync(subscriptionsGetSubscriptionSchedule(
+      this,
+      scheduleId,
+      options,
+    ));
+  }
+
+  /**
+   * Cancel subscription schedule
+   *
+   * @remarks
+   * Use when cancelling a scheduled change (e.g. customer changed mind). Identify by schedule ID in path or by subscription ID + schedule type in body.
+   */
+  async cancelSubscriptionSchedule(
+    scheduleId: string,
+    body?: models.CancelScheduleRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.CancelScheduleResponse> {
+    return unwrapAsync(subscriptionsCancelSubscriptionSchedule(
+      this,
+      scheduleId,
+      body,
+      options,
+    ));
+  }
+
   /**
    * Query subscriptions
    *
@@ -244,7 +303,7 @@ export class Subscriptions extends ClientSDK {
   async getSubscriptionAddonAssociations(
     id: string,
     options?: RequestOptions,
-  ): Promise<Array<models.AddonAssociationResponse>> {
+  ): Promise<models.ListAddonAssociationsResponse> {
     return unwrapAsync(subscriptionsGetSubscriptionAddonAssociations(
       this,
       id,
@@ -319,7 +378,9 @@ export class Subscriptions extends ClientSDK {
    *
    * scheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.
    *
-   * Only one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules.
+   * Only one plan change may be pending per subscription. By default (on_conflict_policies.on_pending_schedule = 'reject') a second request returns 400; cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules.
+   *
+   * Set on_conflict_policies.on_pending_schedule to 'supersede' to replace the queued change instead: the pending schedule is cancelled and this request applied in the same transaction, so both land or neither does. The cancelled schedule ids are returned in superseded_schedules, and preview reports the same list without writing.
    */
   async executeSubscriptionPlanChangeV2(
     id: string,
@@ -447,96 +508,37 @@ export class Subscriptions extends ClientSDK {
   }
 
   /**
-   * Get subscription (V2)
+   * List subscription schedules
    *
    * @remarks
-   * Use when you need a subscription with related data (line items, prices, plan). Supports expand for detailed payloads without extra round-trips.
+   * Use when listing scheduled changes for a subscription (e.g. upcoming plan change or renewal). Returns all schedules for that subscription.
    */
-  async getSubscriptionV2(
+  async listSubscriptionSchedules(
     id: string,
-    expand?: string | undefined,
-    options?: RequestOptions,
-  ): Promise<models.SubscriptionResponseV2> {
-    return unwrapAsync(subscriptionsGetSubscriptionV2(
-      this,
-      id,
-      expand,
-      options,
-    ));
-  }
-
-  /**
-   * List all subscription schedules
-   *
-   * @remarks
-   * Use when listing or searching scheduled changes across subscriptions (e.g. admin view). Returns schedules with optional filtering.
-   */
-  async listAllSubscriptionSchedules(
-    pendingOnly?: boolean | undefined,
-    subscriptionId?: string | undefined,
-    limit?: number | undefined,
-    offset?: number | undefined,
     options?: RequestOptions,
   ): Promise<models.GetPendingSchedulesResponse> {
-    return unwrapAsync(subscriptionsListAllSubscriptionSchedules(
+    return unwrapAsync(subscriptionsListSubscriptionSchedules(
       this,
-      pendingOnly,
-      subscriptionId,
-      limit,
-      offset,
+      id,
       options,
     ));
   }
 
   /**
-   * Get subscription schedule
+   * Get subscription (V2)
    *
    * @remarks
-   * Use when you need to load a single scheduled change (e.g. to show when a plan change or renewal takes effect).
+   * Use when you need a subscription with related data (line items, prices, plan). Supports expand for detailed payloads without extra round-trips.
    */
-  async getSubscriptionSchedule(
+  async getSubscriptionV2(
     id: string,
+    expand?: string | undefined,
     options?: RequestOptions,
-  ): Promise<models.SubscriptionScheduleResponse> {
-    return unwrapAsync(subscriptionsGetSubscriptionSchedule(
+  ): Promise<models.SubscriptionResponseV2> {
+    return unwrapAsync(subscriptionsGetSubscriptionV2(
       this,
       id,
-      options,
-    ));
-  }
-
-  /**
-   * Cancel subscription schedule
-   *
-   * @remarks
-   * Use when cancelling a scheduled change (e.g. customer changed mind). Identify by schedule ID in path or by subscription ID + schedule type in body.
-   */
-  async cancelSubscriptionSchedule(
-    scheduleId: string,
-    body?: models.CancelScheduleRequest | undefined,
-    options?: RequestOptions,
-  ): Promise<models.CancelScheduleResponse> {
-    return unwrapAsync(subscriptionsCancelSubscriptionSchedule(
-      this,
-      scheduleId,
-      body,
-      options,
-    ));
-  }
-
-  /**
-   * List subscription schedules
-   *
-   * @remarks
-   * Use when listing scheduled changes for a subscription (e.g. upcoming plan change or renewal). Returns all schedules for that subscription.
-   */
-  async listSubscriptionSchedules(
-    subscriptionId: string,
-    options?: RequestOptions,
-  ): Promise<models.GetPendingSchedulesResponse> {
-    return unwrapAsync(subscriptionsListSubscriptionSchedules(
-      this,
-      subscriptionId,
+      expand,
       options,
     ));
   }