increase 1.362.0 → 1.364.0

data/lib/increase/models/checkbook_create_params.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Increase
+  module Models
+    # @see Increase::Resources::Checkbooks#create
+    class CheckbookCreateParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      # @!attribute account_number_id
+      #   The identifier of the Account Number that the checks will draw from. The Account
+      #   Number must be active.
+      #
+      #   @return [String]
+      required :account_number_id, String
+
+      # @!attribute mailing_address
+      #   The destination address that the Checkbook will be mailed to.
+      #
+      #   @return [Increase::Models::CheckbookCreateParams::MailingAddress]
+      required :mailing_address, -> { Increase::CheckbookCreateParams::MailingAddress }
+
+      # @!attribute payer
+      #   The payer of the checks. This will be printed on the top-left corner of each
+      #   check. This should be an array of up to 4 elements, each of which represents a
+      #   line of the payer.
+      #
+      #   @return [Array<Increase::Models::CheckbookCreateParams::Payer>]
+      required :payer, -> { Increase::Internal::Type::ArrayOf[Increase::CheckbookCreateParams::Payer] }
+
+      # @!method initialize(account_number_id:, mailing_address:, payer:, request_options: {})
+      #   @param account_number_id [String]
+      #     The identifier of the Account Number that the checks will draw from. The Account
+      #     Number must be active.
+      #
+      #   @param mailing_address [Increase::Models::CheckbookCreateParams::MailingAddress]
+      #     The destination address that the Checkbook will be mailed to.
+      #
+      #   @param payer [Array<Increase::Models::CheckbookCreateParams::Payer>]
+      #     The payer of the checks. This will be printed on the top-left corner of each
+      #     check. This should be an array of up to 4 elements, each of which represents a
+      #     line of the payer.
+      #
+      #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
+
+      class MailingAddress < Increase::Internal::Type::BaseModel
+        # @!attribute city
+        #   The city of the destination address.
+        #
+        #   @return [String]
+        required :city, String
+
+        # @!attribute line1
+        #   The first line of the destination address.
+        #
+        #   @return [String]
+        required :line1, String
+
+        # @!attribute name
+        #   The recipient at the destination address.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute postal_code
+        #   The postal code of the destination address.
+        #
+        #   @return [String]
+        required :postal_code, String
+
+        # @!attribute state
+        #   The US state of the destination address.
+        #
+        #   @return [String]
+        required :state, String
+
+        # @!attribute line2
+        #   The second line of the destination address.
+        #
+        #   @return [String, nil]
+        optional :line2, String
+
+        # @!method initialize(city:, line1:, name:, postal_code:, state:, line2: nil)
+        #   The destination address that the Checkbook will be mailed to.
+        #
+        #   @param city [String] The city of the destination address.
+        #
+        #   @param line1 [String] The first line of the destination address.
+        #
+        #   @param name [String] The recipient at the destination address.
+        #
+        #   @param postal_code [String] The postal code of the destination address.
+        #
+        #   @param state [String] The US state of the destination address.
+        #
+        #   @param line2 [String] The second line of the destination address.
+      end
+
+      class Payer < Increase::Internal::Type::BaseModel
+        # @!attribute contents
+        #   The contents of the line.
+        #
+        #   @return [String]
+        required :contents, String
+
+        # @!method initialize(contents:)
+        #   @param contents [String] The contents of the line.
+      end
+    end
+  end
+end

