--- title: Error codes: Accounts slug: apis/accounts/error-codes-accounts description: Reference common error codes and their descriptions to troubleshoot issues in Cross River's account APIs. docTags: createdAt: 2024-08-08T13:29:26.904Z --- ## 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 ```json { "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 |