@paygentic/sdk 0.8.7 → 0.9.0

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.8.7",
+  sdkVersion: "0.9.0",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.8.7 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.9.0 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/costusageresponse.ts

@@ -46,6 +46,10 @@ export type CostUsageResponse = {
    * CloudEvents type for metered costs.
    */
   eventType?: string | undefined;
+  /**
+   * Unit label for metered costs (e.g. 'token', 'request'). Absent when the cost defines no unit.
+   */
+  unit?: string | undefined;
   /**
    * Total cost for the query window. Null if usage data could not be computed.
    */
@@ -128,6 +132,7 @@ export const CostUsageResponse$inboundSchema: z.ZodType<
   type: CostUsageResponseType$inboundSchema,
   currency: z.string(),
   eventType: z.string().optional(),
+  unit: z.string().optional(),
   totalCost: z.nullable(z.number()),
   totalQuantity: z.nullable(z.number()).optional(),
   groups: z.array(z.lazy(() => Group$inboundSchema)).optional(),

package/src/models/createbillingschedulerequest.ts

@@ -36,6 +36,9 @@ export type CreateBillingScheduleRequestPeriodPreset = ClosedEnum<
 
 export type CreateBillingScheduleRequest = {
   orderId?: string | undefined;
+  /**
+   * Not supported for creating a billing schedule. Use orderId — every billing schedule belongs to an order.
+   */
   subscriptionId?: string | undefined;
   startDate: Date;
   endDate: Date;

package/src/models/errors/deleteprice.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as operations from "../operations/index.js";
+import { PaygenticError } from "./paygenticerror.js";
+
+/**
+ * Price cannot be deleted because a live plan still references it
+ */
+export type DeletePriceConflictErrorData = {
+  error?: string | undefined;
+  message?: string | undefined;
+  details?: operations.DeletePriceDetails | undefined;
+};
+
+/**
+ * Price cannot be deleted because a live plan still references it
+ */
+export class DeletePriceConflictError extends PaygenticError {
+  error?: string | undefined;
+  details?: operations.DeletePriceDetails | undefined;
+
+  /** The original data that was passed to this error instance. */
+  data$: DeletePriceConflictErrorData;
+
+  constructor(
+    err: DeletePriceConflictErrorData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = err.message || `API error occurred: ${JSON.stringify(err)}`;
+    super(message, httpMeta);
+    this.data$ = err;
+    if (err.error != null) this.error = err.error;
+    if (err.details != null) this.details = err.details;
+
+    this.name = "DeletePriceConflictError";
+  }
+}
+
+/** @internal */
+export const DeletePriceConflictError$inboundSchema: z.ZodType<
+  DeletePriceConflictError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.string().optional(),
+  message: z.string().optional(),
+  details: z.lazy(() => operations.DeletePriceDetails$inboundSchema).optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
+})
+  .transform((v) => {
+    return new DeletePriceConflictError(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
+  });

package/src/models/errors/index.ts

@@ -5,6 +5,7 @@
 export * from "./badrequest.js";
 export * from "./deletecustomer.js";
 export * from "./deletefee.js";
+export * from "./deleteprice.js";
 export * from "./error.js";
 export * from "./httpclienterrors.js";
 export * from "./paygenticdefaulterror.js";

package/src/models/index.ts

@@ -48,6 +48,7 @@ export * from "./item.js";
 export * from "./lineitem.js";
 export * from "./lineitemsresponse.js";
 export * from "./lineitemssummary.js";
+export * from "./mappingcapabilities.js";
 export * from "./merchantintegration.js";
 export * from "./merchantintegrationprovider.js";
 export * from "./merchantintegrationstatus.js";

package/src/models/invoice.ts

@@ -50,6 +50,18 @@ export type InvoiceLineItems = {
   totalCount: number;
 };
 
+/**
+ * Who produced the document at pdfUrl, or null when there is none. `paygentic` means pdfUrl is this API's download endpoint and the request must carry your API key; `tax_provider` means it is the provider's own link, which opens directly in a browser.
+ */
+export const PdfSource = {
+  Paygentic: "paygentic",
+  TaxProvider: "tax_provider",
+} as const;
+/**
+ * Who produced the document at pdfUrl, or null when there is none. `paygentic` means pdfUrl is this API's download endpoint and the request must carry your API key; `tax_provider` means it is the provider's own link, which opens directly in a browser.
+ */
+export type PdfSource = ClosedEnum<typeof PdfSource>;
+
 /**
  * The current status of the invoice
  */
@@ -191,9 +203,13 @@ export type Invoice = {
    */
   paymentUrl?: string | null | undefined;
   /**
-   * Direct PDF download link for tax invoice
+   * Link to the invoice document, or null when there is none. For Paygentic-rendered documents this is GET /v2/invoices/{id}/pdf, which requires authentication; for documents supplied by the tax provider it is the provider's own direct link. The URL is stable and does not expire. Branch on pdfSource rather than on the shape of this URL.
    */
   pdfUrl?: string | null | undefined;
+  /**
+   * Who produced the document at pdfUrl, or null when there is none. `paygentic` means pdfUrl is this API's download endpoint and the request must carry your API key; `tax_provider` means it is the provider's own link, which opens directly in a browser.
+   */
+  pdfSource?: PdfSource | null | undefined;
   /**
    * The end of the billing period
    */
@@ -272,6 +288,10 @@ export function invoiceLineItemsFromJSON(
   );
 }
 
+/** @internal */
+export const PdfSource$inboundSchema: z.ZodNativeEnum<typeof PdfSource> = z
+  .nativeEnum(PdfSource);
+
 /** @internal */
 export const InvoiceStatus$inboundSchema: z.ZodNativeEnum<
   typeof InvoiceStatus
@@ -339,6 +359,7 @@ export const Invoice$inboundSchema: z.ZodType<Invoice, z.ZodTypeDef, unknown> =
     ).optional(),
     paymentUrl: z.nullable(z.string()).optional(),
     pdfUrl: z.nullable(z.string()).optional(),