data/lib/increase/models/checkbook_list_params.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Increase
+  module Models
+    # @see Increase::Resources::Checkbooks#list
+    class CheckbookListParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      # @!attribute account_number_id
+      #   Filter Checkbooks to those attached to the specified Account Number.
+      #
+      #   @return [String, nil]
+      optional :account_number_id, String
+
+      # @!attribute cursor
+      #   Return the page of entries after this one.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute idempotency_key
+      #   Filter records to the one with the specified `idempotency_key` you chose for
+      #   that object. This value is unique across Increase and is used to ensure that a
+      #   request is only processed once. Learn more about
+      #   [idempotency](https://increase.com/documentation/idempotency-keys).
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute limit
+      #   Limit the size of the list that is returned. The default (and maximum) is 100
+      #   objects.
+      #
+      #   Defaults to `100`.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute status
+      #
+      #   @return [Increase::Models::CheckbookListParams::Status, nil]
+      optional :status, -> { Increase::CheckbookListParams::Status }
+
+      # @!method initialize(account_number_id: nil, cursor: nil, idempotency_key: nil, limit: nil, status: nil, request_options: {})
+      #   @param account_number_id [String] Filter Checkbooks to those attached to the specified Account Number.
+      #
+      #   @param cursor [String] Return the page of entries after this one.
+      #
+      #   @param idempotency_key [String]
+      #     Filter records to the one with the specified `idempotency_key` you chose for
+      #     that object. This value is unique across Increase and is used to ensure that a
+      #     request is only processed once. Learn more about
+      #     [idempotency](https://increase.com/documentation/idempotency-keys).
+      #
+      #   @param limit [Integer]
+      #     Limit the size of the list that is returned. The default (and maximum) is 100
+      #     objects.
+      #
+      #     Defaults to `100`.
+      #
+      #   @param status [Increase::Models::CheckbookListParams::Status]
+      #
+      #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
+
+      class Status < Increase::Internal::Type::BaseModel
+        # @!attribute in_
+        #   Filter Checkbooks for those with the specified status or statuses. For GET
+        #   requests, this should be encoded as a comma-delimited string, such as
+        #   `?in=one,two,three`.
+        #
+        #   @return [Array<Symbol, Increase::Models::CheckbookListParams::Status::In>, nil]
+        optional :in_,
+                 -> { Increase::Internal::Type::ArrayOf[enum: Increase::CheckbookListParams::Status::In] },
+                 api_name: :in
+
+        # @!method initialize(in_: nil)
+        #   @param in_ [Array<Symbol, Increase::Models::CheckbookListParams::Status::In>]
+        #     Filter Checkbooks for those with the specified status or statuses. For GET
+        #     requests, this should be encoded as a comma-delimited string, such as
+        #     `?in=one,two,three`.
+
+        module In
+          extend Increase::Internal::Type::Enum
+
+          # The Checkbook is pending submission to the printer.
+          PENDING_SUBMISSION = :pending_submission
+
+          # The Checkbook has been submitted to the printer and is pending mailing.
+          PENDING_MAILING = :pending_mailing
+
+          # The Checkbook has been mailed.
+          MAILED = :mailed
+
+          # The Checkbook has been stopped and its checks can no longer be deposited.
+          STOPPED = :stopped
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/increase/models/checkbook_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Increase
+  module Models
+    # @see Increase::Resources::Checkbooks#retrieve
+    class CheckbookRetrieveParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      # @!attribute checkbook_id
+      #   The identifier of the Checkbook.
+      #
+      #   @return [String]
+      required :checkbook_id, String
+
+      # @!method initialize(checkbook_id:, request_options: {})
+      #   @param checkbook_id [String] The identifier of the Checkbook.
+      #
+      #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/increase/models/checkbook_stop_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Increase
+  module Models
+    # @see Increase::Resources::Checkbooks#stop
+    class CheckbookStopParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      # @!attribute checkbook_id
+      #   The identifier of the Checkbook to stop.
+      #
+      #   @return [String]
+      required :checkbook_id, String
+
+      # @!method initialize(checkbook_id:, request_options: {})
+      #   @param checkbook_id [String] The identifier of the Checkbook to stop.
+      #
+      #   @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/increase/models/declined_transaction.rb

@@ -2166,6 +2166,12 @@ module Increase
           #   @return [String, nil]
           required :check_transfer_id, String, nil?: true
 
+          # @!attribute checkbook_check_id
+          #   The identifier of the Checkbook Check object associated with this decline.
+          #
+          #   @return [String, nil]
+          required :checkbook_check_id, String, nil?: true
+
           # @!attribute front_image_file_id
           #   The identifier of the API File object containing an image of the front of the
           #   declined check.
@@ -2185,7 +2191,7 @@ module Increase
           #   @return [Symbol, Increase::Models::DeclinedTransaction::Source::CheckDecline::Reason]
           required :reason, enum: -> { Increase::DeclinedTransaction::Source::CheckDecline::Reason }
 
-          # @!method initialize(amount:, auxiliary_on_us:, back_image_file_id:, check_transfer_id:, front_image_file_id:, inbound_check_deposit_id:, reason:)
+          # @!method initialize(amount:, auxiliary_on_us:, back_image_file_id:, check_transfer_id:, checkbook_check_id:, front_image_file_id:, inbound_check_deposit_id:, reason:)
           #   A Check Decline object. This field will be present in the JSON response if and
           #   only if `category` is equal to `check_decline`.
           #
