modern_treasury 0.1.0.pre.alpha.15 → 0.1.0.pre.alpha.17

data/lib/modern_treasury/resources/bulk_requests.rb

@@ -5,22 +5,17 @@ module ModernTreasury
     class BulkRequests
       # create bulk_request
       #
-      # @param params [ModernTreasury::Models::BulkRequestCreateParams, Hash{Symbol=>Object}] .
+      # @overload create(action_type:, resource_type:, resources:, metadata: nil, request_options: {})
       #
-      #   @option params [Symbol, ModernTreasury::Models::BulkRequestCreateParams::ActionType] :action_type One of create, or update.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkRequestCreateParams::ResourceType] :resource_type One of payment_order, expected_payment, or ledger_transaction.
-      #
-      #   @option params [Array<ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderAsyncCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::LedgerTransactionCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::TransactionCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::ID, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::TransactionUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::LedgerTransactionUpdateRequestWithID>] :resources An array of objects where each object contains the input params for a single
-      #     `action_type` request on a `resource_type` resource
-      #
-      #   @option params [Hash{Symbol=>String}] :metadata Additional data represented as key-value pairs. Both the key and value must be
-      #     strings.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param action_type [Symbol, ModernTreasury::Models::BulkRequestCreateParams::ActionType]
+      # @param resource_type [Symbol, ModernTreasury::Models::BulkRequestCreateParams::ResourceType]
+      # @param resources [Array<ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderAsyncCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::LedgerTransactionCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::TransactionCreateRequest, ModernTreasury::Models::BulkRequestCreateParams::Resource::ID, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::TransactionUpdateRequestWithID, ModernTreasury::Models::BulkRequestCreateParams::Resource::LedgerTransactionUpdateRequestWithID>]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::BulkRequest]
       #
+      # @see ModernTreasury::Models::BulkRequestCreateParams
       def create(params)
         parsed, options = ModernTreasury::Models::BulkRequestCreateParams.dump_request(params)
         @client.request(
@@ -34,18 +29,18 @@ module ModernTreasury
 
       # get bulk_request
       #
-      # @param id [String] id
+      # @overload retrieve(id, request_options: {})
       #
-      # @param params [ModernTreasury::Models::BulkRequestRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::BulkRequest]
       #
+      # @see ModernTreasury::Models::BulkRequestRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["api/bulk_requests/%0s", id],
+          path: ["api/bulk_requests/%1$s", id],
           model: ModernTreasury::Models::BulkRequest,
           options: params[:request_options]
         )
@@ -53,40 +48,34 @@ module ModernTreasury
 
       # list bulk_requests
       #
-      # @param params [ModernTreasury::Models::BulkRequestListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkRequestListParams::ActionType] :action_type One of create, or update.
-      #
-      #   @option params [String, nil] :after_cursor
+      # @overload list(action_type: nil, after_cursor: nil, metadata: nil, per_page: nil, resource_type: nil, status: nil, request_options: {})
       #
-      #   @option params [Hash{Symbol=>String}] :metadata For example, if you want to query for records with metadata key `Type` and value
-      #     `Loan`, the query would be `metadata%5BType%5D=Loan`. This encodes the query
-      #     parameters.
+      # @param action_type [Symbol, ModernTreasury::Models::BulkRequestListParams::ActionType]
+      # @param after_cursor [String, nil]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param per_page [Integer]
+      # @param resource_type [Symbol, ModernTreasury::Models::BulkRequestListParams::ResourceType]
+      # @param status [Symbol, ModernTreasury::Models::BulkRequestListParams::Status]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [Integer] :per_page
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkRequestListParams::ResourceType] :resource_type One of payment_order, expected_payment, or ledger_transaction.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkRequestListParams::Status] :status One of pending, processing, or completed.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::BulkRequest>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::BulkRequest>]
       #
+      # @see ModernTreasury::Models::BulkRequestListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::BulkRequestListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/bulk_requests",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::BulkRequest,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
       end

data/lib/modern_treasury/resources/bulk_results.rb

@@ -5,18 +5,18 @@ module ModernTreasury
     class BulkResults
       # get bulk_result
       #
-      # @param id [String] id
+      # @overload retrieve(id, request_options: {})
       #