+    pdfSource: z.nullable(PdfSource$inboundSchema).optional(),
     periodEnd: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),

package/src/models/mappingcapabilities.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+/**
+ * What this provider does with an item's external codes.
+ *
+ * @remarks
+ *
+ * Two independent capabilities, not one direction: the behaviours are not alternatives. An integration can resolve an incoming item code *and* be sent a selected one on a different path, so a single `inbound`/`outbound` value would have to misdescribe it or forbid one of its operations.
+ *
+ * A capability that is not declared is unavailable rather than inferred. Declaring one does not make a provider connectable — that still requires its credentials and connection lifecycle.
+ */
+export type MappingCapabilities = {
+  /**
+   * A code arriving from this provider must name exactly one of the merchant's items. The lookup key is the code, so several codes may point at one item while each code resolves to one — which is why a code recorded for this purpose is claimed, and a second item claiming it is a conflict.
+   */
+  resolvesItemCodes: boolean;
+  /**
+   * A consumer needs one of an item's codes to send to this provider, and takes the item's designated one (`isDefault`). Because the lookup key is the item, several items may share one code — a chart of accounts exists so that many things sold roll into one account.
+   */
+  sendsItemCodes: boolean;
+};
+
+/** @internal */
+export const MappingCapabilities$inboundSchema: z.ZodType<
+  MappingCapabilities,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  resolvesItemCodes: z.boolean(),
+  sendsItemCodes: z.boolean(),
+});
+
+export function mappingCapabilitiesFromJSON(
+  jsonString: string,
+): SafeParseResult<MappingCapabilities, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MappingCapabilities$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MappingCapabilities' from JSON`,
+  );
+}

package/src/models/merchantintegration.ts

