@augustusbank/typescript-sdk 0.20.0 → 0.22.0

package/src/resources/webhooks.ts

@@ -55,30 +55,35 @@ export namespace PayoutCreatedWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination: Payload.UnionMember0 | Payload.UnionMember1 | Payload.UnionMember2 | Payload.UnionMember3;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -86,19 +91,47 @@ export namespace PayoutCreatedWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Identifier used to track the payout through the payment network where supported.
+     */
+    tracking_id: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -106,103 +139,13 @@ export namespace PayoutCreatedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface UnionMember0 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface UnionMember1 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface UnionMember2 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface UnionMember3 {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -215,6 +158,7 @@ export namespace PayoutCreatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -276,30 +220,35 @@ export namespace PayoutInitiatedWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination: Payload.UnionMember0 | Payload.UnionMember1 | Payload.UnionMember2 | Payload.UnionMember3;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -307,19 +256,47 @@ export namespace PayoutInitiatedWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Identifier used to track the payout through the payment network where supported.
+     */
+    tracking_id: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -327,103 +304,13 @@ export namespace PayoutInitiatedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface UnionMember0 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface UnionMember1 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface UnionMember2 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface UnionMember3 {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -436,6 +323,7 @@ export namespace PayoutInitiatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -497,30 +385,35 @@ export namespace PayoutPaidWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination: Payload.UnionMember0 | Payload.UnionMember1 | Payload.UnionMember2 | Payload.UnionMember3;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -528,19 +421,47 @@ export namespace PayoutPaidWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Identifier used to track the payout through the payment network where supported.
+     */
+    tracking_id: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -548,103 +469,13 @@ export namespace PayoutPaidWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface UnionMember0 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface UnionMember1 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface UnionMember2 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface UnionMember3 {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -657,6 +488,7 @@ export namespace PayoutPaidWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -718,30 +550,35 @@ export namespace PayoutFailedWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination: Payload.UnionMember0 | Payload.UnionMember1 | Payload.UnionMember2 | Payload.UnionMember3;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -749,19 +586,47 @@ export namespace PayoutFailedWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Identifier used to track the payout through the payment network where supported.
+     */
+    tracking_id: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -769,103 +634,13 @@ export namespace PayoutFailedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface UnionMember0 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface UnionMember1 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface UnionMember2 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface UnionMember3 {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -878,6 +653,7 @@ export namespace PayoutFailedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -945,12 +721,7 @@ export namespace ReturnInitiatedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -960,24 +731,57 @@ export namespace ReturnInitiatedWebhookEvent {
     deposit_id: string;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * Failure details when status is failed, otherwise null.
+     */
+    failure: Payload.Failure | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
      */
-    failure: Payload.Failure | null;
+    sent_at: string | null;
 
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -993,6 +797,7 @@ export namespace ReturnInitiatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1060,12 +865,7 @@ export namespace ReturnPaidWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1079,20 +879,53 @@ export namespace ReturnPaidWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1108,6 +941,7 @@ export namespace ReturnPaidWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1175,12 +1009,7 @@ export namespace ReturnFailedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1194,20 +1023,53 @@ export namespace ReturnFailedWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1223,6 +1085,7 @@ export namespace ReturnFailedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1290,12 +1153,7 @@ export namespace ReturnReturnedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1309,20 +1167,53 @@ export namespace ReturnReturnedWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1338,6 +1229,7 @@ export namespace ReturnReturnedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1400,55 +1292,45 @@ export namespace DepositReceivedWebhookEvent {
     id: string;
 
     /**
-     * Amount as a string decimal (e.g. "100.50").
+     * ID of the account that was credited with the deposit.
      */
-    amount: string;
+    account_id: string;
 
     /**
-     * Reference visible on the bank statement, or null when not applicable.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    bank_statement_reference: string | null;
+    amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the deposit was created.
+     * ID of the counterparty that sent the money, or null when not known.
      */
-    created_at: string;
+    counterparty_id: string | null;
 
     /**
-     * Supported fiat or crypto currency code for the deposit amount.
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * ID of the merchant account that received the deposit.
-     */
-    destination_account_id: string;
-
-    /**
-     * Payment rail or blockchain used for the deposit.
+     * Payment scheme or blockchain used for the deposit, or null when unknown.
      */
     rail:
+      | 'sepa'
       | 'sepa_instant'
       | 'faster_payments'
-      | 'sepa'
-      | 'elixir'
-      | 'express_elixir'
-      | 'sek_account_to_account'
-      | 'sumclearing'
-      | 'straksclearing'
       | 'swift'
       | 'internal'
       | 'target'
       | 'ach'
       | 'fedwire'
-      | 'btc'
-      | 'btc_testnet4'
-      | 'eth'
-      | 'eth_sepolia'
-      | 'sol'
-      | 'sol_devnet'
-      | 'matic'
-      | 'matic_amoy'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
       | null;
 
     /**
@@ -1457,17 +1339,18 @@ export namespace DepositReceivedWebhookEvent {
     returns: Array<string>;
 
     /**
-     * Counterparty bank account or crypto wallet that sent the funds.
+     * ISO 8601 UTC timestamp when the deposit was settled.
      */
-    source: Payload.UnionMember0 | Payload.UnionMember1 | Payload.UnionMember2 | Payload.UnionMember3;
+    settled_at: string;
 
     /**
      * Current status of the deposit.
      */
-    status: 'received' | 'in_return' | 'returned' | 'return_failed' | 'return_returned';
+    status: 'settled';
 
     /**
-     * Transaction hash for crypto deposits, or null when not known.
+     * Transaction hash for crypto deposits, or null when not known. Only blockchain
+     * rails support this field.
      */
     tx_hash: string | null;
 
@@ -1477,102 +1360,10 @@ export namespace DepositReceivedWebhookEvent {
     type: 'deposit';
 
     /**
-     * ISO 8601 UTC timestamp when the deposit was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
-  }
-
-  export namespace Payload {
-    export interface UnionMember0 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN source.
-       */
-      type: 'iban';
-    }
-
-    export interface UnionMember1 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code source.
-       */
-      type: 'sort_code';
-    }
-
-    export interface UnionMember2 {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire source.
-       */
-      type: 'aba';
-    }
-
-    export interface UnionMember3 {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet source.
-       */
-      type: 'crypto_wallet';
-    }
+    unstructured_remittance_information: string | null;
   }
 }
 
@@ -1623,36 +1414,21 @@ export namespace ConversionCreatedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1664,9 +1440,9 @@ export namespace ConversionCreatedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1678,18 +1454,6 @@ export namespace ConversionCreatedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface ConversionCompletedWebhookEvent {
@@ -1739,36 +1503,21 @@ export namespace ConversionCompletedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1780,9 +1529,9 @@ export namespace ConversionCompletedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1794,18 +1543,6 @@ export namespace ConversionCompletedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface ConversionFailedWebhookEvent {
@@ -1855,36 +1592,21 @@ export namespace ConversionFailedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1896,9 +1618,9 @@ export namespace ConversionFailedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1910,18 +1632,6 @@ export namespace ConversionFailedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface AccountHolderActiveWebhookEvent {
@@ -1962,12 +1672,15 @@ export namespace AccountHolderActiveWebhookEvent {
     id: string;
 
     /**
-     * Beneficiary details used to create this account holder.
+     * Beneficiary details used to create this account holder. Which shape is returned
+     * follows `country_of_citizenship`: **US individual** when it is `US`, **Non-US
+     * individual** for any other country, **Business** when `holder_type` is
+     * `business`.
      */
     beneficiary_data:
-      | Payload.UsBeneficiaryDataResponse
-      | Payload.NonUsBeneficiaryDataResponse
-      | Payload.BusinessBeneficiaryDataResponse;
+      | Payload.V1UsBeneficiaryDataResponse
+      | Payload.V1NonUsBeneficiaryDataResponse
+      | Payload.V1BusinessBeneficiaryDataResponse;
 
     /**
      * ISO 8601 UTC timestamp when the account holder was created.
@@ -1991,7 +1704,7 @@ export namespace AccountHolderActiveWebhookEvent {
   }
 
   export namespace Payload {
-    export interface UsBeneficiaryDataResponse {
+    export interface V1UsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -2007,8 +1720,8 @@ export namespace AccountHolderActiveWebhookEvent {
        * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
        */
       identification:
-        | UsBeneficiaryDataResponse.SsnIdentification
-        | UsBeneficiaryDataResponse.ItinIdentification;
+        | V1UsBeneficiaryDataResponse.V1SsnIdentification
+        | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
       /**
        * Full legal name of the account holder.
@@ -2016,68 +1729,70 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace UsBeneficiaryDataResponse {
-      export interface SsnIdentification {
+    export namespace V1UsBeneficiaryDataResponse {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
       }
 
-      export interface ItinIdentification {
+      export interface V1ItinIdentification {
         type: 'itin';
 
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -2329,23 +2044,28 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
          */
-        street_line_1: string;
+        line_2: string | null;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * Postal or ZIP code.
+         */
+        postal_code: string;
+
+        /**
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface NonUsBeneficiaryDataResponse {
+    export interface V1NonUsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -2608,7 +2328,7 @@ export namespace AccountHolderActiveWebhookEvent {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
-      identification: NonUsBeneficiaryDataResponse.Identification;
+      identification: V1NonUsBeneficiaryDataResponse.Identification;
 
       /**
        * Full legal name of the account holder.
@@ -2616,14 +2336,16 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace NonUsBeneficiaryDataResponse {
+    export namespace V1NonUsBeneficiaryDataResponse {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
@@ -2633,48 +2355,48 @@ export namespace AccountHolderActiveWebhookEvent {
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -2926,38 +2648,44 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface BusinessBeneficiaryDataResponse {
+    export interface V1BusinessBeneficiaryDataResponse {
       /**
        * Beneficial owners of the business. At least one required.
        */
       beneficial_owners: Array<
-        | BusinessBeneficiaryDataResponse.UsBeneficiaryDataResponse
-        | BusinessBeneficiaryDataResponse.NonUsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1UsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1NonUsBeneficiaryDataResponse
       >;
 
       /**
        * Individual with primary responsibility for controlling, managing, or directing
-       * the business.
+       * the business. Follows the same US / non-US split as `beneficiary_data`, based on
+       * the control person's own `country_of_citizenship`.
        */
       control_person:
-        | BusinessBeneficiaryDataResponse.UnionMember0
-        | BusinessBeneficiaryDataResponse.UnionMember1;
+        | V1BusinessBeneficiaryDataResponse.UnionMember0
+        | V1BusinessBeneficiaryDataResponse.UnionMember1;
 
       /**
        * ISO 3166-1 alpha-2 country code where the business is incorporated.
@@ -3225,26 +2953,30 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_business_name: string;
 
       /**
-       * Physical operating address of the business.
+       * Physical operating address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       physical_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
-       * Registered legal address of the business.
+       * Registered legal address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       registered_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
        * Business registration number: type "ein" (Employer Identification Number, format
        * ##-#######) or "ssn" (Social Security Number, format ###-##-####).
        */
       registration_number:
-        | BusinessBeneficiaryDataResponse.EinIdentification
-        | BusinessBeneficiaryDataResponse.SsnIdentification;
+        | V1BusinessBeneficiaryDataResponse.V1EinIdentification
+        | V1BusinessBeneficiaryDataResponse.V1SsnIdentification;
 
       /**
        * State or subdivision where the business is incorporated.
@@ -3257,8 +2989,8 @@ export namespace AccountHolderActiveWebhookEvent {
       year_of_incorporation: number;
     }
 
-    export namespace BusinessBeneficiaryDataResponse {
-      export interface UsBeneficiaryDataResponse {
+    export namespace V1BusinessBeneficiaryDataResponse {
+      export interface V1UsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -3274,8 +3006,8 @@ export namespace AccountHolderActiveWebhookEvent {
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
         identification:
-          | UsBeneficiaryDataResponse.SsnIdentification
-          | UsBeneficiaryDataResponse.ItinIdentification;
+          | V1UsBeneficiaryDataResponse.V1SsnIdentification
+          | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -3283,68 +3015,70 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace UsBeneficiaryDataResponse {
-        export interface SsnIdentification {
+      export namespace V1UsBeneficiaryDataResponse {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -3596,23 +3330,28 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface NonUsBeneficiaryDataResponse {
+      export interface V1NonUsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -3875,7 +3614,7 @@ export namespace AccountHolderActiveWebhookEvent {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
-        identification: NonUsBeneficiaryDataResponse.Identification;
+        identification: V1NonUsBeneficiaryDataResponse.Identification;
 
         /**
          * Full legal name of the account holder.
@@ -3883,14 +3622,16 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace NonUsBeneficiaryDataResponse {
+      export namespace V1NonUsBeneficiaryDataResponse {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
@@ -3900,48 +3641,48 @@ export namespace AccountHolderActiveWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -4193,19 +3934,24 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -4224,7 +3970,7 @@ export namespace AccountHolderActiveWebhookEvent {
          * Government-issued identification with type: "ssn" (Social Security Number,
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
-        identification: UnionMember0.SsnIdentification | UnionMember0.ItinIdentification;
+        identification: UnionMember0.V1SsnIdentification | UnionMember0.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -4232,11 +3978,11 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember0.UsResidentialAddressResponse
-          | UnionMember0.NonUsResidentialAddressResponse;
+        residential_address: UnionMember0.V1UsResidentialAddress | UnionMember0.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -4246,60 +3992,60 @@ export namespace AccountHolderActiveWebhookEvent {
       }
 
       export namespace UnionMember0 {
-        export interface SsnIdentification {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -4551,19 +4297,24 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -4838,11 +4589,11 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember1.UsResidentialAddressResponse
-          | UnionMember1.NonUsResidentialAddressResponse;
+        residential_address: UnionMember1.V1UsResidentialAddress | UnionMember1.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -4861,48 +4612,48 @@ export namespace AccountHolderActiveWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -5154,64 +4905,69 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -5463,63 +5219,68 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
          */
-        street_line_1: string;
+        line_2: string | null;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * Postal or ZIP code.
+         */
+        postal_code: string;
+
+        /**
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -5771,28 +5532,33 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface EinIdentification {
+      export interface V1EinIdentification {
         type: 'ein';
 
         value: string;
       }
 
-      export interface SsnIdentification {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
@@ -5839,12 +5605,15 @@ export namespace AccountHolderClosedWebhookEvent {
     id: string;
 
     /**
-     * Beneficiary details used to create this account holder.
+     * Beneficiary details used to create this account holder. Which shape is returned
+     * follows `country_of_citizenship`: **US individual** when it is `US`, **Non-US
+     * individual** for any other country, **Business** when `holder_type` is
+     * `business`.
      */
     beneficiary_data:
-      | Payload.UsBeneficiaryDataResponse
-      | Payload.NonUsBeneficiaryDataResponse
-      | Payload.BusinessBeneficiaryDataResponse;
+      | Payload.V1UsBeneficiaryDataResponse
+      | Payload.V1NonUsBeneficiaryDataResponse
+      | Payload.V1BusinessBeneficiaryDataResponse;
 
     /**
      * ISO 8601 UTC timestamp when the account holder was created.
@@ -5868,7 +5637,7 @@ export namespace AccountHolderClosedWebhookEvent {
   }
 
   export namespace Payload {
-    export interface UsBeneficiaryDataResponse {
+    export interface V1UsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -5884,8 +5653,8 @@ export namespace AccountHolderClosedWebhookEvent {
        * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
        */
       identification:
-        | UsBeneficiaryDataResponse.SsnIdentification
-        | UsBeneficiaryDataResponse.ItinIdentification;
+        | V1UsBeneficiaryDataResponse.V1SsnIdentification
+        | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
       /**
        * Full legal name of the account holder.
@@ -5893,68 +5662,70 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace UsBeneficiaryDataResponse {
-      export interface SsnIdentification {
+    export namespace V1UsBeneficiaryDataResponse {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
       }
 
-      export interface ItinIdentification {
+      export interface V1ItinIdentification {
         type: 'itin';
 
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -6206,23 +5977,28 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface NonUsBeneficiaryDataResponse {
+    export interface V1NonUsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -6485,7 +6261,7 @@ export namespace AccountHolderClosedWebhookEvent {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
-      identification: NonUsBeneficiaryDataResponse.Identification;
+      identification: V1NonUsBeneficiaryDataResponse.Identification;
 
       /**
        * Full legal name of the account holder.
@@ -6493,14 +6269,16 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace NonUsBeneficiaryDataResponse {
+    export namespace V1NonUsBeneficiaryDataResponse {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
@@ -6510,48 +6288,48 @@ export namespace AccountHolderClosedWebhookEvent {
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -6803,38 +6581,44 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface BusinessBeneficiaryDataResponse {
+    export interface V1BusinessBeneficiaryDataResponse {
       /**
        * Beneficial owners of the business. At least one required.
        */
       beneficial_owners: Array<
-        | BusinessBeneficiaryDataResponse.UsBeneficiaryDataResponse
-        | BusinessBeneficiaryDataResponse.NonUsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1UsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1NonUsBeneficiaryDataResponse
       >;
 
       /**
        * Individual with primary responsibility for controlling, managing, or directing
-       * the business.
+       * the business. Follows the same US / non-US split as `beneficiary_data`, based on
+       * the control person's own `country_of_citizenship`.
        */
       control_person:
-        | BusinessBeneficiaryDataResponse.UnionMember0
-        | BusinessBeneficiaryDataResponse.UnionMember1;
+        | V1BusinessBeneficiaryDataResponse.UnionMember0
+        | V1BusinessBeneficiaryDataResponse.UnionMember1;
 
       /**
        * ISO 3166-1 alpha-2 country code where the business is incorporated.
@@ -7102,26 +6886,30 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_business_name: string;
 
       /**
-       * Physical operating address of the business.
+       * Physical operating address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       physical_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
-       * Registered legal address of the business.
+       * Registered legal address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       registered_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
        * Business registration number: type "ein" (Employer Identification Number, format
        * ##-#######) or "ssn" (Social Security Number, format ###-##-####).
        */
       registration_number:
-        | BusinessBeneficiaryDataResponse.EinIdentification
-        | BusinessBeneficiaryDataResponse.SsnIdentification;
+        | V1BusinessBeneficiaryDataResponse.V1EinIdentification
+        | V1BusinessBeneficiaryDataResponse.V1SsnIdentification;
 
       /**
        * State or subdivision where the business is incorporated.
@@ -7134,8 +6922,8 @@ export namespace AccountHolderClosedWebhookEvent {
       year_of_incorporation: number;
     }
 
-    export namespace BusinessBeneficiaryDataResponse {
-      export interface UsBeneficiaryDataResponse {
+    export namespace V1BusinessBeneficiaryDataResponse {
+      export interface V1UsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -7151,8 +6939,8 @@ export namespace AccountHolderClosedWebhookEvent {
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
         identification:
-          | UsBeneficiaryDataResponse.SsnIdentification
-          | UsBeneficiaryDataResponse.ItinIdentification;
+          | V1UsBeneficiaryDataResponse.V1SsnIdentification
+          | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -7160,68 +6948,70 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace UsBeneficiaryDataResponse {
-        export interface SsnIdentification {
+      export namespace V1UsBeneficiaryDataResponse {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -7473,23 +7263,28 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface NonUsBeneficiaryDataResponse {
+      export interface V1NonUsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -7752,7 +7547,7 @@ export namespace AccountHolderClosedWebhookEvent {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
-        identification: NonUsBeneficiaryDataResponse.Identification;
+        identification: V1NonUsBeneficiaryDataResponse.Identification;
 
         /**
          * Full legal name of the account holder.
@@ -7760,14 +7555,16 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace NonUsBeneficiaryDataResponse {
+      export namespace V1NonUsBeneficiaryDataResponse {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
@@ -7777,48 +7574,48 @@ export namespace AccountHolderClosedWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -8070,19 +7867,24 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -8101,7 +7903,7 @@ export namespace AccountHolderClosedWebhookEvent {
          * Government-issued identification with type: "ssn" (Social Security Number,
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
-        identification: UnionMember0.SsnIdentification | UnionMember0.ItinIdentification;
+        identification: UnionMember0.V1SsnIdentification | UnionMember0.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -8109,11 +7911,11 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember0.UsResidentialAddressResponse
-          | UnionMember0.NonUsResidentialAddressResponse;
+        residential_address: UnionMember0.V1UsResidentialAddress | UnionMember0.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -8123,60 +7925,60 @@ export namespace AccountHolderClosedWebhookEvent {
       }
 
       export namespace UnionMember0 {
-        export interface SsnIdentification {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -8428,19 +8230,24 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -8715,11 +8522,11 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember1.UsResidentialAddressResponse
-          | UnionMember1.NonUsResidentialAddressResponse;
+        residential_address: UnionMember1.V1UsResidentialAddress | UnionMember1.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -8738,48 +8545,48 @@ export namespace AccountHolderClosedWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -9031,64 +8838,69 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -9340,63 +9152,68 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -9648,28 +9465,33 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface EinIdentification {
+      export interface V1EinIdentification {
         type: 'ein';
 
         value: string;
       }
 
-      export interface SsnIdentification {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;