@@ -2203,6 +2209,9 @@ module Increase
           #   @param check_transfer_id [String, nil]
           #     The identifier of the Check Transfer object associated with this decline.
           #
+          #   @param checkbook_check_id [String, nil]
+          #     The identifier of the Checkbook Check object associated with this decline.
+          #
           #   @param front_image_file_id [String, nil]
           #     The identifier of the API File object containing an image of the front of the
           #     declined check.

data/lib/increase/models/entity.rb

@@ -31,12 +31,6 @@ module Increase
       #   @return [String, nil]
       required :creating_entity_onboarding_session_id, String, nil?: true
 
-      # @!attribute description
-      #   The entity's description for display purposes.
-      #
-      #   @return [String, nil]
-      required :description, String, nil?: true
-
       # @!attribute details_confirmed_at
       #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the
       #   Entity's details were most recently confirmed.
@@ -72,13 +66,6 @@ module Increase
       #   @return [Increase::Models::Entity::NaturalPerson, nil]
       required :natural_person, -> { Increase::Entity::NaturalPerson }, nil?: true
 
-      # @!attribute risk_rating
-      #   An assessment of the entity’s potential risk of involvement in financial crimes,
-      #   such as money laundering.
-      #
-      #   @return [Increase::Models::Entity::RiskRating, nil]
-      required :risk_rating, -> { Increase::Entity::RiskRating }, nil?: true
-
       # @!attribute sole_proprietorship
       #   Details of the sole proprietorship entity. Will be present if `structure` is
       #   equal to `sole_proprietorship`.
@@ -142,7 +129,7 @@ module Increase
       #   @return [Increase::Models::Entity::Validation, nil]
       required :validation, -> { Increase::Entity::Validation }, nil?: true
 
-      # @!method initialize(id:, corporation:, created_at:, creating_entity_onboarding_session_id:, description:, details_confirmed_at:, government_authority:, idempotency_key:, joint:, natural_person:, risk_rating:, sole_proprietorship:, status:, structure:, supplemental_documents:, terms_agreements:, third_party_verification:, trust:, type:, validation:)
+      # @!method initialize(id:, corporation:, created_at:, creating_entity_onboarding_session_id:, details_confirmed_at:, government_authority:, idempotency_key:, joint:, natural_person:, sole_proprietorship:, status:, structure:, supplemental_documents:, terms_agreements:, third_party_verification:, trust:, type:, validation:)
       #   Entities are the legal entities that own accounts. They can be people,
       #   corporations, joint accounts, trusts, or government authorities. To learn more,
       #   see [Entities](/documentation/entities).
@@ -161,8 +148,6 @@ module Increase
       #     The identifier of the Entity Onboarding Session that was used to create this
       #     Entity, if any.
       #
-      #   @param description [String, nil] The entity's description for display purposes.
-      #
       #   @param details_confirmed_at [Time, nil]
       #     The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the
       #     Entity's details were most recently confirmed.
@@ -183,10 +168,6 @@ module Increase
       #     Details of the natural person entity. Will be present if `structure` is equal to
       #     `natural_person`.
       #
-      #   @param risk_rating [Increase::Models::Entity::RiskRating, nil]
-      #     An assessment of the entity’s potential risk of involvement in financial crimes,
-      #     such as money laundering.
-      #
       #   @param sole_proprietorship [Increase::Models::Entity::SoleProprietorship, nil]
       #     Details of the sole proprietorship entity. Will be present if `structure` is
       #     equal to `sole_proprietorship`.
@@ -1129,51 +1110,6 @@ module Increase
         end
       end
 
-      # @see Increase::Models::Entity#risk_rating
-      class RiskRating < Increase::Internal::Type::BaseModel
-        # @!attribute rated_at
-        #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #   rating was performed.
-        #
-        #   @return [Time]
-        required :rated_at, Time
-
-        # @!attribute rating
-        #   The rating given to this entity.
-        #
-        #   @return [Symbol, Increase::Models::Entity::RiskRating::Rating]
-        required :rating, enum: -> { Increase::Entity::RiskRating::Rating }
-
-        # @!method initialize(rated_at:, rating:)
-        #   An assessment of the entity’s potential risk of involvement in financial crimes,
-        #   such as money laundering.
-        #
-        #   @param rated_at [Time]
-        #     The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #     rating was performed.
-        #
-        #   @param rating [Symbol, Increase::Models::Entity::RiskRating::Rating] The rating given to this entity.
-
-        # The rating given to this entity.
-        #
-        # @see Increase::Models::Entity::RiskRating#rating
-        module Rating
-          extend Increase::Internal::Type::Enum
-
-          # Minimal risk of involvement in financial crime.
-          LOW = :low
-
-          # Moderate risk of involvement in financial crime.
-          MEDIUM = :medium
-
-          # Elevated risk of involvement in financial crime.
-          HIGH = :high
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-
       # @see Increase::Models::Entity#sole_proprietorship
       class SoleProprietorship < Increase::Internal::Type::BaseModel
         # @!attribute address