-      # @param params [ModernTreasury::Models::BulkResultRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::BulkResult]
       #
+      # @see ModernTreasury::Models::BulkResultRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["api/bulk_results/%0s", id],
+          path: ["api/bulk_results/%1$s", id],
           model: ModernTreasury::Models::BulkResult,
           options: params[:request_options]
         )
@@ -24,43 +24,35 @@ module ModernTreasury
 
       # list bulk_results
       #
-      # @param params [ModernTreasury::Models::BulkResultListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String, nil] :after_cursor
-      #
-      #   @option params [String] :entity_id Unique identifier for the result entity object.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkResultListParams::EntityType] :entity_type The type of the request that created this result. bulk_request is the only
-      #     supported `request_type`
-      #
-      #   @option params [Integer] :per_page
+      # @overload list(after_cursor: nil, entity_id: nil, entity_type: nil, per_page: nil, request_id: nil, request_type: nil, status: nil, request_options: {})
       #
-      #   @option params [String] :request_id Unique identifier for the request that created this bulk result. This is the ID
-      #     of the bulk request when `request_type` is bulk_request
+      # @param after_cursor [String, nil]
+      # @param entity_id [String]
+      # @param entity_type [Symbol, ModernTreasury::Models::BulkResultListParams::EntityType]
+      # @param per_page [Integer]
+      # @param request_id [String]
+      # @param request_type [Symbol, ModernTreasury::Models::BulkResultListParams::RequestType]
+      # @param status [Symbol, ModernTreasury::Models::BulkResultListParams::Status]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [Symbol, ModernTreasury::Models::BulkResultListParams::RequestType] :request_type The type of the request that created this result. bulk_request is the only
-      #     supported `request_type`
-      #
-      #   @option params [Symbol, ModernTreasury::Models::BulkResultListParams::Status] :status One of successful or failed.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::BulkResult>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::BulkResult>]
       #
+      # @see ModernTreasury::Models::BulkResultListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::BulkResultListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/bulk_results",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::BulkResult,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
       end

data/lib/modern_treasury/resources/connection_legal_entities.rb

@@ -5,18 +5,16 @@ module ModernTreasury
     class ConnectionLegalEntities
       # Create a connection legal entity.
       #
-      # @param params [ModernTreasury::Models::ConnectionLegalEntityCreateParams, Hash{Symbol=>Object}] .
+      # @overload create(connection_id:, legal_entity: nil, legal_entity_id: nil, request_options: {})
       #
-      #   @option params [String] :connection_id The ID of the connection.
-      #
-      #   @option params [ModernTreasury::Models::ConnectionLegalEntityCreateParams::LegalEntity] :legal_entity The legal entity.
-      #
-      #   @option params [String] :legal_entity_id The ID of the legal entity.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param connection_id [String]
+      # @param legal_entity [ModernTreasury::Models::ConnectionLegalEntityCreateParams::LegalEntity]
+      # @param legal_entity_id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::ConnectionLegalEntity]
       #
+      # @see ModernTreasury::Models::ConnectionLegalEntityCreateParams
       def create(params)
         parsed, options = ModernTreasury::Models::ConnectionLegalEntityCreateParams.dump_request(params)
         @client.request(
@@ -30,18 +28,18 @@ module ModernTreasury
 
       # Get details on a single connection legal entity.
       #
-      # @param id [String] The id of an existing connection legal entity.
-      #
-      # @param params [ModernTreasury::Models::ConnectionLegalEntityRetrieveParams, Hash{Symbol=>Object}] .
+      # @overload retrieve(id, request_options: {})
       #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::ConnectionLegalEntity]
       #
+      # @see ModernTreasury::Models::ConnectionLegalEntityRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["api/connection_legal_entities/%0s", id],
+          path: ["api/connection_legal_entities/%1$s", id],
           model: ModernTreasury::Models::ConnectionLegalEntity,
           options: params[:request_options]
         )
@@ -49,21 +47,20 @@ module ModernTreasury
 
       # Update a connection legal entity.
       #
-      # @param id [String] The id of an existing connection legal entity.
+      # @overload update(id, status: nil, request_options: {})
       #