@@ -7,6 +7,10 @@ import { safeParse } from "../lib/schemas.js";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  MappingCapabilities,
+  MappingCapabilities$inboundSchema,
+} from "./mappingcapabilities.js";
 import {
   MerchantIntegrationProvider,
   MerchantIntegrationProvider$inboundSchema,
@@ -37,9 +41,19 @@ export type MerchantIntegration = {
    */
   merchantId: string;
   /**
-   * External provider a merchant can connect at the tenant level
+   * External provider a merchant can connect at the tenant level. `netsuite` and `accountsiq` are returned on reads wherever a connection exists, but connecting them is accepted only in local and development environments; elsewhere the connect request is refused with 404.
    */
   provider: MerchantIntegrationProvider;
+  /**
+   * What this provider does with an item's external codes.
+   *
+   * @remarks
+   *
+   * Two independent capabilities, not one direction: the behaviours are not alternatives. An integration can resolve an incoming item code *and* be sent a selected one on a different path, so a single `inbound`/`outbound` value would have to misdescribe it or forbid one of its operations.
+   *
+   * A capability that is not declared is unavailable rather than inferred. Declaring one does not make a provider connectable — that still requires its credentials and connection lifecycle.
+   */
+  capabilities: MappingCapabilities;
   /**
    * Ampersand installation id.
    */
@@ -73,6 +87,7 @@ export const MerchantIntegration$inboundSchema: z.ZodType<
   ),
   merchantId: z.string(),
   provider: MerchantIntegrationProvider$inboundSchema,
+  capabilities: MappingCapabilities$inboundSchema,
   externalId: z.nullable(z.string()),
   status: MerchantIntegrationStatus$inboundSchema,
   config: z.record(z.any()),

package/src/models/merchantintegrationprovider.ts

@@ -6,13 +6,15 @@ import * as z from "zod/v3";
 import { ClosedEnum } from "../types/enums.js";
 
 /**
- * External provider a merchant can connect at the tenant level
+ * External provider a merchant can connect at the tenant level. `netsuite` and `accountsiq` are returned on reads wherever a connection exists, but connecting them is accepted only in local and development environments; elsewhere the connect request is refused with 404.
  */
 export const MerchantIntegrationProvider = {
   Salesforce: "salesforce",
+  Netsuite: "netsuite",
+  Accountsiq: "accountsiq",
 } as const;
 /**
- * External provider a merchant can connect at the tenant level
+ * External provider a merchant can connect at the tenant level. `netsuite` and `accountsiq` are returned on reads wherever a connection exists, but connecting them is accepted only in local and development environments; elsewhere the connect request is refused with 404.
  */
 export type MerchantIntegrationProvider = ClosedEnum<
   typeof MerchantIntegrationProvider

package/src/models/operations/createexternalreference.ts

@@ -32,13 +32,25 @@ export type CreateExternalReferenceRequest = {
    */
   metadata?: { [k: string]: any } | undefined;
   /**
-   * Whether this is the canonical reference for `(provider, externalId)`. The primary is unique per merchant; non-primary references are aliases.
+   * Whether this reference claims `(provider, externalId)` — the code resolves back to this one entity. Unique per merchant; unclaimed references are aliases. **Omitting it claims the code.** Send `false` for a code that is only ever sent outward, such as a ledger account several items post to — claiming that refuses the second item to use it. The default is not derived from the provider: what a code is for is a property of the operation recording it, and one provider can both resolve an arriving code and be sent a selected one. Declaring a schema default here would defeat the distinction, because a generated client materialises the default into the request body and the caller can no longer express "I did not say".
    */
   isPrimary?: boolean | undefined;
   /**
-   * Whether this is the default target for the entity + provider. At most one default per `(entityType, entityId, provider)`.
+   * Whether this is the code sent *to* the provider for this entity. At most one per `(entityType, entityId, provider)`. **Omit** to have the entity's first code for the provider designated automatically — see the note on `isPrimary` for why this carries no schema default.
    */
   isDefault?: boolean | undefined;
+  /**
+   * Take this code's claim from whichever entity currently holds it, in the same transaction.
+   *
+   * @remarks
+   *
+   * Without it, claiming a code another entity claims is a `409` identifying the holder — the right answer to an accident, and the common case. With it, the reassignment is the point.
+   *
+   * It exists because the alternative route — remove the old claim, then create the new one — leaves a window in which the code resolves to nothing. An arrival in that window is still recorded, untagged rather than rejected, so nothing is lost; but it is silent while it lasts and leaves work to repair.
+   *
+   * Deliberately opt-in, unlike moving a designation. A designation moves within one entity; a claim moves *between* entities and changes what future arrivals resolve to, which should never be a side effect of recording a code. Ignored when the write is not claiming the code.
+   */
+  moveClaim?: boolean | undefined;
 };
 
 /** @internal */
@@ -50,8 +62,9 @@ export type CreateExternalReferenceRequest$Outbound = {
   externalId: string;
   externalLabel?: string | undefined;
   metadata?: { [k: string]: any } | undefined;
-  isPrimary: boolean;
-  isDefault: boolean;
+  isPrimary?: boolean | undefined;
+  isDefault?: boolean | undefined;
+  moveClaim?: boolean | undefined;
 };
 
 /** @internal */
@@ -67,8 +80,9 @@ export const CreateExternalReferenceRequest$outboundSchema: z.ZodType<
   externalId: z.string(),
   externalLabel: z.string().optional(),
   metadata: z.record(z.any()).optional(),
-  isPrimary: z.boolean().default(true),
-  isDefault: z.boolean().default(false),
+  isPrimary: z.boolean().optional(),
+  isDefault: z.boolean().optional(),
+  moveClaim: z.boolean().optional(),
 });
 
 export function createExternalReferenceRequestToJSON(

package/src/models/operations/deletecustomer.ts

@@ -28,7 +28,7 @@ export const DeleteCustomerType = {
 } as const;
 export type DeleteCustomerType = ClosedEnum<typeof DeleteCustomerType>;
 
-export type Item = {
+export type DeleteCustomerItem = {
   id?: string | undefined;
   status?: string | undefined;
 };
@@ -36,7 +36,7 @@ export type Item = {
 export type DeleteCustomerBlocker = {
   type: DeleteCustomerType;
   count: number;
-  items: Array<Item>;
+  items: Array<DeleteCustomerItem>;
 };
 
 export type DeleteCustomerDetails = {
@@ -75,19 +75,22 @@ export const DeleteCustomerType$inboundSchema: z.ZodNativeEnum<
 > = z.nativeEnum(DeleteCustomerType);
 
 /** @internal */
-export const Item$inboundSchema: z.ZodType<Item, z.ZodTypeDef, unknown> = z
-  .object({
-    id: z.string().optional(),
-    status: z.string().optional(),
-  });
+export const DeleteCustomerItem$inboundSchema: z.ZodType<
+  DeleteCustomerItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string().optional(),
+  status: z.string().optional(),
+});
 
-export function itemFromJSON(
+export function deleteCustomerItemFromJSON(
   jsonString: string,
-): SafeParseResult<Item, SDKValidationError> {
+): SafeParseResult<DeleteCustomerItem, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => Item$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Item' from JSON`,
+    (x) => DeleteCustomerItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeleteCustomerItem' from JSON`,
   );
 }
 
@@ -99,7 +102,7 @@ export const DeleteCustomerBlocker$inboundSchema: z.ZodType<
 > = z.object({
   type: DeleteCustomerType$inboundSchema,
   count: z.number().int(),
-  items: z.array(z.lazy(() => Item$inboundSchema)),
+  items: z.array(z.lazy(() => DeleteCustomerItem$inboundSchema)),
 });
 
 export function deleteCustomerBlockerFromJSON(

package/src/models/operations/deletefee.ts

@@ -14,9 +14,15 @@ export type DeleteFeeRequest = {
   id: string;
 };
 
+export type DeleteFeeItem = {
+  id?: string | undefined;
+  invoiceDisplayName?: string | undefined;
+};
+
 export type DeleteFeeBlocker = {
   type?: string | undefined;
   count?: number | undefined;
+  items?: Array<DeleteFeeItem> | undefined;
 };
 
 export type DeleteFeeDetails = {
@@ -45,6 +51,26 @@ export function deleteFeeRequestToJSON(
   );
 }
 
+/** @internal */
+export const DeleteFeeItem$inboundSchema: z.ZodType<
+  DeleteFeeItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string().optional(),
+  invoiceDisplayName: z.string().optional(),
+});
+
+export function deleteFeeItemFromJSON(
+  jsonString: string,
+): SafeParseResult<DeleteFeeItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeleteFeeItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeleteFeeItem' from JSON`,
+  );
+}
+
 /** @internal */
 export const DeleteFeeBlocker$inboundSchema: z.ZodType<
   DeleteFeeBlocker,
