Error codes: Accounts

overview this page provides comprehensive error code information for the accounts api, including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format { "errors" \[ { "code" 2200, "message" "customer not found" } ] } error codes by category accounts (2001 2022) errors related to account operations, status, and opening requirements code description resolution 2001 account not active account must be in active status to perform this operation; check account status 2002 status cannot be set to closed manually accounts close automatically when conditions are met; use proper close account workflow 2003 account not open account must be in open status for this operation; verify account has been opened 2004 account is closed account is permanently closed; operations cannot be performed on closed accounts 2005 account is not closed operation requires account to be in closed status; verify account status 2006 account cannot be closed until active holds removed remove or expire all active holds before closing account 2007 account cannot be closed until active memo posts removed remove all active memo posts before closing account 2008 account cannot be closed until all completed transactions have been applied and balance is zero apply all pending transactions and ensure account balance is $0 00 before closing 2009 account cannot be closed until sub accounts are closed close all sub accounts before closing master account 2010 max total accounts exceeded for product product has reached maximum total account limit; contact administrator 2011 max active accounts exceeded for product product has reached maximum active account limit; close inactive accounts or contact administrator 2012 max daily accounts exceeded for product daily account creation limit reached; retry tomorrow or contact administrator 2013 account already exists account with this identifier already exists; use existing account or create with different parameters 2014 account number cannot be generated system unable to generate account number; retry or contact support 2015 account generation attempts exceeded maximum account number generation attempts reached; contact support 2016 invalid account number prefix account number prefix does not match product configuration; verify product settings 2017 invalid account number length account number length does not match product configuration; verify product settings 2018 customer not assigned to same partner as product ensure customer and product belong to the same partner 2019 customer classification not allowed for product customer classification type is not permitted for this product; verify product configuration 2020 customer must have an address associated add an address to customer profile before opening account 2021 customer must have a phone number associated add a phone number to customer profile before opening account 2022 customer must be cleared for ofac prior to account opening complete ofac screening before opening account sub accounts (2100 2119) errors related to sub account operations and management code description resolution 2100 sub account not found verify the sub account id is correct; check if sub account exists 2101 sub account not active sub account must be in active status for this operation 2102 cannot modify implicit sub account implicit sub accounts are system managed and cannot be manually modified 2103 sub account already exists sub account with this identifier already exists for master account 2104 sub account is closed sub account is permanently closed; operations cannot be performed 2105 sub account is not closed operation requires sub account to be in closed status 2106 master account required provide master account id when creating sub account 2107 master account not open master account must be in open status before creating sub accounts 2108 master account not active master account must be active before creating sub accounts 2109 master account not found verify master account id is correct and account exists 2110 beneficiary required include beneficiary information when creating sub account 2111 sub account total limit has been reached for master account master account has reached maximum total sub account limit 2112 sub accounts are not enabled for product enable sub account functionality in product configuration 2113 sub account number cannot be generated system unable to generate sub account number; retry or contact support 2114 sub account generation attempts exceeded maximum sub account number generation attempts reached 2115 invalid sub account number prefix sub account number prefix does not match product configuration 2116 invalid sub account number length sub account number length does not match product configuration 2117 sub account cannot be closed until all completed transactions have been applied and balance is zero apply all pending transactions and ensure sub account balance is $0 00 2118 sub account daily limit has been reached for master account daily sub account creation limit reached for this master account 2119 sub account active limit has been reached for master account master account has reached maximum active sub account limit customers (2200 2226) errors related to customer profile management and relationships code description resolution 2200 customer not found verify the customer id is correct; check if customer exists using get /customers/{id} docid\ x36ga61ofefcqbnmug0ss 2201 customer not active customer must be in active status for this operation 2202 entity not active entity customer must be active for this operation 2203 address not active address must be in active status; verify address status 2204 cannot remove primary address mark a different address as primary before removing this address 2205 dateformed required include dateformed field for business entities 2206 dateformed cannot be in the future provide a dateformed date that is today or in the past 2207 birthdate required include birthdate field for individual customers 2208 birthdate cannot be in the future provide a birthdate that is today or in the past 2209 primary owner customer not found verify primary owner customer id is correct and customer exists 2210 primary owner customer not active primary owner customer must be active 2211 primary owner customer must be a person primary owner must be an individual customer, not a business entity 2212 entity and primary owner must be under same partner ensure entity and primary owner are both associated with the same partner 2213 entity and primary owner must be different customers primary owner cannot be the same as the entity customer 2214 entity customer must be a business entity classification requires business customer type 2215 owner customer not found verify owner customer id is correct and customer exists 2216 owner customer not active owner customer must be active 2217 owner customer must be a person owner must be an individual customer, not a business entity 2218 entity and owner customers must be under same partner ensure entity and owner are both associated with the same partner 2219 entity and owner must be different customers owner cannot be the same as the entity customer 2220 owner relationship already exists for entity customer this owner relationship already exists; cannot create duplicate 2221 unable to deactivate customer due to established account relationship(s) remove or deactivate all account relationships before deactivating customer 2222 partner not found or is inactive verify partner id is correct and partner is active 2223 an active customer with this tax id already exists for partner active customer with this tax id already exists; use existing customer or provide different tax id 2224 cannot remove primary identification mark a different identification as primary before removing this one 2225 cannot remove primary phone mark a different phone number as primary before removing this one 2226 invalid customer entity type provide a valid customer entity type holds (2350 2353) errors related to account hold management code description resolution 2350 hold not found verify the hold id is correct; check if hold exists 2351 hold is inactive hold must be active for this operation; verify hold status 2352 invalid hold amount provide a valid hold amount (must be positive number) 2353 expiration date cannot be in the past provide an expiration date that is today or in the future restrictions (2375 2386) errors related to account restriction policies and management code description resolution 2375 restriction not found verify the restriction id is correct; check if restriction exists 2376 restriction not active restriction must be active for this operation 2377 restriction policy in request must match restriction policy associated with change ensure restriction policy id matches the policy being modified 2378 restriction policy approval requires dual control have a second authorized user approve the restriction policy change 2379 restriction policy not found verify the restriction policy id is correct and policy exists 2380 restriction policy not active restriction policy must be active for this operation 2381 restriction policy max restrictions exceeded policy has reached maximum number of allowed restrictions 2382 restriction policy name already exists restriction policy with this name already exists; use different name 2383 pending restriction policy change with name already exists a pending change with this policy name already exists 2384 restriction already inactive restriction is already in inactive status 2385 restriction policy change not approved policy change must be approved before applying 2386 restriction policy change not pending operation requires policy change to be in pending status interest accrual (2425 2428) errors related to interest accrual calculations and postings code description resolution 2425 interest accrual not found verify the interest accrual id is correct; check if record exists 2426 start date must be before end date ensure start date is earlier than end date 2427 amount must be greater than or equal to zero provide a non negative amount value 2428 payments not equal to zero must be posted to core post non zero payment amounts to core before completing operation memo posts (2450 2452) errors related to memo post operations code description resolution 2450 memo post not found verify the memo post id is correct; check if memo post exists 2451 memo post not active memo post must be active for this operation 2452 transactioncode is invalid provide a valid transaction code from the allowed list products (2475 2488) errors related to product configuration and management code description resolution 2475 product not found verify the product id is correct and product exists 2476 product not active product must be active for this operation 2477 product change not approved product change must be approved before applying 2478 product change not pending operation requires product change to be in pending status 2479 product in request must match product associated with change ensure product id matches the product being modified 2480 classification not allowed for product type customer classification is not permitted for this product type 2481 product type invalid provide a valid product type 2482 product name already exists product with this name already exists; use different name 2483 unknown account type for product account type specified is not recognized; verify product configuration 2484 pending product change with name already exists a pending change with this product name already exists 2485 interest accrual not allowed for account type interest accrual is not supported for this account type 2487 statements not allowed for account type statement generation is not supported for this account type 2488 product change approval requires dual control have a second authorized user approve the product change relationships (2525 2534) errors related to customer account relationship management code description resolution 2525 relationship not found verify the relationship id is correct; check if relationship exists 2526 relationship not active relationship must be active for this operation 2527 primary relationship cannot be removed mark a different relationship as primary before removing this one 2528 relationship not allowed for account type this relationship type is not permitted for this account type 2529 relationshiptype not allowed for account classification this relationship type is not permitted for this account classification 2530 istaxreportingowner cannot be enabled for relationship type tax reporting owner flag is not supported for this relationship type 2531 customer must be classified as a person this operation requires an individual customer, not a business entity 2532 customer relationship already exists relationship between this customer and account already exists 2533 customer must be under same partner as account ensure customer and account belong to the same partner 2534 customer must be cleared for ofac prior to creating relationship complete ofac screening before creating account relationship settlements (2550 2554) errors related to daily settlement processing code description resolution 2550 settlement not found verify the settlement id is correct; check if settlement record exists 2551 daily settlement must be pending operation requires settlement to be in pending status 2552 daily settlement must not be complete operation cannot be performed on completed settlements 2553 daily settlement must be pre settling and all interest must be processed ensure settlement is in pre settling status and interest processing is complete 2554 all accounts must be settled before daily settlement can be completed complete settlement for all accounts before finalizing daily settlement snapshots (2575 2577) errors related to account snapshot operations code description resolution 2575 snapshot not found verify the snapshot id is correct; check if snapshot exists 2576 snapshot account number does not match ensure snapshot account number matches the account being queried 2577 snapshot partner does not match ensure snapshot partner id matches the partner context statements (2600 2604) errors related to account statement generation and management code description resolution 2600 statement not found verify the statement id is correct; check if statement exists 2601 statement not completed operation requires statement to be in completed status 2602 statement is closed statement is closed; operations cannot be performed 2603 accountnumber must match statement ensure account number matches the statement being accessed 2604 unable to generate statement for account type statement generation is not supported for this account type transactions (2625 2650) errors related to transaction processing and management code description resolution 2625 transaction not found verify the transaction id is correct 2626 debit account not found verify debit account number is correct and account exists 2627 debit account not active debit account must be active for this transaction 2628 credit account not found verify credit account number is correct and account exists 2629 credit account not active credit account must be active for this transaction 2630 debit and credit accounts must be different provide different account numbers for debit and credit 2631 debit account type not allowed this account type cannot be used as debit account for this transaction 2632 credit account type not allowed this account type cannot be used as credit account for this transaction 2633 general ledger transfers require auto approval permission user must have gl transfer auto approval permission 2634 transaction must be pending operation requires transaction to be in pending status 2635 transaction not effective transaction has not reached effective date 2636 transaction must be under review operation requires transaction to be in under review status 2637 transaction authorization not found verify transaction authorization exists 2638 transaction approval requires dual control have a second authorized user approve the transaction 2639 invalid transaction status provide a valid transaction status value 2640 partnerid not accessible user does not have access to this partner 2641 partnerid is required for user type include partner id in request for this user type 2642 transactioncode is invalid provide a valid transaction code from the allowed list 2643 max transaction flags exceeded maximum number of transaction flags reached 2644 invalid transaction flag provide valid transaction flag values 2645 transaction flags not allowed transaction flags are not permitted for this transaction type 2646 transaction filter required include transaction filter criteria in request 2647 transaction trace number required include transaction trace number in request 2648 transaction proposal required include transaction proposal data in request 2649 transaction amount must be greater than zero provide a transaction amount greater than $0 00 2650 transaction auth status invalid provide a valid transaction authorization status accounting export (2700) errors related to accounting export operations code description resolution 2700 accounting export is not processing accounting export must be in processing status for this operation