-      # @param params [ModernTreasury::Models::ConnectionLegalEntityUpdateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, ModernTreasury::Models::ConnectionLegalEntityUpdateParams::Status] :status The status of the connection legal entity.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param status [Symbol, ModernTreasury::Models::ConnectionLegalEntityUpdateParams::Status]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::ConnectionLegalEntity]
       #
+      # @see ModernTreasury::Models::ConnectionLegalEntityUpdateParams
       def update(id, params = {})
         parsed, options = ModernTreasury::Models::ConnectionLegalEntityUpdateParams.dump_request(params)
         @client.request(
           method: :patch,
-          path: ["api/connection_legal_entities/%0s", id],
+          path: ["api/connection_legal_entities/%1$s", id],
           body: parsed,
           model: ModernTreasury::Models::ConnectionLegalEntity,
           options: options
@@ -72,36 +69,33 @@ module ModernTreasury
 
       # Get a list of all connection legal entities.
       #
-      # @param params [ModernTreasury::Models::ConnectionLegalEntityListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String, nil] :after_cursor
+      # @overload list(after_cursor: nil, connection_id: nil, legal_entity_id: nil, per_page: nil, status: nil, request_options: {})
       #
-      #   @option params [String] :connection_id
+      # @param after_cursor [String, nil]
+      # @param connection_id [String]
+      # @param legal_entity_id [String]
+      # @param per_page [Integer]
+      # @param status [Symbol, ModernTreasury::Models::ConnectionLegalEntityListParams::Status]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [String] :legal_entity_id
-      #
-      #   @option params [Integer] :per_page
-      #
-      #   @option params [Symbol, ModernTreasury::Models::ConnectionLegalEntityListParams::Status] :status
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::ConnectionLegalEntity>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::ConnectionLegalEntity>]
       #
+      # @see ModernTreasury::Models::ConnectionLegalEntityListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::ConnectionLegalEntityListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/connection_legal_entities",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::ConnectionLegalEntity,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
       end

data/lib/modern_treasury/resources/connections.rb

@@ -5,34 +5,32 @@ module ModernTreasury
     class Connections
       # Get a list of all connections.
       #
-      # @param params [ModernTreasury::Models::ConnectionListParams, Hash{Symbol=>Object}] .
+      # @overload list(after_cursor: nil, entity: nil, per_page: nil, vendor_customer_id: nil, request_options: {})
       #
-      #   @option params [String, nil] :after_cursor
+      # @param after_cursor [String, nil]
+      # @param entity [String]
+      # @param per_page [Integer]
+      # @param vendor_customer_id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [String] :entity A string code representing the vendor (i.e. bank).
-      #
-      #   @option params [Integer] :per_page
-      #
-      #   @option params [String] :vendor_customer_id An identifier assigned by the vendor to your organization.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::Connection>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::Connection>]
       #
+      # @see ModernTreasury::Models::ConnectionListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::ConnectionListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/connections",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::Connection,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
       end

data/lib/modern_treasury/resources/counterparties.rb

@@ -5,37 +5,24 @@ module ModernTreasury
     class Counterparties
       # Create a new counterparty.
       #
-      # @param params [ModernTreasury::Models::CounterpartyCreateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String, nil] :name A human friendly name for this counterparty.
-      #
-      #   @option params [ModernTreasury::Models::CounterpartyCreateParams::Accounting] :accounting
-      #
-      #   @option params [Array<ModernTreasury::Models::CounterpartyCreateParams::Account>] :accounts The accounts for this counterparty.
-      #
-      #   @option params [String, nil] :email The counterparty's email.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::CounterpartyCreateParams::LedgerType] :ledger_type An optional type to auto-sync the counterparty to your ledger. Either `customer`
-      #     or `vendor`.
-      #
-      #   @option params [ModernTreasury::Models::CounterpartyCreateParams::LegalEntity] :legal_entity
-      #
-      #   @option params [String, nil] :legal_entity_id The id of the legal entity.
-      #
-      #   @option params [Hash{Symbol=>String}] :metadata Additional data represented as key-value pairs. Both the key and value must be
-      #     strings.
-      #
-      #   @option params [Boolean] :send_remittance_advice Send an email to the counterparty whenever an associated payment order is sent
-      #     to the bank.
-      #
-      #   @option params [String] :taxpayer_identifier Either a valid SSN or EIN.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::CounterpartyCreateParams::VerificationStatus] :verification_status The verification status of the counterparty.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @overload create(name:, accounting: nil, accounts: nil, email: nil, ledger_type: nil, legal_entity: nil, legal_entity_id: nil, metadata: nil, send_remittance_advice: nil, taxpayer_identifier: nil, verification_status: nil, request_options: {})
+      #
+      # @param name [String, nil]
+      # @param accounting [ModernTreasury::Models::CounterpartyCreateParams::Accounting]
+      # @param accounts [Array<ModernTreasury::Models::CounterpartyCreateParams::Account>]
+      # @param email [String, nil]
+      # @param ledger_type [Symbol, ModernTreasury::Models::CounterpartyCreateParams::LedgerType]
+      # @param legal_entity [ModernTreasury::Models::CounterpartyCreateParams::LegalEntity]
+      # @param legal_entity_id [String, nil]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param send_remittance_advice [Boolean]
+      # @param taxpayer_identifier [String]
+      # @param verification_status [Symbol, ModernTreasury::Models::CounterpartyCreateParams::VerificationStatus]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::Counterparty]
       #
