modern_treasury 0.0.0 → 0.1.0.pre.alpha.15

data/lib/modern_treasury/models/legal_entity_create_params.rb

@@ -0,0 +1,1131 @@
+# frozen_string_literal: true
+
+module ModernTreasury
+  module Models
+    class LegalEntityCreateParams < ModernTreasury::BaseModel
+      # @!parse
+      #   extend ModernTreasury::RequestParameters::Converter
+      include ModernTreasury::RequestParameters
+
+      # @!attribute legal_entity_type
+      #   The type of legal entity.
+      #
+      #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityType]
+      required :legal_entity_type, enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityType }
+
+      # @!attribute [r] addresses
+      #   A list of addresses for the entity.
+      #
+      #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::Address>, nil]
+      optional :addresses,
+               -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::Address] }
+
+      # @!parse
+      #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::Address>]
+      #   attr_writer :addresses
+
+      # @!attribute bank_settings
+      #
+      #   @return [ModernTreasury::Models::BankSettings, nil]
+      optional :bank_settings, -> { ModernTreasury::Models::BankSettings }, nil?: true
+
+      # @!attribute business_name
+      #   The business's legal business name.
+      #
+      #   @return [String, nil]
+      optional :business_name, String, nil?: true
+
+      # @!attribute citizenship_country
+      #   The country of citizenship for an individual.
+      #
+      #   @return [String, nil]
+      optional :citizenship_country, String, nil?: true
+
+      # @!attribute date_formed
+      #   A business's formation date (YYYY-MM-DD).
+      #
+      #   @return [Date, nil]
+      optional :date_formed, Date, nil?: true
+
+      # @!attribute date_of_birth
+      #   An individual's date of birth (YYYY-MM-DD).
+      #
+      #   @return [Date, nil]
+      optional :date_of_birth, Date, nil?: true
+
+      # @!attribute [r] doing_business_as_names
+      #
+      #   @return [Array<String>, nil]
+      optional :doing_business_as_names, ModernTreasury::ArrayOf[String]
+
+      # @!parse
+      #   # @return [Array<String>]
+      #   attr_writer :doing_business_as_names
+
+      # @!attribute email
+      #   The entity's primary email.
+      #
+      #   @return [String, nil]
+      optional :email, String, nil?: true
+
+      # @!attribute first_name
+      #   An individual's first name.
+      #
+      #   @return [String, nil]
+      optional :first_name, String, nil?: true
+
+      # @!attribute [r] identifications
+      #   A list of identifications for the legal entity.
+      #
+      #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::Identification>, nil]
+      optional :identifications,
+               -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::Identification] }
+
+      # @!parse
+      #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::Identification>]
+      #   attr_writer :identifications
+
+      # @!attribute last_name
+      #   An individual's last name.
+      #
+      #   @return [String, nil]
+      optional :last_name, String, nil?: true
+
+      # @!attribute legal_entity_associations
+      #   The legal entity associations and its child legal entities.
+      #
+      #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation>, nil]
+      optional :legal_entity_associations,
+               -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation] },
+               nil?: true
+
+      # @!attribute legal_structure
+      #   The business's legal structure.
+      #
+      #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalStructure, nil]
+      optional :legal_structure,
+               enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalStructure },
+               nil?: true
+
+      # @!attribute [r] metadata
+      #   Additional data represented as key-value pairs. Both the key and value must be
+      #     strings.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, ModernTreasury::HashOf[String]
+
+      # @!parse
+      #   # @return [Hash{Symbol=>String}]
+      #   attr_writer :metadata
+
+      # @!attribute middle_name
+      #   An individual's middle name.
+      #
+      #   @return [String, nil]
+      optional :middle_name, String, nil?: true
+
+      # @!attribute [r] phone_numbers
+      #
+      #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::PhoneNumber>, nil]
+      optional :phone_numbers,
+               -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::PhoneNumber] }
+
+      # @!parse
+      #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::PhoneNumber>]
+      #   attr_writer :phone_numbers
+
+      # @!attribute politically_exposed_person
+      #   Whether the individual is a politically exposed person.
+      #
+      #   @return [Boolean, nil]
+      optional :politically_exposed_person, ModernTreasury::BooleanModel, nil?: true
+
+      # @!attribute preferred_name
+      #   An individual's preferred name.
+      #
+      #   @return [String, nil]
+      optional :preferred_name, String, nil?: true
+
+      # @!attribute prefix
+      #   An individual's prefix.
+      #
+      #   @return [String, nil]
+      optional :prefix, String, nil?: true
+
+      # @!attribute risk_rating
+      #   The risk rating of the legal entity. One of low, medium, high.
+      #
+      #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::RiskRating, nil]
+      optional :risk_rating,
+               enum: -> { ModernTreasury::Models::LegalEntityCreateParams::RiskRating },
+               nil?: true
+
+      # @!attribute suffix
+      #   An individual's suffix.
+      #
+      #   @return [String, nil]
+      optional :suffix, String, nil?: true
+
+      # @!attribute wealth_and_employment_details
+      #
+      #   @return [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+      optional :wealth_and_employment_details,
+               -> { ModernTreasury::Models::WealthAndEmploymentDetails },
+               nil?: true
+
+      # @!attribute website
+      #   The entity's primary website URL.
+      #
+      #   @return [String, nil]
+      optional :website, String, nil?: true
+
+      # @!parse
+      #   # @param legal_entity_type [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityType]
+      #   # @param addresses [Array<ModernTreasury::Models::LegalEntityCreateParams::Address>]
+      #   # @param bank_settings [ModernTreasury::Models::BankSettings, nil]
+      #   # @param business_name [String, nil]
+      #   # @param citizenship_country [String, nil]
+      #   # @param date_formed [Date, nil]
+      #   # @param date_of_birth [Date, nil]
+      #   # @param doing_business_as_names [Array<String>]
+      #   # @param email [String, nil]
+      #   # @param first_name [String, nil]
+      #   # @param identifications [Array<ModernTreasury::Models::LegalEntityCreateParams::Identification>]
+      #   # @param last_name [String, nil]
+      #   # @param legal_entity_associations [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation>, nil]
+      #   # @param legal_structure [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalStructure, nil]
+      #   # @param metadata [Hash{Symbol=>String}]
+      #   # @param middle_name [String, nil]
+      #   # @param phone_numbers [Array<ModernTreasury::Models::LegalEntityCreateParams::PhoneNumber>]
+      #   # @param politically_exposed_person [Boolean, nil]
+      #   # @param preferred_name [String, nil]
+      #   # @param prefix [String, nil]
+      #   # @param risk_rating [Symbol, ModernTreasury::Models::LegalEntityCreateParams::RiskRating, nil]
+      #   # @param suffix [String, nil]
+      #   # @param wealth_and_employment_details [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+      #   # @param website [String, nil]
+      #   # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}]
+      #   #
+      #   def initialize(
+      #     legal_entity_type:,
+      #     addresses: nil,
+      #     bank_settings: nil,
+      #     business_name: nil,
+      #     citizenship_country: nil,
+      #     date_formed: nil,
+      #     date_of_birth: nil,
+      #     doing_business_as_names: nil,
+      #     email: nil,
+      #     first_name: nil,
+      #     identifications: nil,
+      #     last_name: nil,
+      #     legal_entity_associations: nil,
+      #     legal_structure: nil,
+      #     metadata: nil,
+      #     middle_name: nil,
+      #     phone_numbers: nil,
+      #     politically_exposed_person: nil,
+      #     preferred_name: nil,
+      #     prefix: nil,
+      #     risk_rating: nil,
+      #     suffix: nil,
+      #     wealth_and_employment_details: nil,
+      #     website: nil,
+      #     request_options: {},
+      #     **
+      #   )
+      #     super
+      #   end
+
+      # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+      # @abstract
+      #
+      # The type of legal entity.
+      #
+      # @example
+      # ```ruby
+      # case legal_entity_type
+      # in :business
+      #   # ...
+      # in :individual
+      #   # ...
+      # end
+      # ```
+      class LegalEntityType < ModernTreasury::Enum
+        BUSINESS = :business
+        INDIVIDUAL = :individual
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   #
+        #   def self.values; end
+      end
+
+      class Address < ModernTreasury::BaseModel
+        # @!attribute country
+        #   Country code conforms to [ISO 3166-1 alpha-2]
+        #
+        #   @return [String, nil]
+        required :country, String, nil?: true
+
+        # @!attribute line1
+        #
+        #   @return [String, nil]
+        required :line1, String, nil?: true
+
+        # @!attribute locality
+        #   Locality or City.
+        #
+        #   @return [String, nil]
+        required :locality, String, nil?: true
+
+        # @!attribute postal_code
+        #   The postal code of the address.
+        #
+        #   @return [String, nil]
+        required :postal_code, String, nil?: true
+
+        # @!attribute region
+        #   Region or State.
+        #
+        #   @return [String, nil]
+        required :region, String, nil?: true
+
+        # @!attribute [r] address_types
+        #   The types of this address.
+        #
+        #   @return [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::Address::AddressType>, nil]
+        optional :address_types,
+                 -> { ModernTreasury::ArrayOf[enum: ModernTreasury::Models::LegalEntityCreateParams::Address::AddressType] }
+
+        # @!parse
+        #   # @return [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::Address::AddressType>]
+        #   attr_writer :address_types
+
+        # @!attribute line2
+        #
+        #   @return [String, nil]
+        optional :line2, String, nil?: true
+
+        # @!parse
+        #   # @param country [String, nil]
+        #   # @param line1 [String, nil]
+        #   # @param locality [String, nil]
+        #   # @param postal_code [String, nil]
+        #   # @param region [String, nil]
+        #   # @param address_types [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::Address::AddressType>]
+        #   # @param line2 [String, nil]
+        #   #
+        #   def initialize(country:, line1:, locality:, postal_code:, region:, address_types: nil, line2: nil, **) = super
+
+        # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+        # @abstract
+        #
+        # @example
+        # ```ruby
+        # case address_type
+        # in :business
+        #   # ...
+        # in :mailing
+        #   # ...
+        # in :other
+        #   # ...
+        # in :po_box
+        #   # ...
+        # in :residential
+        #   # ...
+        # end
+        # ```
+        class AddressType < ModernTreasury::Enum
+          BUSINESS = :business
+          MAILING = :mailing
+          OTHER = :other
+          PO_BOX = :po_box
+          RESIDENTIAL = :residential
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+      end
+
+      class Identification < ModernTreasury::BaseModel
+        # @!attribute id_number
+        #   The ID number of identification document.
+        #
+        #   @return [String]
+        required :id_number, String
+
+        # @!attribute id_type
+        #   The type of ID number.
+        #
+        #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::Identification::IDType]
+        required :id_type, enum: -> { ModernTreasury::Models::LegalEntityCreateParams::Identification::IDType }
+
+        # @!attribute issuing_country
+        #   The ISO 3166-1 alpha-2 country code of the country that issued the
+        #     identification
+        #
+        #   @return [String, nil]
+        optional :issuing_country, String, nil?: true
+
+        # @!parse
+        #   # @param id_number [String]
+        #   # @param id_type [Symbol, ModernTreasury::Models::LegalEntityCreateParams::Identification::IDType]
+        #   # @param issuing_country [String, nil]
+        #   #
+        #   def initialize(id_number:, id_type:, issuing_country: nil, **) = super
+
+        # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+        # @abstract
+        #
+        # The type of ID number.
+        #
+        # @example
+        # ```ruby
+        # case id_type
+        # in :ar_cuil
+        #   # ...
+        # in :ar_cuit
+        #   # ...
+        # in :br_cnpj
+        #   # ...
+        # in :br_cpf
+        #   # ...
+        # in :cl_run
+        #   # ...
+        # in ...
+        #   #...
+        # end
+        # ```
+        class IDType < ModernTreasury::Enum
+          AR_CUIL = :ar_cuil
+          AR_CUIT = :ar_cuit
+          BR_CNPJ = :br_cnpj
+          BR_CPF = :br_cpf
+          CL_RUN = :cl_run
+          CL_RUT = :cl_rut
+          CO_CEDULAS = :co_cedulas
+          CO_NIT = :co_nit
+          HN_ID = :hn_id
+          HN_RTN = :hn_rtn
+          IN_LEI = :in_lei
+          KR_BRN = :kr_brn
+          KR_CRN = :kr_crn
+          KR_RRN = :kr_rrn
+          PASSPORT = :passport
+          SA_TIN = :sa_tin
+          SA_VAT = :sa_vat
+          US_EIN = :us_ein
+          US_ITIN = :us_itin
+          US_SSN = :us_ssn
+          VN_TIN = :vn_tin
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+      end
+
+      class LegalEntityAssociation < ModernTreasury::BaseModel
+        # @!attribute relationship_types
+        #
+        #   @return [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::RelationshipType>]
+        required :relationship_types,
+                 -> { ModernTreasury::ArrayOf[enum: ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::RelationshipType] }
+
+        # @!attribute [r] child_legal_entity
+        #   The child legal entity.
+        #
+        #   @return [ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity, nil]
+        optional :child_legal_entity,
+                 -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity }
+
+        # @!parse
+        #   # @return [ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity]
+        #   attr_writer :child_legal_entity
+
+        # @!attribute [r] child_legal_entity_id
+        #   The ID of the child legal entity.
+        #
+        #   @return [String, nil]
+        optional :child_legal_entity_id, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :child_legal_entity_id
+
+        # @!attribute ownership_percentage
+        #   The child entity's ownership percentage iff they are a beneficial owner.
+        #
+        #   @return [Integer, nil]
+        optional :ownership_percentage, Integer, nil?: true
+
+        # @!attribute title
+        #   The job title of the child entity at the parent entity.
+        #
+        #   @return [String, nil]
+        optional :title, String, nil?: true
+
+        # @!parse
+        #   # @param relationship_types [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::RelationshipType>]
+        #   # @param child_legal_entity [ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity]
+        #   # @param child_legal_entity_id [String]
+        #   # @param ownership_percentage [Integer, nil]
+        #   # @param title [String, nil]
+        #   #
+        #   def initialize(
+        #     relationship_types:,
+        #     child_legal_entity: nil,
+        #     child_legal_entity_id: nil,
+        #     ownership_percentage: nil,
+        #     title: nil,
+        #     **
+        #   )
+        #     super
+        #   end
+
+        # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+        # @abstract
+        #
+        # A list of relationship types for how the child entity relates to parent entity.
+        #
+        # @example
+        # ```ruby
+        # case relationship_type
+        # in :beneficial_owner
+        #   # ...
+        # in :control_person
+        #   # ...
+        # end
+        # ```
+        class RelationshipType < ModernTreasury::Enum
+          BENEFICIAL_OWNER = :beneficial_owner
+          CONTROL_PERSON = :control_person
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+
+        class ChildLegalEntity < ModernTreasury::BaseModel
+          # @!attribute [r] addresses
+          #   A list of addresses for the entity.
+          #
+          #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address>, nil]
+          optional :addresses,
+                   -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address] }
+
+          # @!parse
+          #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address>]
+          #   attr_writer :addresses
+
+          # @!attribute bank_settings
+          #
+          #   @return [ModernTreasury::Models::BankSettings, nil]
+          optional :bank_settings, -> { ModernTreasury::Models::BankSettings }, nil?: true
+
+          # @!attribute business_name
+          #   The business's legal business name.
+          #
+          #   @return [String, nil]
+          optional :business_name, String, nil?: true
+
+          # @!attribute citizenship_country
+          #   The country of citizenship for an individual.
+          #
+          #   @return [String, nil]
+          optional :citizenship_country, String, nil?: true
+
+          # @!attribute date_formed
+          #   A business's formation date (YYYY-MM-DD).
+          #
+          #   @return [Date, nil]
+          optional :date_formed, Date, nil?: true
+
+          # @!attribute date_of_birth
+          #   An individual's date of birth (YYYY-MM-DD).
+          #
+          #   @return [Date, nil]
+          optional :date_of_birth, Date, nil?: true
+
+          # @!attribute [r] doing_business_as_names
+          #
+          #   @return [Array<String>, nil]
+          optional :doing_business_as_names, ModernTreasury::ArrayOf[String]
+
+          # @!parse
+          #   # @return [Array<String>]
+          #   attr_writer :doing_business_as_names
+
+          # @!attribute email
+          #   The entity's primary email.
+          #
+          #   @return [String, nil]
+          optional :email, String, nil?: true
+
+          # @!attribute first_name
+          #   An individual's first name.
+          #
+          #   @return [String, nil]
+          optional :first_name, String, nil?: true
+
+          # @!attribute [r] identifications
+          #   A list of identifications for the legal entity.
+          #
+          #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification>, nil]
+          optional :identifications,
+                   -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification] }
+
+          # @!parse
+          #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification>]
+          #   attr_writer :identifications
+
+          # @!attribute last_name
+          #   An individual's last name.
+          #
+          #   @return [String, nil]
+          optional :last_name, String, nil?: true
+
+          # @!attribute [r] legal_entity_type
+          #   The type of legal entity.
+          #
+          #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalEntityType, nil]
+          optional :legal_entity_type,
+                   enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalEntityType }
+
+          # @!parse
+          #   # @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalEntityType]
+          #   attr_writer :legal_entity_type
+
+          # @!attribute legal_structure
+          #   The business's legal structure.
+          #
+          #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalStructure, nil]
+          optional :legal_structure,
+                   enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalStructure },
+                   nil?: true
+
+          # @!attribute [r] metadata
+          #   Additional data represented as key-value pairs. Both the key and value must be
+          #     strings.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, ModernTreasury::HashOf[String]
+
+          # @!parse
+          #   # @return [Hash{Symbol=>String}]
+          #   attr_writer :metadata
+
+          # @!attribute middle_name
+          #   An individual's middle name.
+          #
+          #   @return [String, nil]
+          optional :middle_name, String, nil?: true
+
+          # @!attribute [r] phone_numbers
+          #
+          #   @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::PhoneNumber>, nil]
+          optional :phone_numbers,
+                   -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::PhoneNumber] }
+
+          # @!parse
+          #   # @return [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::PhoneNumber>]
+          #   attr_writer :phone_numbers
+
+          # @!attribute politically_exposed_person
+          #   Whether the individual is a politically exposed person.
+          #
+          #   @return [Boolean, nil]
+          optional :politically_exposed_person, ModernTreasury::BooleanModel, nil?: true
+
+          # @!attribute preferred_name
+          #   An individual's preferred name.
+          #
+          #   @return [String, nil]
+          optional :preferred_name, String, nil?: true
+
+          # @!attribute prefix
+          #   An individual's prefix.
+          #
+          #   @return [String, nil]
+          optional :prefix, String, nil?: true
+
+          # @!attribute risk_rating
+          #   The risk rating of the legal entity. One of low, medium, high.
+          #
+          #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::RiskRating, nil]
+          optional :risk_rating,
+                   enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::RiskRating },
+                   nil?: true
+
+          # @!attribute suffix
+          #   An individual's suffix.
+          #
+          #   @return [String, nil]
+          optional :suffix, String, nil?: true
+
+          # @!attribute wealth_and_employment_details
+          #
+          #   @return [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+          optional :wealth_and_employment_details,
+                   -> { ModernTreasury::Models::WealthAndEmploymentDetails },
+                   nil?: true
+
+          # @!attribute website
+          #   The entity's primary website URL.
+          #
+          #   @return [String, nil]
+          optional :website, String, nil?: true
+
+          # @!parse
+          #   # The child legal entity.
+          #   #
+          #   # @param addresses [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address>]
+          #   # @param bank_settings [ModernTreasury::Models::BankSettings, nil]
+          #   # @param business_name [String, nil]
+          #   # @param citizenship_country [String, nil]
+          #   # @param date_formed [Date, nil]
+          #   # @param date_of_birth [Date, nil]
+          #   # @param doing_business_as_names [Array<String>]
+          #   # @param email [String, nil]
+          #   # @param first_name [String, nil]
+          #   # @param identifications [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification>]
+          #   # @param last_name [String, nil]
+          #   # @param legal_entity_type [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalEntityType]
+          #   # @param legal_structure [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::LegalStructure, nil]
+          #   # @param metadata [Hash{Symbol=>String}]
+          #   # @param middle_name [String, nil]
+          #   # @param phone_numbers [Array<ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::PhoneNumber>]
+          #   # @param politically_exposed_person [Boolean, nil]
+          #   # @param preferred_name [String, nil]
+          #   # @param prefix [String, nil]
+          #   # @param risk_rating [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::RiskRating, nil]
+          #   # @param suffix [String, nil]
+          #   # @param wealth_and_employment_details [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+          #   # @param website [String, nil]
+          #   #
+          #   def initialize(
+          #     addresses: nil,
+          #     bank_settings: nil,
+          #     business_name: nil,
+          #     citizenship_country: nil,
+          #     date_formed: nil,
+          #     date_of_birth: nil,
+          #     doing_business_as_names: nil,
+          #     email: nil,
+          #     first_name: nil,
+          #     identifications: nil,
+          #     last_name: nil,
+          #     legal_entity_type: nil,
+          #     legal_structure: nil,
+          #     metadata: nil,
+          #     middle_name: nil,
+          #     phone_numbers: nil,
+          #     politically_exposed_person: nil,
+          #     preferred_name: nil,
+          #     prefix: nil,
+          #     risk_rating: nil,
+          #     suffix: nil,
+          #     wealth_and_employment_details: nil,
+          #     website: nil,
+          #     **
+          #   )
+          #     super
+          #   end
+
+          # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+          class Address < ModernTreasury::BaseModel
+            # @!attribute country
+            #   Country code conforms to [ISO 3166-1 alpha-2]
+            #
+            #   @return [String, nil]
+            required :country, String, nil?: true
+
+            # @!attribute line1
+            #
+            #   @return [String, nil]
+            required :line1, String, nil?: true
+
+            # @!attribute locality
+            #   Locality or City.
+            #
+            #   @return [String, nil]
+            required :locality, String, nil?: true
+
+            # @!attribute postal_code
+            #   The postal code of the address.
+            #
+            #   @return [String, nil]
+            required :postal_code, String, nil?: true
+
+            # @!attribute region
+            #   Region or State.
+            #
+            #   @return [String, nil]
+            required :region, String, nil?: true
+
+            # @!attribute [r] address_types
+            #   The types of this address.
+            #
+            #   @return [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address::AddressType>, nil]
+            optional :address_types,
+                     -> do
+                       ModernTreasury::ArrayOf[
+                       enum: ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address::AddressType
+                       ]
+                     end
+
+            # @!parse
+            #   # @return [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address::AddressType>]
+            #   attr_writer :address_types
+
+            # @!attribute line2
+            #
+            #   @return [String, nil]
+            optional :line2, String, nil?: true
+
+            # @!parse
+            #   # @param country [String, nil]
+            #   # @param line1 [String, nil]
+            #   # @param locality [String, nil]
+            #   # @param postal_code [String, nil]
+            #   # @param region [String, nil]
+            #   # @param address_types [Array<Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Address::AddressType>]
+            #   # @param line2 [String, nil]
+            #   #
+            #   def initialize(country:, line1:, locality:, postal_code:, region:, address_types: nil, line2: nil, **) = super
+
+            # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+            # @abstract
+            #
+            # @example
+            # ```ruby
+            # case address_type
+            # in :business
+            #   # ...
+            # in :mailing
+            #   # ...
+            # in :other
+            #   # ...
+            # in :po_box
+            #   # ...
+            # in :residential
+            #   # ...
+            # end
+            # ```
+            class AddressType < ModernTreasury::Enum
+              BUSINESS = :business
+              MAILING = :mailing
+              OTHER = :other
+              PO_BOX = :po_box
+              RESIDENTIAL = :residential
+
+              finalize!
+
+              # @!parse
+              #   # @return [Array<Symbol>]
+              #   #
+              #   def self.values; end
+            end
+          end
+
+          class Identification < ModernTreasury::BaseModel
+            # @!attribute id_number
+            #   The ID number of identification document.
+            #
+            #   @return [String]
+            required :id_number, String
+
+            # @!attribute id_type
+            #   The type of ID number.
+            #
+            #   @return [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification::IDType]
+            required :id_type,
+                     enum: -> { ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification::IDType }
+
+            # @!attribute issuing_country
+            #   The ISO 3166-1 alpha-2 country code of the country that issued the
+            #     identification
+            #
+            #   @return [String, nil]
+            optional :issuing_country, String, nil?: true
+
+            # @!parse
+            #   # @param id_number [String]
+            #   # @param id_type [Symbol, ModernTreasury::Models::LegalEntityCreateParams::LegalEntityAssociation::ChildLegalEntity::Identification::IDType]
+            #   # @param issuing_country [String, nil]
+            #   #
+            #   def initialize(id_number:, id_type:, issuing_country: nil, **) = super
+
+            # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+            # @abstract
+            #
+            # The type of ID number.
+            #
+            # @example
+            # ```ruby
+            # case id_type
+            # in :ar_cuil
+            #   # ...
+            # in :ar_cuit
+            #   # ...
+            # in :br_cnpj
+            #   # ...
+            # in :br_cpf
+            #   # ...
+            # in :cl_run
+            #   # ...
+            # in ...
+            #   #...
+            # end
+            # ```
+            class IDType < ModernTreasury::Enum
+              AR_CUIL = :ar_cuil
+              AR_CUIT = :ar_cuit
+              BR_CNPJ = :br_cnpj
+              BR_CPF = :br_cpf
+              CL_RUN = :cl_run
+              CL_RUT = :cl_rut
+              CO_CEDULAS = :co_cedulas
+              CO_NIT = :co_nit
+              HN_ID = :hn_id
+              HN_RTN = :hn_rtn
+              IN_LEI = :in_lei
+              KR_BRN = :kr_brn
+              KR_CRN = :kr_crn
+              KR_RRN = :kr_rrn
+              PASSPORT = :passport
+              SA_TIN = :sa_tin
+              SA_VAT = :sa_vat
+              US_EIN = :us_ein
+              US_ITIN = :us_itin
+              US_SSN = :us_ssn
+              VN_TIN = :vn_tin
+
+              finalize!
+
+              # @!parse
+              #   # @return [Array<Symbol>]
+              #   #
+              #   def self.values; end
+            end
+          end
+
+          # @abstract
+          #
+          # The type of legal entity.
+          #
+          # @example
+          # ```ruby
+          # case legal_entity_type
+          # in :business
+          #   # ...
+          # in :individual
+          #   # ...
+          # end
+          # ```
+          class LegalEntityType < ModernTreasury::Enum
+            BUSINESS = :business
+            INDIVIDUAL = :individual
+
+            finalize!
+
+            # @!parse
+            #   # @return [Array<Symbol>]
+            #   #
+            #   def self.values; end
+          end
+
+          # @abstract
+          #
+          # The business's legal structure.
+          #
+          # @example
+          # ```ruby
+          # case legal_structure
+          # in :corporation
+          #   # ...
+          # in :llc
+          #   # ...
+          # in :non_profit
+          #   # ...
+          # in :partnership
+          #   # ...
+          # in :sole_proprietorship
+          #   # ...
+          # in ...
+          #   #...
+          # end
+          # ```
+          class LegalStructure < ModernTreasury::Enum
+            CORPORATION = :corporation
+            LLC = :llc
+            NON_PROFIT = :non_profit
+            PARTNERSHIP = :partnership
+            SOLE_PROPRIETORSHIP = :sole_proprietorship
+            TRUST = :trust
+
+            finalize!
+
+            # @!parse
+            #   # @return [Array<Symbol>]
+            #   #
+            #   def self.values; end
+          end
+
+          class PhoneNumber < ModernTreasury::BaseModel
+            # @!attribute [r] phone_number
+            #
+            #   @return [String, nil]
+            optional :phone_number, String
+
+            # @!parse
+            #   # @return [String]
+            #   attr_writer :phone_number
+
+            # @!parse
+            #   # A list of phone numbers in E.164 format.
+            #   #
+            #   # @param phone_number [String]
+            #   #
+            #   def initialize(phone_number: nil, **) = super
+
+            # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+          end
+
+          # @abstract
+          #
+          # The risk rating of the legal entity. One of low, medium, high.
+          #
+          # @example
+          # ```ruby
+          # case risk_rating
+          # in :low
+          #   # ...
+          # in :medium
+          #   # ...
+          # in :high
+          #   # ...
+          # end
+          # ```
+          class RiskRating < ModernTreasury::Enum
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+
+            finalize!
+
+            # @!parse
+            #   # @return [Array<Symbol>]
+            #   #
+            #   def self.values; end
+          end
+        end
+      end
+
+      # @abstract
+      #
+      # The business's legal structure.
+      #
+      # @example
+      # ```ruby
+      # case legal_structure
+      # in :corporation
+      #   # ...
+      # in :llc
+      #   # ...
+      # in :non_profit
+      #   # ...
+      # in :partnership
+      #   # ...
+      # in :sole_proprietorship
+      #   # ...
+      # in ...
+      #   #...
+      # end
+      # ```
+      class LegalStructure < ModernTreasury::Enum
+        CORPORATION = :corporation
+        LLC = :llc
+        NON_PROFIT = :non_profit
+        PARTNERSHIP = :partnership
+        SOLE_PROPRIETORSHIP = :sole_proprietorship
+        TRUST = :trust
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   #
+        #   def self.values; end
+      end
+
+      class PhoneNumber < ModernTreasury::BaseModel
+        # @!attribute [r] phone_number
+        #
+        #   @return [String, nil]
+        optional :phone_number, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :phone_number
+
+        # @!parse
+        #   # A list of phone numbers in E.164 format.
+        #   #
+        #   # @param phone_number [String]
+        #   #
+        #   def initialize(phone_number: nil, **) = super
+
+        # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+      end
+
+      # @abstract
+      #
+      # The risk rating of the legal entity. One of low, medium, high.
+      #
+      # @example
+      # ```ruby
+      # case risk_rating
+      # in :low
+      #   # ...
+      # in :medium
+      #   # ...
+      # in :high
+      #   # ...
+      # end
+      # ```
+      class RiskRating < ModernTreasury::Enum
+        LOW = :low
+        MEDIUM = :medium
+        HIGH = :high
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   #
+        #   def self.values; end
+      end
+    end
+  end
+end