--- title: Error codes: customer management slug: apis/customer-management/error-codes-customer-management description: Reference common error codes and their descriptions to troubleshoot issues in Cross River's customer management APIs. docTags: createdAt: 2024-08-08T13:29:26.904Z --- ## Overview This page provides comprehensive error code information for the Customer Management API, including error codes, descriptions, and resolution guidance based on actual codebase analysis. ## Error response format ```json { "errors": [ { "code": 1213, "message": "EntityName not allowed for classification" } ] } ``` ## Error codes by category ### Customer classification validation (1200-1225) Validation errors related to customer profile and classification requirements. | Code | Description | Resolution | | -------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **1200** | DateFormed required | Include DateFormed field in the request for business entities | | **1201** | DateFormed cannot be in the future | Provide a DateFormed date that is today or in the past | | **1202** | BirthDate required | Include BirthDate field in the request for individual customers | | **1203** | BirthDate cannot be in the future | Provide a BirthDate that is today or in the past | | **1204** | EntityName required | Include EntityName field for business customers | | **1205** | FirstName not allowed for classification | Remove FirstName field; not applicable to this customer classification | | **1206** | MiddleName not allowed for classification | Remove MiddleName field; not applicable to this customer classification | | **1207** | LastName not allowed for classification | Remove LastName field; not applicable to this customer classification | | **1208** | Prefix not allowed for classification | Remove Prefix field; not applicable to this customer classification | | **1209** | Suffix not allowed for classification | Remove Suffix field; not applicable to this customer classification | | **1210** | PreferredName not allowed for classification | Remove PreferredName field; not applicable to this customer classification | | **1211** | FirstName required | Include FirstName field in the request for individual customers | | **1212** | LastName required | Include LastName field in the request for individual customers | | **1213** | EntityName not allowed for classification | Remove EntityName field; only applicable to business customers | | **1214** | Name required | Include customer name information (FirstName/LastName or EntityName based on classification) | | **1215** | PoliticallyExposedPerson required | Include PoliticallyExposedPerson field for individual customers | | **1216** | PoliticallyExposedPerson not allowed for classification | Remove PoliticallyExposedPerson field; only applicable to individual customers | | **1217** | BirthDate not allowed for classification | Remove BirthDate field; only applicable to individual customers | | **1218** | DateFormed not allowed for classification | Remove DateFormed field; only applicable to business entities | | **1219** | RegO required | Include RegO (Regulation O) status for applicable customers | | **1220** | RegO not allowed for classification | Remove RegO field; not applicable to this customer classification | | **1221** | PrimaryOwnerCustomerId required | Include PrimaryOwnerCustomerId for entity customers | | **1222** | PrimaryOwnerCustomerId not allowed for classification | Remove PrimaryOwnerCustomerId; only applicable to entity customers | | **1223** | EntityType not allowed for classification | Remove EntityType field; not applicable to this customer classification | | **1224** | OwnershipType not allowed for classification | Remove OwnershipType field; not applicable to this customer classification | | **1225** | TaxIdType not allowed for classification | Remove TaxIdType field; not applicable to this customer classification | ### 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 | ### Relationships (2525-2534) Errors related to customer-account relationship management. | Error 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 |