data/lib/increase/models/entity_create_params.rb

@@ -20,12 +20,6 @@ module Increase
       #   @return [Increase::Models::EntityCreateParams::Corporation, nil]
       optional :corporation, -> { Increase::EntityCreateParams::Corporation }
 
-      # @!attribute description
-      #   The description you choose to give the entity.
-      #
-      #   @return [String, nil]
-      optional :description, String
-
       # @!attribute government_authority
       #   Details of the Government Authority entity to create. Required if `structure` is
       #   equal to `government_authority`.
@@ -49,13 +43,6 @@ module Increase
       #   @return [Increase::Models::EntityCreateParams::NaturalPerson, nil]
       optional :natural_person, -> { Increase::EntityCreateParams::NaturalPerson }
 
-      # @!attribute risk_rating
-      #   An assessment of the entity's potential risk of involvement in financial crimes,
-      #   such as money laundering.
-      #
-      #   @return [Increase::Models::EntityCreateParams::RiskRating, nil]
-      optional :risk_rating, -> { Increase::EntityCreateParams::RiskRating }
-
       # @!attribute sole_proprietorship
       #   Details of the sole proprietorship entity to create. Required if `structure` is
       #   equal to `sole_proprietorship`.
@@ -93,15 +80,13 @@ module Increase
       #   @return [Increase::Models::EntityCreateParams::Trust, nil]
       optional :trust, -> { Increase::EntityCreateParams::Trust }
 
-      # @!method initialize(structure:, corporation: nil, description: nil, government_authority: nil, joint: nil, natural_person: nil, risk_rating: nil, sole_proprietorship: nil, supplemental_documents: nil, terms_agreements: nil, third_party_verification: nil, trust: nil, request_options: {})
+      # @!method initialize(structure:, corporation: nil, government_authority: nil, joint: nil, natural_person: nil, sole_proprietorship: nil, supplemental_documents: nil, terms_agreements: nil, third_party_verification: nil, trust: nil, request_options: {})
       #   @param structure [Symbol, Increase::Models::EntityCreateParams::Structure] The type of Entity to create.
       #
       #   @param corporation [Increase::Models::EntityCreateParams::Corporation]
       #     Details of the corporation entity to create. Required if `structure` is equal to
       #     `corporation`.
       #
-      #   @param description [String] The description you choose to give the entity.
-      #
       #   @param government_authority [Increase::Models::EntityCreateParams::GovernmentAuthority]
       #     Details of the Government Authority entity to create. Required if `structure` is
       #     equal to `government_authority`.
@@ -116,10 +101,6 @@ module Increase
       #     `social_security_number` or `individual_taxpayer_identification_number`
       #     identification methods.
       #
-      #   @param risk_rating [Increase::Models::EntityCreateParams::RiskRating]
-      #     An assessment of the entity's potential risk of involvement in financial crimes,
-      #     such as money laundering.
-      #
       #   @param sole_proprietorship [Increase::Models::EntityCreateParams::SoleProprietorship]
       #     Details of the sole proprietorship entity to create. Required if `structure` is
       #     equal to `sole_proprietorship`.
@@ -1675,51 +1656,6 @@ module Increase
         end
       end
 
