Skip to main content
Account Types in Midaz allow you to systematically classify accounts according to your organization’s financial structure needs. These classifications define the nature and purpose of accounts within your ledger design, enabling proper transaction routing and operational validation across different account categories. Account Types can be customized via the Account Types API to match your specific business requirements and financial workflows, providing the foundation for structured transaction processing while maintaining data integrity.

​
Enabling Account Type validation

In case you want to activate account type validation to a specific ledger, you must configure it in the Onboarding service. This means updating the variable in the .env file of Midaz Onboarding service where you want to use type validation. Your configuration should look like this: 
# List of <organization-id>:<ledger-id> separated by comma
ACCOUNT_TYPE_VALIDATION=

​
Behavior of the type field in Accounts API

When creating an Account, the type field behavior adapts based on the activation of the Account Type Validation feature:
  • Account Type Validation Disabled (Default): The type field is optional and accepts any free-form string.
  • Account Type Validation Enabled: The type field becomes mandatory and must match one of the Account Types previously registered via the Account Types API. If an invalid or non-registered type is submitted, the system will return a validation error.
If your organization is enabling the Account Type Validation feature, we recommend reviewing existing accounts. You may need to either recreate them or retroactively assign the appropriate Account Type to align with your accounting structure.
This dynamic ensures that every account aligns with the formal accounting categories required by your business, strengthening governance and financial reporting.

​
Managing Account Types

You can manage your Account Types exclusively via API.