+      # @see ModernTreasury::Models::CounterpartyCreateParams
       def create(params)
         parsed, options = ModernTreasury::Models::CounterpartyCreateParams.dump_request(params)
         @client.request(
@@ -49,18 +36,18 @@ module ModernTreasury
 
       # Get details on a single counterparty.
       #
-      # @param id [String] The id of an existing counterparty.
+      # @overload retrieve(id, request_options: {})
       #
-      # @param params [ModernTreasury::Models::CounterpartyRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::Counterparty]
       #
+      # @see ModernTreasury::Models::CounterpartyRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["api/counterparties/%0s", id],
+          path: ["api/counterparties/%1$s", id],
           model: ModernTreasury::Models::Counterparty,
           options: params[:request_options]
         )
@@ -68,33 +55,25 @@ module ModernTreasury
 
       # Updates a given counterparty with new information.
       #
-      # @param id [String] The id of an existing counterparty.
-      #
-      # @param params [ModernTreasury::Models::CounterpartyUpdateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :email A new email for the counterparty.
-      #
-      #   @option params [String, nil] :legal_entity_id The id of the legal entity.
-      #
-      #   @option params [Hash{Symbol=>String}] :metadata Additional data in the form of key-value pairs. Pairs can be removed by passing
-      #     an empty string or `null` as the value.
-      #
-      #   @option params [String] :name A new name for the counterparty. Will only update if passed.
+      # @overload update(id, email: nil, legal_entity_id: nil, metadata: nil, name: nil, send_remittance_advice: nil, taxpayer_identifier: nil, request_options: {})
       #
-      #   @option params [Boolean] :send_remittance_advice If this is `true`, Modern Treasury will send an email to the counterparty
-      #     whenever an associated payment order is sent to the bank.
-      #
-      #   @option params [String] :taxpayer_identifier Either a valid SSN or EIN.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param email [String]
+      # @param legal_entity_id [String, nil]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param name [String]
+      # @param send_remittance_advice [Boolean]
+      # @param taxpayer_identifier [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::Counterparty]
       #