-      class RiskRating < Increase::Internal::Type::BaseModel
-        # @!attribute rated_at
-        #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #   rating was performed.
-        #
-        #   @return [Time]
-        required :rated_at, Time
-
-        # @!attribute rating
-        #   The rating given to this entity.
-        #
-        #   @return [Symbol, Increase::Models::EntityCreateParams::RiskRating::Rating]
-        required :rating, enum: -> { Increase::EntityCreateParams::RiskRating::Rating }
-
-        # @!method initialize(rated_at:, rating:)
-        #   An assessment of the entity's potential risk of involvement in financial crimes,
-        #   such as money laundering.
-        #
-        #   @param rated_at [Time]
-        #     The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #     rating was performed.
-        #
-        #   @param rating [Symbol, Increase::Models::EntityCreateParams::RiskRating::Rating]
-        #     The rating given to this entity.
-
-        # The rating given to this entity.
-        #
-        # @see Increase::Models::EntityCreateParams::RiskRating#rating
-        module Rating
-          extend Increase::Internal::Type::Enum
-
-          # Minimal risk of involvement in financial crime.
-          LOW = :low
-
-          # Moderate risk of involvement in financial crime.
-          MEDIUM = :medium
-
-          # Elevated risk of involvement in financial crime.
-          HIGH = :high
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-
       class SoleProprietorship < Increase::Internal::Type::BaseModel
         # @!attribute address
         #   The sole proprietorship's business address. Mail receiving locations like PO

data/lib/increase/models/entity_update_params.rb

@@ -42,13 +42,6 @@ module Increase
       #   @return [Increase::Models::EntityUpdateParams::NaturalPerson, nil]
       optional :natural_person, -> { Increase::EntityUpdateParams::NaturalPerson }
 
-      # @!attribute risk_rating
-      #   An assessment of the entity’s potential risk of involvement in financial crimes,
-      #   such as money laundering.
-      #
-      #   @return [Increase::Models::EntityUpdateParams::RiskRating, nil]
-      optional :risk_rating, -> { Increase::EntityUpdateParams::RiskRating }
-
       # @!attribute sole_proprietorship
       #   Details of the sole proprietorship entity to update. If you specify this
       #   parameter and the entity is not a sole proprietorship, the request will fail.
@@ -79,7 +72,7 @@ module Increase
       #   @return [Increase::Models::EntityUpdateParams::Trust, nil]
       optional :trust, -> { Increase::EntityUpdateParams::Trust }
 
-      # @!method initialize(entity_id:, corporation: nil, details_confirmed_at: nil, government_authority: nil, natural_person: nil, risk_rating: nil, sole_proprietorship: nil, terms_agreements: nil, third_party_verification: nil, trust: nil, request_options: {})
+      # @!method initialize(entity_id:, corporation: nil, details_confirmed_at: nil, government_authority: nil, natural_person: nil, sole_proprietorship: nil, terms_agreements: nil, third_party_verification: nil, trust: nil, request_options: {})
       #   @param entity_id [String] The entity identifier.
       #
       #   @param corporation [Increase::Models::EntityUpdateParams::Corporation]
@@ -99,10 +92,6 @@ module Increase
       #     Details of the natural person entity to update. If you specify this parameter
       #     and the entity is not a natural person, the request will fail.
       #
-      #   @param risk_rating [Increase::Models::EntityUpdateParams::RiskRating]
-      #     An assessment of the entity’s potential risk of involvement in financial crimes,
-      #     such as money laundering.
-      #
       #   @param sole_proprietorship [Increase::Models::EntityUpdateParams::SoleProprietorship]
       #     Details of the sole proprietorship entity to update. If you specify this
       #     parameter and the entity is not a sole proprietorship, the request will fail.
@@ -730,51 +719,6 @@ module Increase
         end
       end
 
-      class RiskRating < Increase::Internal::Type::BaseModel
-        # @!attribute rated_at
-        #   The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #   rating was performed.
-        #
-        #   @return [Time]
-        required :rated_at, Time
-
-        # @!attribute rating
-        #   The rating given to this entity.
-        #
-        #   @return [Symbol, Increase::Models::EntityUpdateParams::RiskRating::Rating]
-        required :rating, enum: -> { Increase::EntityUpdateParams::RiskRating::Rating }
-
-        # @!method initialize(rated_at:, rating:)
-        #   An assessment of the entity’s potential risk of involvement in financial crimes,
-        #   such as money laundering.
-        #
-        #   @param rated_at [Time]
-        #     The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the risk
-        #     rating was performed.
-        #
-        #   @param rating [Symbol, Increase::Models::EntityUpdateParams::RiskRating::Rating]
-        #     The rating given to this entity.
-
-        # The rating given to this entity.
-        #
-        # @see Increase::Models::EntityUpdateParams::RiskRating#rating
-        module Rating
-          extend Increase::Internal::Type::Enum
-
-          # Minimal risk of involvement in financial crime.
-          LOW = :low
-
-          # Moderate risk of involvement in financial crime.
-          MEDIUM = :medium
-
-          # Elevated risk of involvement in financial crime.
-          HIGH = :high
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-
       class SoleProprietorship < Increase::Internal::Type::BaseModel
         # @!attribute address
         #   The sole proprietorship's business address. Mail receiving locations like PO