@@ -53,6 +79,7 @@ export const DeleteFeeBlocker$inboundSchema: z.ZodType<
 > = z.object({
   type: z.string().optional(),
   count: z.number().int().optional(),
+  items: z.array(z.lazy(() => DeleteFeeItem$inboundSchema)).optional(),
 });
 
 export function deleteFeeBlockerFromJSON(

package/src/models/operations/deleteprice.ts

@@ -3,6 +3,9 @@
  */
 
 import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type DeletePriceRequest = {
   /**
@@ -11,6 +14,23 @@ export type DeletePriceRequest = {
   id: string;
 };
 
+export type DeletePriceItem = {
+  id?: string | undefined;
+  name?: string | undefined;
+  versionNumber?: number | undefined;
+  versionNumbers?: Array<number> | undefined;
+};
+
+export type DeletePriceBlocker = {
+  type?: string | undefined;
+  count?: number | undefined;
+  items?: Array<DeletePriceItem> | undefined;
+};
+
+export type DeletePriceDetails = {
+  blockers?: Array<DeletePriceBlocker> | undefined;
+};
+
 /** @internal */
 export type DeletePriceRequest$Outbound = {
   id: string;
@@ -32,3 +52,65 @@ export function deletePriceRequestToJSON(
     DeletePriceRequest$outboundSchema.parse(deletePriceRequest),
   );
 }
+
+/** @internal */
+export const DeletePriceItem$inboundSchema: z.ZodType<
+  DeletePriceItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string().optional(),
+  name: z.string().optional(),
+  versionNumber: z.number().int().optional(),
+  versionNumbers: z.array(z.number().int()).optional(),
+});
+
+export function deletePriceItemFromJSON(
+  jsonString: string,
+): SafeParseResult<DeletePriceItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeletePriceItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeletePriceItem' from JSON`,
+  );
+}
+
+/** @internal */
+export const DeletePriceBlocker$inboundSchema: z.ZodType<
+  DeletePriceBlocker,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: z.string().optional(),
+  count: z.number().int().optional(),
+  items: z.array(z.lazy(() => DeletePriceItem$inboundSchema)).optional(),
+});
+
+export function deletePriceBlockerFromJSON(
+  jsonString: string,
+): SafeParseResult<DeletePriceBlocker, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeletePriceBlocker$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeletePriceBlocker' from JSON`,
+  );
+}
+
+/** @internal */
+export const DeletePriceDetails$inboundSchema: z.ZodType<
+  DeletePriceDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  blockers: z.array(z.lazy(() => DeletePriceBlocker$inboundSchema)).optional(),
+});
+
+export function deletePriceDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<DeletePriceDetails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeletePriceDetails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeletePriceDetails' from JSON`,
+  );
+}

