Midaz error list

The Midaz API returns errors as an RFC 9457 problem details object, served with the application/problem+json content type:

{
   "type": "https://errors.lerian.studio/v1/<error_code>",
   "title": "<error_title>",
   "status": <http_status>,
   "detail": "<error_message>",
   "code": "<error_code>"
}

Field definitions

type: A URI that identifies the error type, built as https://errors.lerian.studio/v1/ followed by the error code.
title: A brief summary of the issue.
status: The HTTP status code of the response.
detail: Detailed guidance for resolving the error. The table below lists this content in the message column.
code: A unique, stable identifier for the error.
entityType: The entity the error relates to (for example, Organization). Only present when applicable.

For server-side errors (HTTP 5xx), title and detail are sanitized to generic values so internal causes never leak. Use code and type to identify the error.

Field-level error details For issues specific to individual fields, an errors array lists each field with its problem. Examples:

{
   "type": "https://errors.lerian.studio/v1/0009",
   "title": "Missing Fields in Request",
   "status": 400,
   "detail": "Your request is missing one or more required fields: [legalName]. Please refer to the documentation to ensure all necessary fields are included in your request.",
   "code": "0009",
   "entityType": "Organization",
   "errors": [
      { "location": "legalName", "message": "legalName is a required field" }
   ]
}

{
   "type": "https://errors.lerian.studio/v1/0047",
   "title": "Bad Request",
   "status": 400,
   "detail": "The server could not understand the request due to malformed syntax. Please check the listed fields and try again.",
   "code": "0047",
   "errors": [
      { "location": "legalName", "message": "legalName is a required field." },
      { "location": "parentOrganizationId", "message": "parentOrganizationId must be a valid UUID" }
   ]
}

{
   "type": "https://errors.lerian.studio/v1/0053",
   "title": "Unexpected Fields in the Request",
   "status": 400,
   "detail": "The request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.",
   "code": "0053",
   "errors": [
      { "location": "unknownField", "message": "unexpected field", "value": "..." }
   ]
}

Midaz errors

Refer to the following table for error codes and their descriptions:

`code`	`title`	`message`
0001	Duplicate Ledger Error	A ledger with the specified name already exists in this division. Please rename the ledger or choose a different division.
0002	Ledger Name Conflict	A ledger named {{name}} already exists in your organization. Please rename the ledger, or if you want to use the same name, consider creating a new ledger for a different division.
0003	Asset Name or Code Duplicate	An asset with the same name or code already exists in your ledger. Please modify the name or code of your new asset.
0004	Code Uppercase Requirement	The code must be in uppercase. Please ensure that the code is in uppercase format and try again.
0005	Currency Code Standard Compliance	Currency-type assets must comply with the ISO-4217 standard. Please use a currency code that conforms to ISO-4217 guidelines.
0006	Unmodifiable Field Error	Your request includes a field that cannot be modified. Please review your request and try again, removing any uneditable fields.
0007	Entity Not Found	No entity was found for the given ID. Please make sure to use the correct ID for the entity you are trying to manage.
0008	Action Not Permitted	This action is not permitted in the current environment. Contact an administrator if you believe this is an error.
0009	Missing Fields in Request	Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.
0010	Account Type Immutable	The account type specified cannot be modified. Please ensure the correct account type is being used and try again.
0011	Inactive Account Type Error	The account type specified cannot be set to INACTIVE. Please ensure the correct account type is being used and try again.
0012	Account Balance Deletion Error	An account or sub-account cannot be deleted if it has a remaining balance. Please ensure all remaining balances are transferred before attempting to delete.
0013	Resource Already Deleted	The resource you are trying to delete has already been deleted. Ensure you are using the correct ID and try again.
0014	Segment ID Inactive	The segment with ID {{id}} is currently inactive. Please activate the segment before proceeding.
0015	Duplicate Segment Name Error	A segment with the name {{name}} already exists for this ledger ID {{ledgerId}}. Please try again with a different ledger or name.
0017	Invalid Script Format Error	The script provided in your request is invalid or in an unsupported format. Please verify the script format and try again.
0018	Insufficient Funds Error	The transaction could not be completed due to insufficient funds in the account. Please add sufficient funds to your account and try again.
0019	Account Ineligibility Error	One or more accounts listed in the transaction are not eligible to participate. Please review the account statuses and try again.
0020	Alias Unavailability Error	The alias {{alias}} is already in use. Please choose a different alias and try again.
0021	Parent Transaction ID Not Found	The parentTransactionId {{parentTransactionId}} does not correspond to any existing transaction. Please review the ID and try again.
0022	Immutable Field Error	The {{field}} field cannot be modified. Please remove this field from your request and try again.
0023	Transaction Timing Restriction	You can only perform another transaction using {{assetCode}} of {{amount}} from {{source}} to {{destination}} after {{timestampUnlock}}. Please wait until the specified time to try again.
0024	Account Status Transaction Restriction	The current statuses of the source and/or destination accounts do not permit transactions. Change the account status(es) and try again.
0025	Insufficient Account Balance Error	The account {{accountId}} does not have sufficient balance. Please try again with an amount that is less than or equal to the available balance.
0026	Transaction Method Restriction	Transactions involving {{assetCode}} are not permitted for the specified source and/or destination. Please try again using accounts that allow transactions with {{assetCode}}.
0027	Duplicate Transaction Template Code Error	A transaction template with the specified code already exists for your ledger. Please use a different code and try again.
0028	Duplicate Asset Pair Error	A pair for the specified assets already exists. Please update the existing entry instead of creating a new one.
0029	Invalid Parent Account ID	The specified parent account ID does not exist. Please verify the ID is correct and try your request again.
0030	Mismatched Asset Code	The parent account ID is associated with a different asset code than the one specified. Please make sure the asset code matches the parent account.
0031	Chart Type Not Found	The specified chart type does not exist. Please provide a valid chart type and refer to the documentation.
0032	Invalid Country Code	The provided country code in the ‘address.country’ field does not conform to the ISO-3166 alpha-2 standard. Please provide a valid alpha-2 country code.
0033	Invalid Code Format	The ‘code’ field must be alphanumeric, in upper case, and must contain at least one letter. Please provide a valid code.
0034	Asset Code Not Found	The provided asset code does not exist in our records. Please verify the asset code and try again.
0035	Portfolio ID Not Found	The provided portfolio ID does not exist in our records. Please verify the portfolio ID and try again.
0036	Segment ID Not Found	The provided segment ID does not exist in our records. Please verify the segment ID and try again.
0037	Ledger ID Not Found	The provided ledger ID does not exist in our records. Please verify the ledger ID and try again.
0038	Organization ID Not Found	The provided organization ID does not exist in our records. Please verify the organization ID and try again.
0039	Parent Organization ID Not Found	The provided parent organization ID does not exist in our records. Please verify the parent organization ID and try again.
0040	Invalid Type	The provided ‘type’ is not valid. Accepted types are currency, fiat, crypto, commodity, or others. Please provide a valid type.
0041	Token Missing	A valid token must be provided in the request header. Please include a token and try again.
0042	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.
0043	Insufficient Privileges	You do not have the necessary permissions to perform this action. Please contact your administrator if you believe this is an error.
0044	Permission Enforcement Error	The enforcer is not configured properly. Please contact your administrator if you believe this is an error.
0045	JWK Fetch Error	The JWK keys could not be fetched from the source. Please verify the source environment variable configuration and try again.
0046	Internal Server Error	The server encountered an unexpected error. Please try again later or contact support.
0047	Bad Request	The server could not understand the request due to malformed syntax. Please check the listed fields and try again.
0048	Invalid DSL File Format	The submitted DSL file is in an incorrect format. Please ensure that the file follows the expected structure and syntax.
0049	Empty DSL File	The submitted DSL file is empty. Please provide a valid file with content.
0050	Metadata Key Length Exceeded	The metadata key {{key}} exceeds the maximum allowed length. Please use a shorter key.
0051	Metadata Value Length Exceeded	The metadata value {{key}} exceeds the maximum allowed length. Please use a shorter value.
0052	Account ID Not Found	The provided account ID does not exist in our records. Please verify the account ID and try again.
0053	Unexpected Fields in the Request	The request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.
0054	IDs Not Found for Accounts	No accounts were found for the provided IDs. Please verify the IDs and try again.
0055	Asset ID Not Found	The specified asset ID does not exist in the provided ledger. Please verify the asset ID and try again.
0056	No Assets Found	No assets were found for the specified ledger. Please create an asset or verify the ledger exists.
0057	No Segments Found	No segments were found for the specified ledger. Please create a segment or verify the ledger exists.
0058	No Portfolios Found	No portfolios were found for the specified ledger. Please create a portfolio or verify the ledger exists.
0059	No Organizations Found	No organizations were found in the search. Please review the search criteria and try again.
0060	No Ledgers Found	No ledgers were found in the search. Please review the search criteria and try again.
0061	Balance Update Failed	The balance could not be updated for the specified account ID. Please verify the account ID and try again.
0062	No Account IDs Provided	No account IDs were provided for the balance update. Please provide valid account IDs and try again.
0063	Failed To Retrieve Accounts By Aliases	The accounts could not be retrieved using the specified aliases. Please verify the aliases for accuracy and try again.
0064	No Accounts Found	No accounts were found in the search. Please review the search criteria and try again.
0065	Invalid Path Parameter	The provided path parameter {{parameter_name}} is not in the expected format. Please ensure the parameter adheres to the required format and try again.
0066	Invalid Account Type	The provided ‘type’ is not valid. Accepted types are: deposit, savings, loans, marketplace, cerditCard or external. Please provide a valid type.
0067	Invalid Metadata Nesting	The metadata object cannot contain nested values. Please ensure that the value {{value}} is not nested and try again.
0068	Operation ID Not Found	The provided operation ID does not exist in our records. Please verify the operation ID and try again.
0069	No Operations Found	No operations were found for the given query parameters. Please adjust your filters and try again.
0070	Transaction ID Not Found	The provided transaction ID does not exist in our records. Please verify the transaction ID and try again.
0071	No Transactions Found	No transactions were found for the given query parameters. Please adjust your filters and try again.
0072	Invalid Transaction Type	Only one transaction type (amount, share, or remaining) must be specified for each entry. Please review your input and try again.
0073	Transaction Value Mismatch	The values for the source, the destination, or both do not match the specified transaction amount. Please verify the values and try again.
0074	External Account Modification Prohibited	Accounts of type ‘external’ cannot be deleted or modified as they are used for traceability with external systems. Please review your request and ensure operations are only performed on internal accounts.
0075	Audit Record Not Retrieved	The record could not be retrieved for audit. Please verify that the submitted data is correct and try again.
0076	Audit Tree Record Not Found	The record does not exist in the audit tree. Please ensure the audit tree is available and try again.
0077	Invalid Date Format Error	The initialDate, finalDate, or both are in the incorrect format. Please use the yyyy-mm-dd format and try again.
0078	Invalid Final Date Error	The finalDate cannot be earlier than the initialDate. Please verify the dates and try again.
0079	Date Range Exceeds Limit Error	The range between ‘initialDate’ and ‘finalDate’ exceeds the permitted limit of {{limit}} months. Please adjust the dates and try again.
0080	Pagination Limit Exceeded	The pagination limit exceeds the maximum allowed of {{pageLimit}} items per page. Please verify the limit and try again.
0081	Invalid Sort Order	The ‘sort_order’ field must be ‘asc’ or ‘desc’. Please provide a valid sort order and try again.
0082	Invalid Query Parameter	One or more query parameters are in an incorrect format. Please check the following parameters ‘{{parameter}}’ and ensure they meet the required format before trying again.
0083	Invalid Date Range Error	Both ‘initialDate’ and ‘finalDate’ fields are required and must be in the ‘yyyy-mm-dd’ format. Please provide valid dates and try again.
0084	Duplicate Idempotency Key	The idempotency key ‘{{key}}’ is already in use. Please provide a unique key and try again.
0085	Account Alias Not Found	The provided account Alias does not exist in our records. Please verify the account Alias and try again.
0086	Race condition detected	A race condition was detected while processing your request. Please try again
0087	Transaction Revert already exist	Transaction revert already exists. Please try again.
0088	Transaction is already a reversal	Transaction is already a reversal. Please try again
0089	Transaction can’t be reverted	Transaction can’t be reverted. Please try again
0090	Transaction Ambiguous Account	Transaction cannot use the same account in sources and destinations.
0091	ID cannot be used as the parent ID	The provided ID cannot be used as the parent ID. Please choose a different one.
0092	No Balances Found	No balances were found for the given query parameters. Please adjust your filters and try again.
0093	Balance Cannot Be Deleted	Balance cannot be deleted because it still has funds in it or has active operations.
0094	Invalid Request Body	The request body is invalid or could not be parsed. Please check JSON structure and field types.
0095	Message Broker Unavailable	The server encountered an unexpected error while connecting to Message Broker. Please try again later or contact support.
0096	Invalid Account Alias	The alias contains invalid characters. Please verify the alias value and try again.
0097	Overflow Error	The request could not be completed due to an overflow. Please check the values and try again.
0098	Invalid Pending Transaction	External accounts cannot be used for pending transactions in source operations. Please check the accounts and try again.
0099	Transaction Status Invalid	Transaction cannot be reverted because its status is not APPROVED
0100	Operation Route Title Already Exists	An operation route with the specified title already exists. Please use a different title and try again.
0101	Operation Route Not Found	The provided operation route does not exist in our records. Please verify the operation route and try again.
0102	No Operation Routes Found	No operation routes were found for the given query parameters. Please adjust your filters and try again.
0103	Invalid Operation Route Type	The provided operation route type is not valid. Accepted types are ‘source’ or ‘destination’. Please provide a valid operation type.
0104	Missing Operation Routes in Request	Your request must include at least one operation route of each type (debit and credit). Please refer to the documentation to ensure these fields are properly populated.
0105	Transaction Route Not Found	The provided transaction route does not exist in our records. Please verify the transaction route and try again.
0106	No Transaction Routes Found	No transaction routes were found for the given query parameters. Please adjust your filters and try again.
0107	Operation Route Linked to Transaction Routes	The operation route cannot be deleted because it is linked to one or more transaction routes. Please remove the operation route from all transaction routes before attempting to delete it.
0108	Duplicate Account Type Key Value Error	An account type with the specified key value already exists for this organization and ledger. Please use a different key value or update the existing account type.
0109	Account Type Not Found Error	The account type you are trying to access does not exist or has been removed.
0110	No Account Types Found	No account types were found for the specified ledger. Please create an account type or verify the ledger exists.
0111	Invalid Account Rule Type	The provided ‘account.ruleType’ is not valid. Accepted types are ‘alias’ or ‘account_type’. Please provide a valid rule type.
0112	Invalid Account Rule Value	The provided ‘account.validIf’ is not valid. Please provide a string for ‘alias’ or an array of strings for ‘account_type’.
0113	Corrupted Account Rule	The account rule data in the operation route is internally inconsistent (unknown rule type or malformed validIf value). This indicates a data integrity issue — please verify the operation route configuration.
0114	Transaction Route Not Informed	The transaction route is not informed. Please inform the transaction route for this transaction.
0115	Invalid Transaction Route ID	The provided transaction route ID is not a valid UUID format. Please provide a valid UUID for the transaction route.
0116	Accounting Route Count Mismatch	The operation routes count does not match the transaction route cache. Please verify your route configuration.
0117	Accounting Route Not Found	The operation route ID was not found in the transaction route cache. Please verify the route configuration.
0118	Accounting Alias Validation Failed	The operation alias does not match the expected alias defined in the accounting route rule.
0119	Accounting Account Type Validation Failed	The account type does not match any of the expected account types defined in the accounting route rule.
0120	Invalid Characters	The field ‘keyValue’ contains invalid characters. Use only letters, numbers, underscores and hyphens.
0121	Invalid Future Date Error	The transactionDate cannot be a future date. Please provide a valid date.
0122	Invalid Field for Pending Transaction Error	Pending transactions do not support the transactionDate field. To proceed, please remove it from your request.
0123	Duplicated Alias Key Value Error	An account alias with the specified key value already exists for this organization and ledger. Please use a different key value.
0124	Additional Balance Creation Not Allowed	Additional balances are not allowed for external account type.
0125	Invalid Transaction Value	Negative or zero transaction values are not allowed. The send_value must be greater than zero.
0126	Default Balance Not Found	Default balance must be created first for this account.
0127	Account Creation Failed	The account could not be created because the default balance could not be created. Please try again.
0128	Transaction Backup Cache Failed	The server encountered an unexpected error while adding the transaction to the backup cache. Please try again later or contact support.
0129	Transaction Backup Cache Marshal Failed	The server encountered an unexpected error while serializing the transaction for the backup cache. Please try again later or contact support.
0131	Invalid Datetime Format Error	The parameter is in the incorrect format. Please use the correct datetime format and try again.
0132	Metadata Index Already Exists	A metadata index with the same key already exists for this entity. Please use a different key from the existing index.
0133	Metadata Index Not Found	The specified metadata index does not exist. Please verify the index name and try again.
0134	Invalid Metadata Key Format	The metadata key format is invalid. Keys must start with a letter and contain only alphanumeric characters and underscores.
0135	Metadata Index Limit Exceeded	The maximum number of metadata indexes has been reached for this entity. Please delete unused indexes before creating new ones.
0136	Metadata Index Creation Failed	The metadata index could not be created. Please try again later or contact support.
0137	Metadata Index Deletion Forbidden	System indexes cannot be deleted. Please ensure you are deleting a custom metadata index.
0138	Invalid Entity Name	The provided entity name is not valid.
0139	Transaction Backup Cache Retrieval Failed	The transaction could not be retrieved from the backup cache internal function. Please ensure the transaction exists in the cache before processing balances.
0140	Invalid Timestamp	The provided timestamp is invalid. Timestamps cannot be in the future.
0141	No Balance Data at Date	No balance data is available at the specified date.
0142	Missing Required Query Parameter	The required query parameter is missing from the request.
0143	Payload Too Large	The request payload exceeds the maximum allowed size of 64KB.
0144	JSON Nesting Depth Exceeded	The JSON payload exceeds the maximum allowed nesting depth of 10 levels. Please flatten your data structure.
0145	JSON Key Count Exceeded	The JSON payload exceeds the maximum allowed number of keys (100). Please reduce the number of keys in your payload.
0146	Tenant Not Provisioned	The tenant has not been provisioned. Please ensure the tenant is properly configured.
0147	Unknown Settings Field	The settings contain an unknown field. Only known settings fields are allowed.
0148	Invalid Settings Field Type	A settings field has an invalid type. Please verify the expected type for the field.
0149	Settings Field at Root Level	A settings field must be nested under the correct parent key. Please verify the expected structure.
0150	Route Not Bidirectional	The operation route does not allow bidirectional transactions. Only routes with operation type ‘bidirectional’ can be reverted.
0151	Missing Counterpart	The route requires at least one debit and one credit operation (counterpart validation).
0152	Direction Route Mismatch	The operation direction is not compatible with the route operation type.
0153	No Source for Action	The action requires at least one source operation route. Please add a source route for this action.
0154	No Destination for Action	The action requires at least one destination operation route. Please add a destination route for this action.
0155	Invalid Route Action	The action is not a valid route action. Please provide a valid action value.
0157	No Routes for Action	No routes found for the action. Please configure operation routes for this action in the transaction route.
0158	Too Many Operation Routes	The number of operation routes exceeds the maximum allowed. Please reduce the number of operation routes and try again.
0159	Service Suspended	The service is suspended for this tenant.
0160	Tenant Not Found	The specified tenant was not found.
0161	Tenant Service Unavailable	The tenant service is unavailable. Please try again later.
0162	Scenario Not Allowed For Direction	The accounting scenario is not allowed for the specified operation direction.
0163	Reserve Group Incomplete	The reserve group (hold, commit, cancel) must be complete.
0164	Direct Scenario Required	The direct scenario is required when other scenarios are present.
0165	Revert Only Bidirectional	The revert scenario is only allowed for bidirectional operation routes.
0166	Accounting Entry Field Required	A required field is missing in the accounting entry.
0167	Overdraft Limit Exceeded	The transaction would exceed the balance’s configured overdraft limit. Reduce the transaction amount or increase the overdraft limit.
0168	Direct Operation on Internal Balance	A user-initiated operation targeted a balance with internal scope. Internal balances (e.g., overdraft companions) cannot be operated on directly.
0169	Deletion of Internal Balance	A delete request targeted a balance with internal scope. Internal balances are system-managed and cannot be deleted.
0170	Reserved Balance Key	The balance key provided is reserved for system use (e.g., `overdraft`). Please choose a different key.
0171	Invalid Balance Direction	The balance direction provided is not valid. Accepted values are `credit` and `debit`.
0172	Invalid Balance Settings	The balance settings payload failed validation. Check that `overdraftLimit` is present and positive when `overdraftLimitEnabled` is true, and absent when it is false.
0173	Overdraft Limit Below Usage	The new overdraft limit is lower than the current overdraft usage. Repay part of the overdraft or set a higher limit.
0174	Stale Balance Version	The balance version in the request no longer matches the current version. Another transaction mutated the balance — please retry the operation.
0175	Update of Internal Balance	A PATCH request targeted a balance with internal scope. Internal balances are system-managed and cannot be modified through the public API.
0484	Route Not Found	The requested route does not exist. Please verify the HTTP method and path and try again.
0485	Method Not Allowed	The HTTP method is not allowed for the requested route. Please verify the method and try again.
0497	Request Header Fields Too Large	The request header fields are too large. Please reduce the size of the request headers and try again.

Getting started

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Metadata Indexes API

Holders API

Instruments API

Billing Packages API

Packages API

Billing Calculation API

Estimation API

Encryption API

Protection API

Asset Rates API

Error handling

Fees Engine

Midaz error list

Midaz errors

​Midaz errors

Midaz errors