+      # @see ModernTreasury::Models::CounterpartyUpdateParams
       def update(id, params = {})
         parsed, options = ModernTreasury::Models::CounterpartyUpdateParams.dump_request(params)
         @client.request(
           method: :patch,
-          path: ["api/counterparties/%0s", id],
+          path: ["api/counterparties/%1$s", id],
           body: parsed,
           model: ModernTreasury::Models::Counterparty,
           options: options
@@ -103,39 +82,28 @@ module ModernTreasury
 
       # Get a paginated list of all counterparties.
       #
-      # @param params [ModernTreasury::Models::CounterpartyListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String, nil] :after_cursor
-      #
-      #   @option params [Time] :created_at_lower_bound Used to return counterparties created after some datetime.
-      #
-      #   @option params [Time] :created_at_upper_bound Used to return counterparties created before some datetime.
-      #
-      #   @option params [String] :email Performs a partial string match of the email field. This is also case
-      #     insensitive.
-      #
-      #   @option params [String] :legal_entity_id Filters for counterparties with the given legal entity ID.
-      #
-      #   @option params [Hash{Symbol=>String}] :metadata For example, if you want to query for records with metadata key `Type` and value
-      #     `Loan`, the query would be `metadata%5BType%5D=Loan`. This encodes the query
-      #     parameters.
-      #
-      #   @option params [String] :name Performs a partial string match of the name field. This is also case
-      #     insensitive.
+      # @overload list(after_cursor: nil, created_at_lower_bound: nil, created_at_upper_bound: nil, email: nil, legal_entity_id: nil, metadata: nil, name: nil, per_page: nil, request_options: {})
       #
-      #   @option params [Integer] :per_page
+      # @param after_cursor [String, nil]
+      # @param created_at_lower_bound [Time]
+      # @param created_at_upper_bound [Time]
+      # @param email [String]
+      # @param legal_entity_id [String]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param name [String]
+      # @param per_page [Integer]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::Counterparty>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::Counterparty>]
       #
+      # @see ModernTreasury::Models::CounterpartyListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::CounterpartyListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/counterparties",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::Counterparty,
           options: options
         )
@@ -143,18 +111,18 @@ module ModernTreasury
 
       # Deletes a given counterparty.
       #
-      # @param id [String] The id of an existing counterparty.
-      #
-      # @param params [ModernTreasury::Models::CounterpartyDeleteParams, Hash{Symbol=>Object}] .
+      # @overload delete(id, request_options: {})
       #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
       #
+      # @see ModernTreasury::Models::CounterpartyDeleteParams
       def delete(id, params = {})
         @client.request(
           method: :delete,
-          path: ["api/counterparties/%0s", id],
+          path: ["api/counterparties/%1$s", id],
           model: NilClass,
           options: params[:request_options]
         )
@@ -162,46 +130,32 @@ module ModernTreasury
 
       # Send an email requesting account details.
       #
-      # @param id [String] counterparty id
-      #
-      # @param params [ModernTreasury::Models::CounterpartyCollectAccountParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, ModernTreasury::Models::TransactionDirection] :direction One of `credit` or `debit`. Use `credit` when you want to pay a counterparty.
-      #     Use `debit` when you need to charge a counterparty. This field helps us send a
-      #     more tailored email to your counterparties."
-      #
-      #   @option params [String] :custom_redirect The URL you want your customer to visit upon filling out the form. By default,
-      #     they will be sent to a Modern Treasury landing page. This must be a valid HTTPS
-      #     URL if set.
+      # @overload collect_account(id, direction:, custom_redirect: nil, fields: nil, send_email: nil, request_options: {})
       #
-      #   @option params [Array<Symbol, ModernTreasury::Models::CounterpartyCollectAccountParams::Field>] :fields The list of fields you want on the form. This field is optional and if it is not
-      #     set, will default to [\"nameOnAccount\", \"accountType\", \"accountNumber\",
-      #     \"routingNumber\", \"address\"]. The full list of options is [\"name\",
-      #     \"nameOnAccount\", \"taxpayerIdentifier\", \"accountType\", \"accountNumber\",
-      #     \"routingNumber\", \"address\", \"ibanNumber\", \"swiftCode\"].
-      #
-      #   @option params [Boolean] :send_email By default, Modern Treasury will send an email to your counterparty that
-      #     includes a link to the form they must fill out. However, if you would like to
-      #     send the counterparty the link, you can set this parameter to `false`. The JSON
-      #     body will include the link to the secure Modern Treasury form.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param direction [Symbol, ModernTreasury::Models::TransactionDirection]
+      # @param custom_redirect [String]
+      # @param fields [Array<Symbol, ModernTreasury::Models::CounterpartyCollectAccountParams::Field>]
+      # @param send_email [Boolean]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::CounterpartyCollectAccountResponse]
       #
+      # @see ModernTreasury::Models::CounterpartyCollectAccountParams
       def collect_account(id, params)
         parsed, options = ModernTreasury::Models::CounterpartyCollectAccountParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["api/counterparties/%0s/collect_account", id],
+          path: ["api/counterparties/%1$s/collect_account", id],
           body: parsed,
           model: ModernTreasury::Models::CounterpartyCollectAccountResponse,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
       end