package/src/models/operations/downloadinvoicepdf.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type DownloadInvoicePdfRequest = {
+  /**
+   * The invoice ID
+   */
+  id: string;
+};
+
+/** @internal */
+export type DownloadInvoicePdfRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const DownloadInvoicePdfRequest$outboundSchema: z.ZodType<
+  DownloadInvoicePdfRequest$Outbound,
+  z.ZodTypeDef,
+  DownloadInvoicePdfRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function downloadInvoicePdfRequestToJSON(
+  downloadInvoicePdfRequest: DownloadInvoicePdfRequest,
+): string {
+  return JSON.stringify(
+    DownloadInvoicePdfRequest$outboundSchema.parse(downloadInvoicePdfRequest),
+  );
+}

package/src/models/operations/index.ts

@@ -32,13 +32,13 @@ export * from "./deletecustomer.js";
 export * from "./deleteexternalreference.js";
 export * from "./deletefeature.js";
 export * from "./deletefee.js";
-export * from "./deleteitem.js";
 export * from "./deleteorder.js";
 export * from "./deleteorderlineitem.js";
 export * from "./deleteprice.js";
 export * from "./deletesourcerule.js";
 export * from "./deletetestclock.js";
 export * from "./disconnectmerchantintegration.js";
+export * from "./downloadinvoicepdf.js";
 export * from "./generateportallink.js";
 export * from "./generatescheduleinvoices.js";
 export * from "./getapproval.js";

