increase 0.210.0 → 0.212.0

package/resources/wire-transfers.js

@@ -8,12 +8,29 @@ const pagination_1 = require("../pagination.js");
 class WireTransfers extends resource_1.APIResource {
     /**
      * Create a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.create({
+     *   account_id: 'account_in71c4amph0vgo2qllky',
+     *   amount: 100,
+     *   beneficiary_name: 'Ian Crease',
+     *   message_to_recipient: 'New account transfer',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/wire_transfers', { body, ...options });
     }
     /**
      * Retrieve a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.retrieve(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     retrieve(wireTransferId, options) {
         return this._client.get(`/wire_transfers/${wireTransferId}`, options);
@@ -26,12 +43,26 @@ class WireTransfers extends resource_1.APIResource {
     }
     /**
      * Approve a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.approve(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     approve(wireTransferId, options) {
         return this._client.post(`/wire_transfers/${wireTransferId}/approve`, options);
     }
     /**
      * Cancel a pending Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.cancel(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     cancel(wireTransferId, options) {
         return this._client.post(`/wire_transfers/${wireTransferId}/cancel`, options);

package/resources/wire-transfers.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire-transfers.js","sourceRoot":"","sources":["../src/resources/wire-transfers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAA0C;AAC1C,qCAA2C;AAE3C,iDAAsD;AAEtD,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;OAEG;IACH,MAAM,CAAC,IAA8B,EAAE,OAA6B;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAUD,IAAI,CACF,QAAsD,EAAE,EACxD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,cAAsB,EAAE,OAA6B;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,UAAU,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAsB,EAAE,OAA6B;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AA9CD,sCA8CC;AAED,MAAa,iBAAkB,SAAQ,iBAAkB;CAAG;AAA5D,8CAA4D;AA8hB5D,aAAa,CAAC,iBAAiB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"wire-transfers.js","sourceRoot":"","sources":["../src/resources/wire-transfers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAA0C;AAC1C,qCAA2C;AAE3C,iDAAsD;AAEtD,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAA8B,EAAE,OAA6B;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAkBD,IAAI,CACF,QAAsD,EAAE,EACxD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAsB,EAAE,OAA6B;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,UAAU,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAsB,EAAE,OAA6B;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AArFD,sCAqFC;AAED,MAAa,iBAAkB,SAAQ,iBAAkB;CAAG;AAA5D,8CAA4D;AA8hB5D,aAAa,CAAC,iBAAiB,GAAG,iBAAiB,CAAC"}

package/resources/wire-transfers.mjs

@@ -5,12 +5,29 @@ import { Page } from "../pagination.mjs";
 export class WireTransfers extends APIResource {
     /**
      * Create a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.create({
+     *   account_id: 'account_in71c4amph0vgo2qllky',
+     *   amount: 100,
+     *   beneficiary_name: 'Ian Crease',
+     *   message_to_recipient: 'New account transfer',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/wire_transfers', { body, ...options });
     }
     /**
      * Retrieve a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.retrieve(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     retrieve(wireTransferId, options) {
         return this._client.get(`/wire_transfers/${wireTransferId}`, options);
@@ -23,12 +40,26 @@ export class WireTransfers extends APIResource {
     }
     /**
      * Approve a Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.approve(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     approve(wireTransferId, options) {
         return this._client.post(`/wire_transfers/${wireTransferId}/approve`, options);
     }
     /**
      * Cancel a pending Wire Transfer
+     *
+     * @example
+     * ```ts
+     * const wireTransfer = await client.wireTransfers.cancel(
+     *   'wire_transfer_5akynk7dqsq25qwk9q2u',
+     * );
+     * ```
      */
     cancel(wireTransferId, options) {
         return this._client.post(`/wire_transfers/${wireTransferId}/cancel`, options);

package/resources/wire-transfers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"wire-transfers.mjs","sourceRoot":"","sources":["../src/resources/wire-transfers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAEpB,EAAE,IAAI,EAAmB;AAEhC,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;OAEG;IACH,MAAM,CAAC,IAA8B,EAAE,OAA6B;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAUD,IAAI,CACF,QAAsD,EAAE,EACxD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,cAAsB,EAAE,OAA6B;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,UAAU,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAsB,EAAE,OAA6B;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,IAAkB;CAAG;AA8hB5D,aAAa,CAAC,iBAAiB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"wire-transfers.mjs","sourceRoot":"","sources":["../src/resources/wire-transfers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAEpB,EAAE,IAAI,EAAmB;AAEhC,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAA8B,EAAE,OAA6B;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAkBD,IAAI,CACF,QAAsD,EAAE,EACxD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAsB,EAAE,OAA6B;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,UAAU,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAsB,EAAE,OAA6B;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,cAAc,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,IAAkB;CAAG;AA8hB5D,aAAa,CAAC,iBAAiB,GAAG,iBAAiB,CAAC"}

package/src/resources/account-numbers.ts

@@ -8,6 +8,14 @@ import { Page, type PageParams } from '../pagination';
 export class AccountNumbers extends APIResource {
   /**
    * Create an Account Number
+   *
+   * @example
+   * ```ts
+   * const accountNumber = await client.accountNumbers.create({
+   *   account_id: 'account_in71c4amph0vgo2qllky',
+   *   name: 'Rent payments',
+   * });
+   * ```
    */
   create(body: AccountNumberCreateParams, options?: Core.RequestOptions): Core.APIPromise<AccountNumber> {
     return this._client.post('/account_numbers', { body, ...options });
@@ -15,6 +23,13 @@ export class AccountNumbers extends APIResource {
 
   /**
    * Retrieve an Account Number
+   *
+   * @example
+   * ```ts
+   * const accountNumber = await client.accountNumbers.retrieve(
+   *   'account_number_v18nkfqm6afpsrvy82b2',
+   * );
+   * ```
    */
   retrieve(accountNumberId: string, options?: Core.RequestOptions): Core.APIPromise<AccountNumber> {
     return this._client.get(`/account_numbers/${accountNumberId}`, options);
@@ -22,6 +37,13 @@ export class AccountNumbers extends APIResource {
 
   /**
    * Update an Account Number
+   *
+   * @example
+   * ```ts
+   * const accountNumber = await client.accountNumbers.update(
+   *   'account_number_v18nkfqm6afpsrvy82b2',
+   * );
+   * ```
    */
   update(
     accountNumberId: string,
@@ -33,6 +55,14 @@ export class AccountNumbers extends APIResource {
 
   /**
    * List Account Numbers
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const accountNumber of client.accountNumbers.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: AccountNumberListParams,

package/src/resources/account-statements.ts

@@ -8,6 +8,14 @@ import { Page, type PageParams } from '../pagination';
 export class AccountStatements extends APIResource {
   /**
    * Retrieve an Account Statement
+   *
+   * @example
+   * ```ts
+   * const accountStatement =
+   *   await client.accountStatements.retrieve(
+   *     'account_statement_lkc03a4skm2k7f38vj15',
+   *   );
+   * ```
    */
   retrieve(accountStatementId: string, options?: Core.RequestOptions): Core.APIPromise<AccountStatement> {
     return this._client.get(`/account_statements/${accountStatementId}`, options);
@@ -15,6 +23,14 @@ export class AccountStatements extends APIResource {
 
   /**
    * List Account Statements
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const accountStatement of client.accountStatements.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: AccountStatementListParams,

package/src/resources/account-transfers.ts

@@ -8,6 +8,17 @@ import { Page, type PageParams } from '../pagination';
 export class AccountTransfers extends APIResource {
   /**
    * Create an Account Transfer
+   *
+   * @example
+   * ```ts
+   * const accountTransfer =
+   *   await client.accountTransfers.create({
+   *     account_id: 'account_in71c4amph0vgo2qllky',
+   *     amount: 100,
+   *     description: 'Creating liquidity',
+   *     destination_account_id: 'account_uf16sut2ct5bevmq3eh',
+   *   });
+   * ```
    */
   create(body: AccountTransferCreateParams, options?: Core.RequestOptions): Core.APIPromise<AccountTransfer> {
     return this._client.post('/account_transfers', { body, ...options });
@@ -15,6 +26,14 @@ export class AccountTransfers extends APIResource {
 
   /**
    * Retrieve an Account Transfer
+   *
+   * @example
+   * ```ts
+   * const accountTransfer =
+   *   await client.accountTransfers.retrieve(
+   *     'account_transfer_7k9qe1ysdgqztnt63l7n',
+   *   );
+   * ```
    */
   retrieve(accountTransferId: string, options?: Core.RequestOptions): Core.APIPromise<AccountTransfer> {
     return this._client.get(`/account_transfers/${accountTransferId}`, options);
@@ -22,6 +41,14 @@ export class AccountTransfers extends APIResource {
 
   /**
    * List Account Transfers
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const accountTransfer of client.accountTransfers.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: AccountTransferListParams,
@@ -40,6 +67,14 @@ export class AccountTransfers extends APIResource {
 
   /**
    * Approve an Account Transfer
+   *
+   * @example
+   * ```ts
+   * const accountTransfer =
+   *   await client.accountTransfers.approve(
+   *     'account_transfer_7k9qe1ysdgqztnt63l7n',
+   *   );
+   * ```
    */
   approve(accountTransferId: string, options?: Core.RequestOptions): Core.APIPromise<AccountTransfer> {
     return this._client.post(`/account_transfers/${accountTransferId}/approve`, options);
@@ -47,6 +82,14 @@ export class AccountTransfers extends APIResource {
 
   /**
    * Cancel an Account Transfer
+   *
+   * @example
+   * ```ts
+   * const accountTransfer =
+   *   await client.accountTransfers.cancel(
+   *     'account_transfer_7k9qe1ysdgqztnt63l7n',
+   *   );
+   * ```
    */
   cancel(accountTransferId: string, options?: Core.RequestOptions): Core.APIPromise<AccountTransfer> {
     return this._client.post(`/account_transfers/${accountTransferId}/cancel`, options);

package/src/resources/accounts.ts

@@ -8,6 +8,13 @@ import { Page, type PageParams } from '../pagination';
 export class Accounts extends APIResource {
   /**
    * Create an Account
+   *
+   * @example
+   * ```ts
+   * const account = await client.accounts.create({
+   *   name: 'New Account!',
+   * });
+   * ```
    */
   create(body: AccountCreateParams, options?: Core.RequestOptions): Core.APIPromise<Account> {
     return this._client.post('/accounts', { body, ...options });
@@ -15,6 +22,13 @@ export class Accounts extends APIResource {
 
   /**
    * Retrieve an Account
+   *
+   * @example
+   * ```ts
+   * const account = await client.accounts.retrieve(
+   *   'account_in71c4amph0vgo2qllky',
+   * );
+   * ```
    */
   retrieve(accountId: string, options?: Core.RequestOptions): Core.APIPromise<Account> {
     return this._client.get(`/accounts/${accountId}`, options);
@@ -22,6 +36,13 @@ export class Accounts extends APIResource {
 
   /**
    * Update an Account
+   *
+   * @example
+   * ```ts
+   * const account = await client.accounts.update(
+   *   'account_in71c4amph0vgo2qllky',
+   * );
+   * ```
    */
   update(
     accountId: string,
@@ -33,6 +54,14 @@ export class Accounts extends APIResource {
 
   /**
    * List Accounts
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const account of client.accounts.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(query?: AccountListParams, options?: Core.RequestOptions): Core.PagePromise<AccountsPage, Account>;
   list(options?: Core.RequestOptions): Core.PagePromise<AccountsPage, Account>;
@@ -49,6 +78,13 @@ export class Accounts extends APIResource {
   /**
    * Retrieve the current and available balances for an account in minor units of the
    * account's currency. Learn more about [account balances](/documentation/balance).
+   *
+   * @example
+   * ```ts
+   * const balanceLookup = await client.accounts.balance(
+   *   'account_in71c4amph0vgo2qllky',
+   * );
+   * ```
    */
   balance(
     accountId: string,
@@ -69,6 +105,13 @@ export class Accounts extends APIResource {
 
   /**
    * Close an Account
+   *
+   * @example
+   * ```ts
+   * const account = await client.accounts.close(
+   *   'account_in71c4amph0vgo2qllky',
+   * );
+   * ```
    */
   close(accountId: string, options?: Core.RequestOptions): Core.APIPromise<Account> {
     return this._client.post(`/accounts/${accountId}/close`, options);

package/src/resources/ach-prenotifications.ts

@@ -8,6 +8,16 @@ import { Page, type PageParams } from '../pagination';
 export class ACHPrenotifications extends APIResource {
   /**
    * Create an ACH Prenotification
+   *
+   * @example
+   * ```ts
+   * const achPrenotification =
+   *   await client.achPrenotifications.create({
+   *     account_id: 'account_in71c4amph0vgo2qllky',
+   *     account_number: '987654321',
+   *     routing_number: '101050001',
+   *   });
+   * ```
    */
   create(
     body: ACHPrenotificationCreateParams,
@@ -18,6 +28,14 @@ export class ACHPrenotifications extends APIResource {
 
   /**
    * Retrieve an ACH Prenotification
+   *
+   * @example
+   * ```ts
+   * const achPrenotification =
+   *   await client.achPrenotifications.retrieve(
+   *     'ach_prenotification_ubjf9qqsxl3obbcn1u34',
+   *   );
+   * ```
    */
   retrieve(achPrenotificationId: string, options?: Core.RequestOptions): Core.APIPromise<ACHPrenotification> {
     return this._client.get(`/ach_prenotifications/${achPrenotificationId}`, options);
@@ -25,6 +43,14 @@ export class ACHPrenotifications extends APIResource {
 
   /**
    * List ACH Prenotifications
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const achPrenotification of client.achPrenotifications.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: ACHPrenotificationListParams,

package/src/resources/ach-transfers.ts

@@ -8,6 +8,15 @@ import { Page, type PageParams } from '../pagination';
 export class ACHTransfers extends APIResource {
   /**
    * Create an ACH Transfer
+   *
+   * @example
+   * ```ts
+   * const achTransfer = await client.achTransfers.create({
+   *   account_id: 'account_in71c4amph0vgo2qllky',
+   *   amount: 100,
+   *   statement_descriptor: 'New ACH transfer',
+   * });
+   * ```
    */
   create(body: ACHTransferCreateParams, options?: Core.RequestOptions): Core.APIPromise<ACHTransfer> {
     return this._client.post('/ach_transfers', { body, ...options });
@@ -15,6 +24,13 @@ export class ACHTransfers extends APIResource {
 
   /**
    * Retrieve an ACH Transfer
+   *
+   * @example
+   * ```ts
+   * const achTransfer = await client.achTransfers.retrieve(
+   *   'ach_transfer_uoxatyh3lt5evrsdvo7q',
+   * );
+   * ```
    */
   retrieve(achTransferId: string, options?: Core.RequestOptions): Core.APIPromise<ACHTransfer> {
     return this._client.get(`/ach_transfers/${achTransferId}`, options);
@@ -22,6 +38,14 @@ export class ACHTransfers extends APIResource {
 
   /**
    * List ACH Transfers
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const achTransfer of client.achTransfers.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: ACHTransferListParams,
@@ -40,6 +64,13 @@ export class ACHTransfers extends APIResource {
 
   /**
    * Approves an ACH Transfer in a pending_approval state.
+   *
+   * @example
+   * ```ts
+   * const achTransfer = await client.achTransfers.approve(
+   *   'ach_transfer_uoxatyh3lt5evrsdvo7q',
+   * );
+   * ```
    */
   approve(achTransferId: string, options?: Core.RequestOptions): Core.APIPromise<ACHTransfer> {
     return this._client.post(`/ach_transfers/${achTransferId}/approve`, options);
@@ -47,6 +78,13 @@ export class ACHTransfers extends APIResource {
 
   /**
    * Cancels an ACH Transfer in a pending_approval state.
+   *
+   * @example
+   * ```ts
+   * const achTransfer = await client.achTransfers.cancel(
+   *   'ach_transfer_uoxatyh3lt5evrsdvo7q',
+   * );
+   * ```
    */
   cancel(achTransferId: string, options?: Core.RequestOptions): Core.APIPromise<ACHTransfer> {
     return this._client.post(`/ach_transfers/${achTransferId}/cancel`, options);

package/src/resources/bookkeeping-accounts.ts

@@ -8,6 +8,14 @@ import { Page, type PageParams } from '../pagination';
 export class BookkeepingAccounts extends APIResource {
   /**
    * Create a Bookkeeping Account
+   *
+   * @example
+   * ```ts
+   * const bookkeepingAccount =
+   *   await client.bookkeepingAccounts.create({
+   *     name: 'New Account!',
+   *   });
+   * ```
    */
   create(
     body: BookkeepingAccountCreateParams,
@@ -18,6 +26,15 @@ export class BookkeepingAccounts extends APIResource {
 
   /**
    * Update a Bookkeeping Account
+   *
+   * @example
+   * ```ts
+   * const bookkeepingAccount =
+   *   await client.bookkeepingAccounts.update(
+   *     'bookkeeping_account_e37p1f1iuocw5intf35v',
+   *     { name: 'Deprecated Account' },
+   *   );
+   * ```
    */
   update(
     bookkeepingAccountId: string,
@@ -29,6 +46,14 @@ export class BookkeepingAccounts extends APIResource {
 
   /**
    * List Bookkeeping Accounts
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const bookkeepingAccount of client.bookkeepingAccounts.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: BookkeepingAccountListParams,
@@ -47,6 +72,14 @@ export class BookkeepingAccounts extends APIResource {
 
   /**
    * Retrieve a Bookkeeping Account Balance
+   *
+   * @example
+   * ```ts
+   * const bookkeepingBalanceLookup =
+   *   await client.bookkeepingAccounts.balance(
+   *     'bookkeeping_account_e37p1f1iuocw5intf35v',
+   *   );
+   * ```
    */
   balance(
     bookkeepingAccountId: string,

package/src/resources/bookkeeping-entries.ts

@@ -8,6 +8,14 @@ import { Page, type PageParams } from '../pagination';
 export class BookkeepingEntries extends APIResource {
   /**
    * Retrieve a Bookkeeping Entry
+   *
+   * @example
+   * ```ts
+   * const bookkeepingEntry =
+   *   await client.bookkeepingEntries.retrieve(
+   *     'bookkeeping_entry_ctjpajsj3ks2blx10375',
+   *   );
+   * ```
    */
   retrieve(bookkeepingEntryId: string, options?: Core.RequestOptions): Core.APIPromise<BookkeepingEntry> {
     return this._client.get(`/bookkeeping_entries/${bookkeepingEntryId}`, options);
@@ -15,6 +23,14 @@ export class BookkeepingEntries extends APIResource {
 
   /**
    * List Bookkeeping Entries
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const bookkeepingEntry of client.bookkeepingEntries.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: BookkeepingEntryListParams,

package/src/resources/bookkeeping-entry-sets.ts

@@ -8,6 +8,25 @@ import { Page, type PageParams } from '../pagination';
 export class BookkeepingEntrySets extends APIResource {
   /**
    * Create a Bookkeeping Entry Set
+   *
+   * @example
+   * ```ts
+   * const bookkeepingEntrySet =
+   *   await client.bookkeepingEntrySets.create({
+   *     entries: [
+   *       {
+   *         account_id:
+   *           'bookkeeping_account_9husfpw68pzmve9dvvc7',
+   *         amount: 100,
+   *       },
+   *       {
+   *         account_id:
+   *           'bookkeeping_account_t2obldz1rcu15zr54umg',
+   *         amount: -100,
+   *       },
+   *     ],
+   *   });
+   * ```
    */
   create(
     body: BookkeepingEntrySetCreateParams,
@@ -18,6 +37,14 @@ export class BookkeepingEntrySets extends APIResource {
 
   /**
    * Retrieve a Bookkeeping Entry Set
+   *
+   * @example
+   * ```ts
+   * const bookkeepingEntrySet =
+   *   await client.bookkeepingEntrySets.retrieve(
+   *     'bookkeeping_entry_set_n80c6wr2p8gtc6p4ingf',
+   *   );
+   * ```
    */
   retrieve(
     bookkeepingEntrySetId: string,
@@ -28,6 +55,14 @@ export class BookkeepingEntrySets extends APIResource {
 
   /**
    * List Bookkeeping Entry Sets
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const bookkeepingEntrySet of client.bookkeepingEntrySets.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: BookkeepingEntrySetListParams,

package/src/resources/card-disputes.ts

@@ -8,6 +8,15 @@ import { Page, type PageParams } from '../pagination';
 export class CardDisputes extends APIResource {
   /**
    * Create a Card Dispute
+   *
+   * @example
+   * ```ts
+   * const cardDispute = await client.cardDisputes.create({
+   *   disputed_transaction_id:
+   *     'transaction_uyrp7fld2ium70oa7oi',
+   *   explanation: 'Unauthorized recurring transaction.',
+   * });
+   * ```
    */
   create(body: CardDisputeCreateParams, options?: Core.RequestOptions): Core.APIPromise<CardDispute> {
     return this._client.post('/card_disputes', { body, ...options });
@@ -15,6 +24,13 @@ export class CardDisputes extends APIResource {
 
   /**
    * Retrieve a Card Dispute
+   *
+   * @example
+   * ```ts
+   * const cardDispute = await client.cardDisputes.retrieve(
+   *   'card_dispute_h9sc95nbl1cgltpp7men',
+   * );
+   * ```
    */
   retrieve(cardDisputeId: string, options?: Core.RequestOptions): Core.APIPromise<CardDispute> {
     return this._client.get(`/card_disputes/${cardDisputeId}`, options);
@@ -22,6 +38,14 @@ export class CardDisputes extends APIResource {
 
   /**
    * List Card Disputes
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const cardDispute of client.cardDisputes.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: CardDisputeListParams,