data/lib/increase/models/export.rb

@@ -535,13 +535,24 @@ module Increase
         #   @return [Increase::Models::Export::FeeCsv::CreatedAt, nil]
         required :created_at, -> { Increase::Export::FeeCsv::CreatedAt }, nil?: true
 
-        # @!method initialize(created_at:)
+        # @!attribute fee_statement_period_start
+        #   Filter fees by the UTC start date of their fee statement's period, such as
+        #   `2026-08-01`.
+        #
+        #   @return [Date, nil]
+        required :fee_statement_period_start, Date, nil?: true
+
+        # @!method initialize(created_at:, fee_statement_period_start:)
         #   Details of the fee CSV export. This field will be present when the `category` is
         #   equal to `fee_csv`.
         #
         #   @param created_at [Increase::Models::Export::FeeCsv::CreatedAt, nil]
         #     Filter fees by their created date. The time range must not include any fees on
         #     an open fee statement.
+        #
+        #   @param fee_statement_period_start [Date, nil]
+        #     Filter fees by the UTC start date of their fee statement's period, such as
+        #     `2026-08-01`.
 
         # @see Increase::Models::Export::FeeCsv#created_at
         class CreatedAt < Increase::Internal::Type::BaseModel

data/lib/increase/models/export_create_params.rb

@@ -359,22 +359,41 @@ module Increase
 
       class FeeCsv < Increase::Internal::Type::BaseModel
         # @!attribute created_at
-        #   Filter results by time range on the `created_at` attribute.
+        #   Filter exported Fees by the time they were created. This suits historical
+        #   exports across many fee statements. To get all of the Fees for a given fee
+        #   statement period, we recommend using `fee_statement_period_start` instead. The
+        #   time range must not include any Fees on an open fee statement.
         #
         #   @return [Increase::Models::ExportCreateParams::FeeCsv::CreatedAt, nil]
         optional :created_at, -> { Increase::ExportCreateParams::FeeCsv::CreatedAt }
 
+        # @!attribute fee_statement_period_start
+        #   Filter exported Fees to the fee statements whose period starts on this UTC date,
+        #   such as `2026-08-01`. Use this filter to export all of the Fees on a fee
+        #   statement. The matching fee statements must be closed.
+        #
+        #   @return [Date, nil]
+        optional :fee_statement_period_start, Date
+
         # @!attribute program_id
         #   Filter exported Fees to the specified Program.
         #
         #   @return [String, nil]
         optional :program_id, String
 
-        # @!method initialize(created_at: nil, program_id: nil)
+        # @!method initialize(created_at: nil, fee_statement_period_start: nil, program_id: nil)
         #   Options for the created export. Required if `category` is equal to `fee_csv`.
         #
         #   @param created_at [Increase::Models::ExportCreateParams::FeeCsv::CreatedAt]
-        #     Filter results by time range on the `created_at` attribute.
+        #     Filter exported Fees by the time they were created. This suits historical
+        #     exports across many fee statements. To get all of the Fees for a given fee
+        #     statement period, we recommend using `fee_statement_period_start` instead. The
+        #     time range must not include any Fees on an open fee statement.
+        #
+        #   @param fee_statement_period_start [Date]
+        #     Filter exported Fees to the fee statements whose period starts on this UTC date,
+        #     such as `2026-08-01`. Use this filter to export all of the Fees on a fee
+        #     statement. The matching fee statements must be closed.
         #
         #   @param program_id [String] Filter exported Fees to the specified Program.
 
@@ -409,7 +428,10 @@ module Increase
           optional :on_or_before, Time
 
           # @!method initialize(after: nil, before: nil, on_or_after: nil, on_or_before: nil)
-          #   Filter results by time range on the `created_at` attribute.
+          #   Filter exported Fees by the time they were created. This suits historical
+          #   exports across many fee statements. To get all of the Fees for a given fee
+          #   statement period, we recommend using `fee_statement_period_start` instead. The
+          #   time range must not include any Fees on an open fee statement.
           #
           #   @param after [Time]
           #     Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)