package/src/models/operations/listbillablemetrics.ts

@@ -22,6 +22,10 @@ export type ListBillableMetricsRequest = {
    * Number of billable metrics to skip.
    */
   offset?: number | undefined;
+  /**
+   * Filter to the charges tagged with this item. Lets a surface that needs only one item's charges read exactly those, rather than reading the whole product's and filtering — which makes its completeness a function of how large the product is.
+   */
+  itemId?: string | undefined;
   /**
    * Filter billable metrics by product ID.
    */
@@ -55,6 +59,7 @@ export type ListBillableMetricsRequest$Outbound = {
   limit: number;
   merchantId: string;
   offset: number;
+  itemId?: string | undefined;
   productId?: string | undefined;
 };
 
@@ -67,6 +72,7 @@ export const ListBillableMetricsRequest$outboundSchema: z.ZodType<
   limit: z.number().int().default(10),
   merchantId: z.string(),
   offset: z.number().int().default(0),
+  itemId: z.string().optional(),
   productId: z.string().optional(),
 });
 

package/src/models/operations/listfees.ts

@@ -22,6 +22,10 @@ export type ListFeesRequest = {
    * Number of fees to skip.
    */
   offset?: number | undefined;
+  /**
+   * Filter to the charges tagged with this item. Lets a surface that needs only one item's charges read exactly those, rather than reading the whole product's and filtering — which makes its completeness a function of how large the product is.
+   */
+  itemId?: string | undefined;
   /**
    * Filter fees by product ID.
    */
@@ -53,6 +57,7 @@ export type ListFeesRequest$Outbound = {
   limit: number;
   merchantId: string;
   offset: number;
+  itemId?: string | undefined;
   productId?: string | undefined;
 };
 
@@ -65,6 +70,7 @@ export const ListFeesRequest$outboundSchema: z.ZodType<
   limit: z.number().int().default(10),
   merchantId: z.string(),
   offset: z.number().int().default(0),
+  itemId: z.string().optional(),
   productId: z.string().optional(),
 });
 

package/src/models/operations/listprices.ts

@@ -13,6 +13,10 @@ export type ListPricesRequest = {
    * Filter prices by billable metric ID
    */
   billableMetricId?: string | undefined;
+  /**
+   * Filter prices by merchant organization ID. Matches prices reached via either a billable metric or a fee belonging to that merchant. Unlike the unfiltered listing, this includes prices whose billable metric or fee has been deleted — deleting a parent does not delete its prices, and they can still bill. Returns 404 if the merchant does not exist.
+   */
+  merchantId?: string | undefined;
   /**
    * Number of prices to return
    */
@@ -40,6 +44,7 @@ export type ListPricesResponse = {
 /** @internal */
 export type ListPricesRequest$Outbound = {
   billableMetricId?: string | undefined;
+  merchantId?: string | undefined;
   limit: number;
   offset: number;
 };
@@ -51,6 +56,7 @@ export const ListPricesRequest$outboundSchema: z.ZodType<
   ListPricesRequest
 > = z.object({
   billableMetricId: z.string().optional(),
+  merchantId: z.string().optional(),
   limit: z.number().int().default(10),
   offset: z.number().int().default(0),
 });