modern-treasury 3.3.0 → 4.4.2

package/src/internal/parse.ts

@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: ModernTreasury, props: API
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

package/src/resources/account-details.ts

@@ -78,6 +78,7 @@ export interface AccountDetail {
   account_number_type:
     | 'au_number'
     | 'base_address'
+    | 'card_token'
     | 'clabe'
     | 'ethereum_address'
     | 'hk_number'
@@ -113,7 +114,7 @@ export interface AccountDetail {
 
 export interface AccountDetailCreateParams {
   /**
-   * Path param:
+   * Path param
    */
   accounts_type: 'external_accounts';
 
@@ -129,6 +130,7 @@ export interface AccountDetailCreateParams {
   account_number_type?:
     | 'au_number'
     | 'base_address'
+    | 'card_token'
     | 'clabe'
     | 'ethereum_address'
     | 'hk_number'
@@ -154,7 +156,7 @@ export interface AccountDetailRetrieveParams {
 
 export interface AccountDetailListParams extends PageParams {
   /**
-   * Path param:
+   * Path param
    */
   accounts_type: Shared.AccountsType;
 }

package/src/resources/bulk-requests.ts

@@ -247,6 +247,11 @@ export namespace BulkRequestCreateParams {
      */
     expires_at?: string | null;
 
+    /**
+     * An optional user-defined 180 character unique identifier.
+     */
+    external_id?: string | null;
+
     /**
      * A payment type to fallback to if the original type is not valid for the
      * receiving account. Currently, this only supports falling back from RTP to ACH
@@ -382,8 +387,8 @@ export namespace BulkRequestCreateParams {
     subtype?: PaymentOrdersAPI.PaymentOrderSubtype | null;
 
     /**
-     * A flag that determines whether a payment order should go through transaction
-     * monitoring.
+     * @deprecated A flag that determines whether a payment order should go through
+     * transaction monitoring.
      */
     transaction_monitoring_enabled?: boolean;
 
@@ -526,6 +531,7 @@ export namespace BulkRequestCreateParams {
         account_number_type?:
           | 'au_number'
           | 'base_address'
+          | 'card_token'
           | 'clabe'
           | 'ethereum_address'
           | 'hk_number'
@@ -614,6 +620,30 @@ export namespace BulkRequestCreateParams {
      */
     amount_lower_bound?: number | null;
 
+    /**
+     * The amount reconciled for this expected payment. Value in specified currency's
+     * smallest unit. e.g. $10 would be represented as 1000.
+     */
+    amount_reconciled?: number | null;
+
+    /**
+     * One of credit or debit. Indicates whether amount_reconciled is a credit or debit
+     * amount.
+     */
+    amount_reconciled_direction?: 'credit' | 'debit' | null;
+
+    /**
+     * The amount that remains unreconciled for this expected payment. Value in
+     * specified currency's smallest unit. e.g. $10 would be represented as 1000.
+     */
+    amount_unreconciled?: number | null;
+
+    /**
+     * One of credit or debit. Indicates whether amount_unreconciled is a credit or
+     * debit amount.
+     */
+    amount_unreconciled_direction?: 'credit' | 'debit' | null;
+
     /**
      * The highest amount this expected payment may be equal to. Value in specified
      * currency's smallest unit. e.g. $10 would be represented as 1000.
@@ -923,6 +953,11 @@ export namespace BulkRequestCreateParams {
      */
     expires_at?: string | null;
 
+    /**
+     * An optional user-defined 180 character unique identifier.
+     */
+    external_id?: string | null;
+
     /**
      * A payment type to fallback to if the original type is not valid for the
      * receiving account. Currently, this only supports falling back from RTP to ACH
@@ -1220,6 +1255,7 @@ export namespace BulkRequestCreateParams {
         account_number_type?:
           | 'au_number'
           | 'base_address'
+          | 'card_token'
           | 'clabe'
           | 'ethereum_address'
           | 'hk_number'
@@ -1310,6 +1346,30 @@ export namespace BulkRequestCreateParams {
      */
     amount_lower_bound?: number | null;
 
+    /**
+     * The amount reconciled for this expected payment. Value in specified currency's
+     * smallest unit. e.g. $10 would be represented as 1000.
+     */
+    amount_reconciled?: number | null;
+
+    /**
+     * One of credit or debit. Indicates whether amount_reconciled is a credit or debit
+     * amount.
+     */
+    amount_reconciled_direction?: 'credit' | 'debit' | null;
+
+    /**
+     * The amount that remains unreconciled for this expected payment. Value in
+     * specified currency's smallest unit. e.g. $10 would be represented as 1000.
+     */
+    amount_unreconciled?: number | null;
+
+    /**
+     * One of credit or debit. Indicates whether amount_unreconciled is a credit or
+     * debit amount.
+     */
+    amount_unreconciled_direction?: 'credit' | 'debit' | null;
+
     /**
      * The highest amount this expected payment may be equal to. Value in specified
      * currency's smallest unit. e.g. $10 would be represented as 1000.
@@ -1430,6 +1490,12 @@ export namespace BulkRequestCreateParams {
      */
     effective_at?: string;
 
+    /**
+     * A unique string to represent the ledger transaction. Only one pending or posted
+     * ledger transaction may have this ID in the ledger.
+     */
+    external_id?: string | null;
+
     /**
      * An array of ledger entry objects.
      */

package/src/resources/connection-legal-entities.ts

@@ -80,7 +80,7 @@ export interface ConnectionLegalEntity {
   /**
    * The status of the connection legal entity.
    */
-  status: 'completed' | 'denied' | 'failed' | 'processing';
+  status: 'closed' | 'completed' | 'denied' | 'failed' | 'processing' | 'suspended';
 
   updated_at: string;
 
@@ -119,6 +119,11 @@ export namespace ConnectionLegalEntityCreateParams {
 
     bank_settings?: LegalEntity.BankSettings | null;
 
+    /**
+     * A description of the business.
+     */
+    business_description?: string | null;
+
     /**
      * The business's legal business name.
      */
@@ -129,7 +134,20 @@ export namespace ConnectionLegalEntityCreateParams {
      */
     citizenship_country?: string | null;
 
-    compliance_details?: Shared.LegalEntityComplianceDetail | null;
+    /**
+     * The connection ID for the connection the legal entity is associated with.
+     * Defaults to the id of the connection designated with an is_default value of true
+     * or the id of an existing operational connection if only one is available. Pass
+     * in a value of null to prevent the connection from being associated with the
+     * legal entity.
+     */
+    connection_id?: string | null;
+
+    /**
+     * The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
+     * alpha-3 formats.
+     */
+    country_of_incorporation?: string | null;
 
     /**
      * A business's formation date (YYYY-MM-DD).
@@ -148,6 +166,16 @@ export namespace ConnectionLegalEntityCreateParams {
      */
     email?: string | null;
 
+    /**
+     * Monthly expected transaction volume in USD.
+     */
+    expected_activity_volume?: number | null;
+
+    /**
+     * An optional user-defined 180 character unique identifier.
+     */
+    external_id?: string | null;
+
     /**
      * An individual's first name.
      */
@@ -163,6 +191,11 @@ export namespace ConnectionLegalEntityCreateParams {
      */
     industry_classifications?: Array<Shared.LegalEntityIndustryClassification>;
 
+    /**
+     * A description of the intended use of the legal entity.
+     */
+    intended_use?: string | null;
+
     /**
      * An individual's last name.
      */
@@ -171,7 +204,7 @@ export namespace ConnectionLegalEntityCreateParams {
     /**
      * The legal entity associations and its child legal entities.
      */
-    legal_entity_associations?: Array<LegalEntity.LegalEntityAssociation> | null;
+    legal_entity_associations?: Array<Shared.LegalEntityAssociationInlineCreate> | null;
 
     /**
      * The type of legal entity.
@@ -190,6 +223,11 @@ export namespace ConnectionLegalEntityCreateParams {
       | 'trust'
       | null;
 
+    /**
+     * ISO 10383 market identifier code.
+     */
+    listed_exchange?: string | null;
+
     /**
      * Additional data represented as key-value pairs. Both the key and value must be
      * strings.
@@ -201,6 +239,12 @@ export namespace ConnectionLegalEntityCreateParams {
      */
     middle_name?: string | null;
 
+    /**
+     * A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
+     * codes).
+     */
+    operating_jurisdictions?: Array<string>;
+
     phone_numbers?: Array<LegalEntity.PhoneNumber>;
 
     /**
@@ -218,16 +262,42 @@ export namespace ConnectionLegalEntityCreateParams {
      */
     prefix?: string | null;
 
+    /**
+     * A list of primary social media URLs for the business.
+     */
+    primary_social_media_sites?: Array<string>;
+
+    /**
+     * Array of regulatory bodies overseeing this institution.
+     */
+    regulators?: Array<LegalEntity.Regulator> | null;
+
     /**
      * The risk rating of the legal entity. One of low, medium, high.
      */
     risk_rating?: 'low' | 'medium' | 'high' | null;
 
+    /**
+     * The activation status of the legal entity. One of pending, active, suspended, or
+     * closed.
+     */
+    status?: 'active' | 'closed' | 'pending' | 'suspended' | null;
+
     /**
      * An individual's suffix.
      */
     suffix?: string | null;
 
+    /**
+     * Information describing a third-party verification run by an external vendor.
+     */
+    third_party_verification?: LegalEntity.ThirdPartyVerification | null;
+
+    /**
+     * Stock ticker symbol for publicly traded companies.
+     */
+    ticker_symbol?: string | null;
+
     wealth_and_employment_details?: LegalEntity.WealthAndEmploymentDetails | null;
 
     /**
@@ -279,42 +349,51 @@ export namespace ConnectionLegalEntityCreateParams {
       updated_at: string;
     }
 
-    export interface LegalEntityAssociation {
-      relationship_types: Array<'authorized_signer' | 'beneficial_owner' | 'control_person'>;
-
-      /**
-       * The child legal entity.
-       */
-      child_legal_entity?: Shared.ChildLegalEntityCreate;
+    /**
+     * A list of phone numbers in E.164 format.
+     */
+    export interface PhoneNumber {
+      phone_number?: string;
+    }
 
+    export interface Regulator {
       /**
-       * The ID of the child legal entity.
+       * The country code where the regulator operates in the ISO 3166-1 alpha-2 format
+       * (e.g., "US", "CA", "GB").
        */
-      child_legal_entity_id?: string;
+      jurisdiction: string;
 
       /**
-       * The child entity's ownership percentage iff they are a beneficial owner.
+       * Full name of the regulatory body.
        */
-      ownership_percentage?: number | null;
+      name: string;
 
       /**
-       * The job title of the child entity at the parent entity.
+       * Registration or identification number with the regulator.
        */
-      title?: string | null;
+      registration_number: string;
     }
 
     /**
-     * A list of phone numbers in E.164 format.
+     * Information describing a third-party verification run by an external vendor.
      */
-    export interface PhoneNumber {
-      phone_number?: string;
+    export interface ThirdPartyVerification {
+      /**
+       * The vendor that performed the verification, e.g. `persona`.
+       */
+      vendor: 'persona';
+
+      /**
+       * The identification of the third party verification in `vendor`'s system.
+       */
+      vendor_verification_id: string;
     }
 
     export interface WealthAndEmploymentDetails {
       id: string;
 
       /**
-       * The annual income of the individual.
+       * The annual income of the individual in USD.
        */
       annual_income: number | null;
 
@@ -438,17 +517,24 @@ export namespace ConnectionLegalEntityCreateParams {
         | 'alimony'
         | 'annuity'
         | 'business_owner'
+        | 'business_revenue'
+        | 'debt_financing'
         | 'general_employee'
         | 'government_benefits'
         | 'homemaker'
         | 'inheritance_gift'
+        | 'intercompany_loan'
         | 'investment'
+        | 'investor_funding'
         | 'legal_settlement'
         | 'lottery'
         | 'real_estate'
+        | 'retained_earnings_or_savings'
         | 'retired'
         | 'retirement'
         | 'salary'
+        | 'sale_of_business_assets'
+        | 'sale_of_real_estate'
         | 'self_employed'
         | 'senior_executive'
         | 'trust_income'
@@ -487,7 +573,7 @@ export interface ConnectionLegalEntityListParams extends PageParams {
 
   legal_entity_id?: string;
 
-  status?: 'completed' | 'denied' | 'failed' | 'processing';
+  status?: 'closed' | 'completed' | 'denied' | 'failed' | 'processing' | 'suspended';
 }
 
 export declare namespace ConnectionLegalEntities {

package/src/resources/counterparties.ts

@@ -411,6 +411,7 @@ export namespace CounterpartyCreateParams {
       account_number_type?:
         | 'au_number'
         | 'base_address'
+        | 'card_token'
         | 'clabe'
         | 'ethereum_address'
         | 'hk_number'
@@ -504,6 +505,11 @@ export namespace CounterpartyCreateParams {
 
     bank_settings?: LegalEntity.BankSettings | null;
 
+    /**
+     * A description of the business.
+     */
+    business_description?: string | null;
+
     /**
      * The business's legal business name.
      */
@@ -514,7 +520,20 @@ export namespace CounterpartyCreateParams {
      */
     citizenship_country?: string | null;
 
-    compliance_details?: Shared.LegalEntityComplianceDetail | null;
+    /**
+     * The connection ID for the connection the legal entity is associated with.
+     * Defaults to the id of the connection designated with an is_default value of true
+     * or the id of an existing operational connection if only one is available. Pass
+     * in a value of null to prevent the connection from being associated with the
+     * legal entity.
+     */
+    connection_id?: string | null;
+
+    /**
+     * The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
+     * alpha-3 formats.
+     */
+    country_of_incorporation?: string | null;
 
     /**
      * A business's formation date (YYYY-MM-DD).
@@ -533,6 +552,16 @@ export namespace CounterpartyCreateParams {
      */
     email?: string | null;
 
+    /**
+     * Monthly expected transaction volume in USD.
+     */
+    expected_activity_volume?: number | null;
+
+    /**
+     * An optional user-defined 180 character unique identifier.
+     */
+    external_id?: string | null;
+
     /**
      * An individual's first name.
      */
@@ -548,6 +577,11 @@ export namespace CounterpartyCreateParams {
      */
     industry_classifications?: Array<Shared.LegalEntityIndustryClassification>;
 
+    /**
+     * A description of the intended use of the legal entity.
+     */
+    intended_use?: string | null;
+
     /**
      * An individual's last name.
      */
@@ -556,7 +590,7 @@ export namespace CounterpartyCreateParams {
     /**
      * The legal entity associations and its child legal entities.
      */
-    legal_entity_associations?: Array<LegalEntity.LegalEntityAssociation> | null;
+    legal_entity_associations?: Array<Shared.LegalEntityAssociationInlineCreate> | null;
 
     /**
      * The business's legal structure.
@@ -570,6 +604,11 @@ export namespace CounterpartyCreateParams {
       | 'trust'
       | null;
 
+    /**
+     * ISO 10383 market identifier code.
+     */
+    listed_exchange?: string | null;
+
     /**
      * Additional data represented as key-value pairs. Both the key and value must be
      * strings.
@@ -581,6 +620,12 @@ export namespace CounterpartyCreateParams {
      */
     middle_name?: string | null;
 
+    /**
+     * A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
+     * codes).
+     */
+    operating_jurisdictions?: Array<string>;
+
     phone_numbers?: Array<LegalEntity.PhoneNumber>;
 
     /**
@@ -598,16 +643,42 @@ export namespace CounterpartyCreateParams {
      */
     prefix?: string | null;
 
+    /**
+     * A list of primary social media URLs for the business.
+     */
+    primary_social_media_sites?: Array<string>;
+
+    /**
+     * Array of regulatory bodies overseeing this institution.
+     */
+    regulators?: Array<LegalEntity.Regulator> | null;
+
     /**
      * The risk rating of the legal entity. One of low, medium, high.
      */
     risk_rating?: 'low' | 'medium' | 'high' | null;
 
+    /**
+     * The activation status of the legal entity. One of pending, active, suspended, or
+     * closed.
+     */
+    status?: 'active' | 'closed' | 'pending' | 'suspended' | null;
+
     /**
      * An individual's suffix.
      */
     suffix?: string | null;
 
+    /**
+     * Information describing a third-party verification run by an external vendor.
+     */
+    third_party_verification?: LegalEntity.ThirdPartyVerification | null;
+
+    /**
+     * Stock ticker symbol for publicly traded companies.
+     */
+    ticker_symbol?: string | null;
+
     wealth_and_employment_details?: LegalEntity.WealthAndEmploymentDetails | null;
 
     /**
@@ -659,42 +730,51 @@ export namespace CounterpartyCreateParams {
       updated_at: string;
     }
 
-    export interface LegalEntityAssociation {
-      relationship_types: Array<'authorized_signer' | 'beneficial_owner' | 'control_person'>;
-
-      /**
-       * The child legal entity.
-       */
-      child_legal_entity?: Shared.ChildLegalEntityCreate;
+    /**
+     * A list of phone numbers in E.164 format.
+     */
+    export interface PhoneNumber {
+      phone_number?: string;
+    }
 
+    export interface Regulator {
       /**
-       * The ID of the child legal entity.
+       * The country code where the regulator operates in the ISO 3166-1 alpha-2 format
+       * (e.g., "US", "CA", "GB").
        */
-      child_legal_entity_id?: string;
+      jurisdiction: string;
 
       /**
-       * The child entity's ownership percentage iff they are a beneficial owner.
+       * Full name of the regulatory body.
        */
-      ownership_percentage?: number | null;
+      name: string;
 
       /**
-       * The job title of the child entity at the parent entity.
+       * Registration or identification number with the regulator.
        */
-      title?: string | null;
+      registration_number: string;
     }
 
     /**
-     * A list of phone numbers in E.164 format.
+     * Information describing a third-party verification run by an external vendor.
      */
-    export interface PhoneNumber {
-      phone_number?: string;
+    export interface ThirdPartyVerification {
+      /**
+       * The vendor that performed the verification, e.g. `persona`.
+       */
+      vendor: 'persona';
+
+      /**
+       * The identification of the third party verification in `vendor`'s system.
+       */
+      vendor_verification_id: string;
     }
 
     export interface WealthAndEmploymentDetails {
       id: string;
 
       /**
-       * The annual income of the individual.
+       * The annual income of the individual in USD.
        */
       annual_income: number | null;
 
@@ -818,17 +898,24 @@ export namespace CounterpartyCreateParams {
         | 'alimony'
         | 'annuity'
         | 'business_owner'
+        | 'business_revenue'
+        | 'debt_financing'
         | 'general_employee'
         | 'government_benefits'
         | 'homemaker'
         | 'inheritance_gift'
+        | 'intercompany_loan'
         | 'investment'
+        | 'investor_funding'
         | 'legal_settlement'
         | 'lottery'
         | 'real_estate'
+        | 'retained_earnings_or_savings'
         | 'retired'
         | 'retirement'
         | 'salary'
+        | 'sale_of_business_assets'
+        | 'sale_of_real_estate'
         | 'self_employed'
         | 'senior_executive'
         | 'trust_income'
@@ -861,6 +948,11 @@ export interface CounterpartyUpdateParams {
    */
   email?: string;
 
+  /**
+   * An optional user-defined 180 character unique identifier.
+   */
+  external_id?: string | null;
+
   /**
    * The id of the legal entity.
    */