A list of error codes from the Rize API and what they mean
General Errors
Code | Title | Details |
---|---|---|
1000 | Internal Server | Something went wrong. |
1001 | Page Not Found | The route you're looking for does not exist. |
1002 | Unparseable Date Format | Could not parse date. Please try ISO 8601 calendar date in extended format (YYYY-MM-DD). |
1003 | Missing Request Parameter | At least one parameter is missing. Cannot continue with the request. |
1004 | Unauthorized | Invalid or expired authentication. |
1005 | Invalid Limit Value | The limit parameter value cannot be negative. |
1006 | Invalid Sort Pattern | The sort parameter value must match the field_name_order pattern (example: "email_asc "). |
1007 | Invalid Method Argument | At least one argument is invalid. Cannot continue with the request. |
1008 | Archived Customer | The Customer is archived. Cannot continue with the request. |
1009 | Archived Pool | The Pool is archived. Cannot continue with the request. |
1010 | Inactive Customer | The Customer is not active. Cannot continue with the request. |
1011 | Customer Not In Updatable Status | Customer not in updatable status. Cannot continue with the request. |
Synthetic Account Errors
Code | Title | Detail |
---|---|---|
2000 | Unknown Synthetic Account | Could not find Synthetic Account. |
2001 | Cannot archive Synthetic Account | Synthetic Account could not be archived. |
2002 | Cannot create Synthetic Account | Synthetic Account could not be created. |
2003 | Cannot archive master Synthetic Account | The master Synthetic Account for a Customer cannot be archived. |
2004 | Cannot archive Synthetic Account with balance | A Synthetic Account with a non-zero balance cannot be archived. |
2005 | Cannot archive Synthetic Account with pending Transfer | A Synthetic Account with a pending Transfer cannot be archived. |
2006 | Cannot archive non-general Synthetic Account | Synthetic Accounts must be of the general or the target_yield_account type to bearchived. Please contact your Rize account manager to archive external Synthetic Accounts. |
2007 | Cannot update Synthetic Account | Synthetic Account could not be updated. |
2008 | Cannot update Synthetic Account | A note is required to update Synthetic Accounts. |
2009 | Could not create Synthetic Account | The count of this customer's active synthetic accounts in the general synthetic account category has reached the maximum. |
2010 | Could not create Synthetic Account | This customer already has an active or initiated synthetic account in the external or theplaid_external synthetic account category. |
2011 | Failed to retrieve synthetic accounts | An exception occurred while retrieving synthetic accounts. |
2012 | Malformed Plaid processor token | The Plaid processor token provided is either malformed or unsupported. |
2013 | Could not create Synthetic Account | The unique external account limit for this customer has been reached. |
2014 | Could not create Synthetic Account | An external account has been created too recently. |
2015 | Could not create Synthetic Account | This external account has been associated with this customer too many times. |
2016 | Could not create Synthetic Account | This customer has reached the outbound ACH external account limit |
2017 | Cannot archive Synthetic Account | Synthetic Account must be in 'active' status to archive |
2018 | The synthetic account cannot be used with Pinwheel | Pinwheel jobs can only be created for the master liability synthetic account if it is active and has a type of "general". |
2019 | Synthetic account name is already taken | Synthetic account names must be unique to a pool |
Transfer Related Errors
Code | Title | Detail |
---|---|---|
3000 | Unknown transfer uid | Could not find transfer. Invalid uid. |
3001 | Could not initiate transfer | An exception occurred while creating transfer. |
3002 | Could not initiate transfer | Requested transfer amount in US dollars must be numeric. |
3003 | Could not initiate transfer | Requested transfer amount in US dollars must be greater than 0. |
3004 | Could not initiate transfer | Source has insufficient funds for transfer. |
3005 | Same source and destination accounts | The source and destination accounts are identical. |
3006 | Could not initiate transfer | Requested transfer between the chosen accounts is prohibited. |
3007 | Source or Destination Account is discarded | Transfers to or from a discarded account are not allowed. |
3008 | Source or Destination Account is locked | Transfers to or from a locked account or an account that belongs to a locked customer are prohibited. |
3010 | Customer daily external transfer request maximum has been reached | The maximum number of daily external transfers defined in the Program configuration has been reached. |
3011 | Customer daily external transfer amount has been reached | This transfer request exceeds the customer's daily external transfer US dollar amount limit. |
3012 | Transfer amount exceeds program maximum | This transfer exceeds the maximum dollar amount allowed in the Program configuration. |
3013 | Transfer amount below program minimum | This transfer does not meet the minimum dollar amount required in the Program configuration. |
3014 | Failed to retrieve transfers | An exception occurred while retrieving transfers. |
3015 | Could not initiate transfer | An exception occurred while creating the custodial transfer. |
3016 | Source or Destination Account is inactive | Transfers to or from an account not in 'active' status are prohibited. |
3017 | Transfer amount exceeds program limit | Transfer amount exceeds program config limit for any transfer |
3018 | Transfer amount would exceed the cumulative credit limit | Transfer amount would exceed the cumulative credit amount limit. |
3019 | Invalid usd_transfer_amount value | Requested transfer amount in US dollars cannot have more than 2 decimal places. |
3020 | Transfers are not supported for secondary customers | Transfers are only supported for primary (account-holding) customers. |
3021 | Maximum customer balance has reached | This transfer request would result in the customer's total balance exceeding the configured maximum allowed balance |
Customer-Related Errors
Code | Title | Detail |
---|---|---|
4000 | Could not create customer | An exception occurred while creating a customer. |
4001 | Could not update customer | An exception occurred while updating the customer. |
4002 | Unknown customer | Could not find customer. Invalid customer uid. |
4003 | Locked customer | No activities regarding this customer are allowed at this time. |
4004 | Could not archive customer | An exception occurred while archiving the customer. |
4005 | Could not archive customer | A customer with a non-zero balance cannot be archived. |
4006 | Could not archive customer | A customer with a pending transfer cannot be archived. |
4007 | Could not lock customer | An exception occurred while locking the customer. |
4008 | Could not lock customer | lock_reason must be provided in order to lock the customer. |
4009 | Could not unlock customer | An exception occurred while unlocking the customer. |
4010 | Could not lock customer properly | An exception occurred while locking at least one custodial account that belongs to the customer. Some lock features are in place, such as rejecting ODFI transfer requests, but not all RDFI transfers or debit card transactions will be blocked. |
4011 | Incomplete customer onboarding | The customer must complete the onboarding process or be enrolled in additional product(s) before proceeding. |
4012 | Could not save customer details | An exception occurred when creating or updating customer details. |
4013 | Could not initiate customer verification | An exception occurred while initiating customer verification. |
4014 | Could not initiate customer confirmation | An exception occurred while initiating customer confirmation. |
4015 | Malformed update parameter | One or more parameters were not formatted correctly. |
4016 | Customer already in use | The supplied Customer information is already associated with the Program. |
4017 | Failed to retrieve customers | An exception occurred while retrieving customers. |
4018 | PII Frozen | Cannot update PII once identity verification has begun. |
4019 | PII Missing | PII could not be obtained for the customer. |
4020 | Service Offering Enrollment already exists | Service offering enrollments have already been created for this customer. |
4021 | Identity Verification submitted | This customer has previously submitted identity verification. |
4022 | Could not update customer profile responses | An exception occurred while updating customer profile responses. |
4023 | Unknown profile requirement | Could not find profile requirement. |
4024 | Profile Response formatted incorrectly | There was an issue with the way the submitted response was formatted. |
4025 | Customer has not been onboarded | The customer has not been onboarded and cannot have PII updated. |
4026 | Details are locked | One or more details provided cannot be updated once a customer is onboarded. |
4027 | Customer Inactive | PII cannot be updated if customer is not in 'active' status. |
4028 | Product Enrollment already exists | An enrollment has already been created for this customer and product. |
4029 | PII Under Review | PII under review; the customer status is under_review. |
4030 | Cannot Create Secondary Customer | The program is not fully configured to create secondary customers. Please contact Rize support. |
4031 | Secondary Customer Maximum Reached | he primary customer has the maximum amount of secondary customers allowed. |
4032 | Secondary Customer Age | The secondary customer does not meet the age requirements for the program. |
4033 | Cannot Create Customer | The program config does not allow creating any customers with the provided customer type. |
4034 | Could not archive customer | A customer with one or more active secondary customers cannot be archived. |
4035 | Cannot Create Secondary Customer | The primary customer must be enrolled in a checking product. |
4036 | Invalid Customer Type | The provided customer_type value is invalid. |
4037 | Unable to find Synthetic Accounts for customer | Customer Synthetic Account setup is incomplete. |
4038 | Secondary Customer Program Maximum Reached | The maximum amount of secondary customers for the program has been reached. |
4039 | Cannot Unlock Secondary Customer | The secondary customer cannot be unlocked because the primary customer is locked. |
4040 | Archived or Unknown customer | Could not find customer. Customer archived or invalid customer uid. |
4041 | Transfer not allowed | Transfers between customers are not allowed for this program. |
4042 | Cannot unlock Debit Card | The debit card cannot be unlocked because the customer is under review or their primary customer is under review. |
Compliance Workflow Errors
Code | Title | Detail |
---|---|---|
4100 | Could not create compliance workflow | An exception occurred while creating a compliance workflow. |
4101 | Could not update compliance workflow | An exception occurred while updating a compliance workflow. |
4102 | Unknown compliance workflow | Could not find compliance workflow. |
4103 | External UID mismatch | The supplied external_uid does not match the customer's existing one. |
4104 | Customer maximum reached | Reached active customer limit for program. |
4105 | Customer already exists | This customer has already been created. |
4106 | Compliance workflow not ready for next step | The current step of the Compliance Workflow must be completed before the next step can begin. |
4107 | Compliance Workflow in progress | A more recent compliance workflow is already in progress. |
4108 | Compliance Workflow not in progress | The compliance workflow supplied in this request is expired or rejected and is no longer in progress. |
4109 | Unknown Compliance Document | Could not find Compliance Document. |
4110 | Compliance Workflow not accepted | This customer's compliance workflow is not in a status of 'accepted'. |
4111 | Incomplete Customer details | This customer's PII is incomplete. Please see PUT customers/{uid}. |
4112 | Unknown Product Compliance Plan | Could not find Product Compliance Plan. |
4113 | Outdated Product Compliance Plan | The product_compliance_plan_uid provided is for a Compliance Plan no longer in use. |
4114 | Failed to retrieve compliance workflows | An exception occurred while retrieving compliance workflows. |
4115 | Customer maximum reached | Reached the total active customer limit for program. |
User Errors
Code | Title | Detail |
---|---|---|
5000 | Unknown user | Could not find user. Invalid uid or discarded user. |
5001 | Could not create user | An exception occurred while creating a new user. |
5002 | Could not create user | A user with the given email already exists. |
5003 | Could not grant Custodial Partner access | An unknown Custodial Partner was provided or you are not authorized to grant access to this Custodial Partner. Please check the list of valid Custodial Partners or check your privileges. |
5004 | Could not grant Partner access | An unknown Client was provided or you are not authorized to grant access to this Client. Please check the list of valid Clients or check your privileges. |
5005 | Could not update user | An exception occurred while updating the user. |
5006 | Could not resend invitation | An exception occurred while resending the invitation to the user. |
5007 | Could not resend invitation | The user is already confirmed. |
5008 | Could not revoke Custodial Partner or Partner access | The user has additional permissions that you are not authorized to revoke. |
5009 | Could not archive user | An exception occurred while archiving the user. |
5010 | Could not reset User's MFA | An exception occurred while attempting to reset the user's MFA. |
5011 | Forbidden Permission Group update | Requesting user cannot assign user to provided Permission Group. |
Transaction Errors
Code | Title | Detail |
---|---|---|
6000 | Unknown transaction | Could not find transaction. |
6001 | Unknown transaction event | Could not find transaction event. |
6002 | Unknown synthetic line item | Could not find synthetic line item. |
6003 | Unknown custodial line item | Could not find custodial line item. |
6004 | Failed to retrieve custodial line items | An exception occurred while retrieving custodial line items. |
6005 | Failed to retrieve synthetic line items | An exception occurred while retrieving synthetic line items. |
6006 | Failed to retrieve transaction events | An exception occurred while retrieving transaction events. |
6007 | Failed to retrieve transactions | An exception occurred while retrieving transactions. |
Sandbox Transactions
Code | Title | Detail |
---|---|---|
6100 | Failed to mock transaction | An exception occurred while creating a mocked transaction. |
6101 | Invalid us_dollar_amount | us_dollar_amount must be numeric and cannot be 0. |
6102 | Invalid denial_reason | denial_reason must be 'inactive_card ', 'insufficient_funds ', 'insufficient_funds_gas ', 'invalid_pin ', 'network_unavailable ' or 'other ' |
KYC Document Errors
Code | Title | Detail |
---|---|---|
7000 | Unknown evaluation | Could not find evaluation. |
7001 | Unknown KYC document | Could not find KYC document. |
7002 | Failed to retrieve document | Failed to retrieve document from our KYC partner. |
7003 | Failed to retrieve documents | Failed to retrieve documents from our KYC partner. |
7004 | Failed to post document | Failed to post document to our KYC partner. |
7005 | Failed to retrieve evaluations | An exception occurred while retrieving evaluations. |
7006 | Could not create kyc document | An exception occurred while creating a kyc document. |
7007 | Could not create kyc document | The provided filename is unexpectedly formatted. |
Custodial Account Errors
Code | Title | Detail |
---|---|---|
8000 | Unknown custodial account | Could not find custodial account. |
8001 | Failed to retrieve custodial accounts | An exception occurred while retrieving custodial accounts. |
Custodial Transaction Errors
Code | Title | Detail |
---|---|---|
8100 | Unknown custodial transaction | Could not find custodial transaction. |
8101 | Failed to retrieve custodial transactions | An exception occurred while retrieving custodial transactions. |
Customer Activity Errors
Code | Title | Detail |
---|---|---|
9000 | Unknown Customer Activity | Could not find specified customer activity. |
9001 | Failed to retrieve customer activities | An exception occurred while retrieving customer activities. |
Pool Errors
Code | Title | Detail |
---|---|---|
10000 | Unknown pool | Could not find pool. |
10001 | Failed to retrieve pools | An exception occurred while retrieving pools. |
Synthetic Account Type Errors
Code | Title | Detail |
---|---|---|
11000 | Unknown synthetic account type | Could not find synthetic account type. |
11001 | Failed to retrieve synthetic account types | An exception occurred while retrieving synthetic account types. |
11002 | Invalid routing or account number format | Routing and account numbers must be digits only. |
Webhook Errors
Code | Title | Detail |
---|---|---|
12000 | Could not process webhook | Could not process webhook. |
12001 | Empty webhook | Webhook was received with no parameters. |
User Exports Errors
Code | Title | Detail |
---|---|---|
13000 | Unknown user export | Could not find user export. |
13001 | Unsupported resource name | The given resource_name is not supported. |
13002 | Failed to initiate user export | An exception occurred while recording or initiating a user export. |
13003 | Failed to retrieve user export | An exception occurred while retrieving the user export. |
13004 | User export file not available | The user export file is either not yet generated, or an error occurred during generation. |
13005 | Failed to generate user export | An exception occurred while generating a user export CSV file. |
13006 | Failed to retrieve user exports | An exception occurred while retrieving user exports. |
Debit Card Errors
Code | Title | Detail |
---|---|---|
14000 | Unknown debit card | Could not find debit card. |
14001 | Could not lock debit card | An exception occurred while locking the debit card. |
14002 | Could not lock debit card | lock_reason must be provided in order to lock the debit card. |
14003 | Could not unlock debit card | An exception occurred while unlocking the debit card. |
14004 | Could not unlock debit card | The debit card is locked because its customer is locked. The card cannot be unlocked on its own and will be unlocked when the customer is unlocked. |
14005 | Could not create debit card | An exception occurred while creating a debit card. |
14006 | Could not create debit card | The customer or the pool has reached the maximum number of active debit cards. |
14007 | Could not reissue debit card | An error occurred when trying to initiate debit card reissuance. |
14008 | Invalid reissue reason | Debit card reissue reason must be 'lost', 'stolen', or 'damaged'. |
14009 | Card not lockable | Debit card is not in a lockable status. |
14010 | Failed to retrieve debit cards | An exception occurred while retrieving debit cards. |
14011 | Failed to activate debit card | An error occurred when trying to activate a debit card. |
14012 | Locked debit card | No activities regarding this debit card or the owner customer are allowed at this time. |
14013 | Failed to retrieve debit card PIN token | An exception occurred while retrieving debit card PIN token. |
14014 | Failed to confirm debit card PIN set | An exception occurred while confirming debit card PIN set. |
14015 | invalid debit card status for reissue | Debit card status for reissue must be 'card_replacement_shipped', 'card_replacement_shipment_returned', 'damaged', 'issued', 'normal', 'shipment_returned', 'shipped', or 'usable_without_pin'. |
14016 | Failed to retrieve debit card access token | An exception occurred while retrieving debit card access token. |
14017 | Program not configured for physical debit cards | A physical debit card cannot be issued for this program. |
14018 | No virtual debit card found | Could not find a virtual debit card for migration. |
14019 | Could not migrate debit card | An exception occurred while migrating the debit card. |
14020 | Could not migrate debit card | Only virtual cards can be migrated. |
14021 | Error retrieving virtual card image | An error occurred when retrieving the virtual card image. |
14022 | Debit card reissue forbidden | Debit card reissue forbidden per program config. |
14023 | Invalid debit card plan | Cannot proceed due to invalid debit card plan. |
Permission Group Errors
Code | Title | Detail |
---|---|---|
15000 | Unknown Permission Group | Could not find Permission Group |
15001 | Failed to retrieve permission groups | An exception occurred while retrieving permission groups. |
Client Errors
Code | Title | Detail |
---|---|---|
16000 | Unknown Client | Could not find Client. |
Custodial Partner Errors
Code | Title | Detail |
---|---|---|
17000 | Unknown Custodial Partner | Could not find Custodial Partner. |
17001 | Failed to retrieve custodial partners | An exception occurred while retrieving custodial partners. |
Program Errors
Code | Title | Detail |
---|---|---|
18000 | Unknown Program | Could not find Program. |
18001 | Failed to retrieve programs | An exception occurred while retrieving programs. |
Document Errors
Code | Title | Detail |
---|---|---|
19000 | Unknown Document | Could not find Document. |
19001 | Failed to retrieve documents | An exception occurred while retrieving documents. |
19002 | Failed to retrieve document | An exception occurred while retrieving the document. |
19003 | Unsupported Document Content-Type | For monthly_statement document_type, application/pdf and application/html are supported. For other document_types, application/pdf is supported. |
Role Errors
Code | Title | Detail |
---|---|---|
20000 | Unknown Role | Could not find Role. |
20001 | Failed to retrieve roles | An exception occurred while retrieving roles. |
User Group Errors
Code | Title | Detail |
---|---|---|
21000 | Unknown User Group | Could not find User Group. |
21001 | Failed to retrieve user groups | An exception occurred while retrieving user groups. |
Product Errors
Code | Title | Detail |
---|---|---|
22000 | Unknown Product | Could not find Product. |
22001 | Failed to retrieve products | An exception occurred while retrieving products. |
Customer Product Errors
Code | Title | Detail |
---|---|---|
23000 | Unknown Customer Product | Could not find Customer Product. |
23001 | Failed to retrieve customer products | An exception occurred while retrieving customer products. |
23002 | Could not create customer product | An exception occurred while creating a customer product. |
23003 | PII Confirmation | PII must be confirmed before proceeding with customer product onboarding. |
23004 | Customer Inactive | Customers not in 'active' status cannot be onboarded into additional Products. |
23005 | Compliance Workflow not Begun | A Compliance Workflow for this Customer and Product has not been created. |
23006 | Profile Response Verification | One or more of the Customer's Profile Responses do not meet requirements for onboarding into this Product. |
23007 | Profile Responses Incomplete | One or more Profile Requirements have not been given a Profile Response. |
23008 | Product Prerequisite Required | Customer must be onboarded into one or more Products before this one. |
23009 | Customer Already in Product | Customer already belongs to this Product. |
23010 | Invalid Customer Product for Customer Type | The specified Customer cannot be onboarded to the selected Product. |
Adjustment Related Errors
Code | Title | Detail |
---|---|---|
24000 | Unknown adjustment request uid | Could not find adjustment request. Invalid uid. |
24001 | Could not initiate adjustment request | An exception occurred while creating the adjustment request. |
24002 | Failed to retrieve adjustment requests | An exception occurred while retrieving adjustment requests. |
24003 | Unknown adjustment type uid | Could not find adjustment type. Invalid uid. |
24004 | Failed to retrieve adjustment types | An exception occurred while retrieving adjustment types. |
24005 | Insufficient funds | Insufficient Customer Funds. |
24006 | Adjustments forbidden | Adjustments forbidden per program config. |
24007 | Adjustments forbidden | Adjustments forbidden for locked customers. |
Sandbox Onboarding Related Errors
Code | Title | Detail |
---|---|---|
25000 | Failed to onboard sandbox program | An exception occurred while onboarding program. |
25001 | Invalid Cognito token | The token provided is either outdated or not parseable. |
Pinwheel Related Errors
Code | Title | Detail |
---|---|---|
26000 | Program not configured for Pinwheel integrations | A Pinwheel job cannot be created for this program. |
26001 | Cannot create Pinwheel job | Pinwheel job could not be created. |
26002 | Failed to retrieve Pinwheel jobs | An exception occurred while retrieving Pinwheel jobs. |
26003 | Unknown Pinwheel job | Could not find Pinwheel job. |
Card Artwork Related Errors
Code | Title | Detail |
---|---|---|
26004 | Unknown card artwork | Could not find card artwork. |
26005 | Failed to retrieve card artworks | An exception occurred while retrieving card artworks. |
IP and Device Tracking Errors
Code | Title | Detail |
---|---|---|
27000 | Header missing | The header 'customer_initiated' must be included |
27001 | Headers missing | The headers 'reference_customer_uid', 'reference_customer_ip_address' and 'reference_customer_device_id' must be included when the request was initiated by a customer |
27002 | Reference customer not found | The customer referenced by the header 'reference_customer_uid' does not exist |