API Errors

A list of error codes from the Rize API and what they mean

General Errors

CodeTitleDetails
1000Internal ServerSomething went wrong.
1001Page Not FoundThe route you're looking for does not exist.
1002Unparseable Date FormatCould not parse date. Please try ISO 8601 calendar date in extended format (YYYY-MM-DD).
1003Missing Request ParameterAt least one parameter is missing. Cannot continue with the request.
1004UnauthorizedInvalid or expired authentication.
1005Invalid Limit ValueThe limit parameter value cannot be negative.
1006Invalid Sort PatternThe sort parameter value must match the field_name_order pattern (example: "email_asc").
1007Invalid Method ArgumentAt least one argument is invalid. Cannot continue with the request.
1008Archived CustomerThe Customer is archived. Cannot continue with the request.
1009Archived PoolThe Pool is archived. Cannot continue with the request.
1010Inactive CustomerThe Customer is not active. Cannot continue with the request.
1011Customer Not In Updatable StatusCustomer not in updatable status. Cannot continue with the request.

Synthetic Account Errors

CodeTitleDetail
2000Unknown Synthetic AccountCould not find Synthetic Account.
2001Cannot archive Synthetic AccountSynthetic Account could not be archived.
2002Cannot create Synthetic AccountSynthetic Account could not be created.
2003Cannot archive master Synthetic AccountThe master Synthetic Account for a Customer cannot be archived.
2004Cannot archive Synthetic Account with balanceA Synthetic Account with a non-zero balance cannot be archived.
2005Cannot archive Synthetic Account with pending TransferA Synthetic Account with a pending Transfer cannot be archived.
2006Cannot archive non-general Synthetic AccountSynthetic Accounts must be of the general or the target_yield_account type to be
archived. Please contact your Rize account manager to archive external Synthetic Accounts.
2007Cannot update Synthetic AccountSynthetic Account could not be updated.
2008Cannot update Synthetic AccountA note is required to update Synthetic Accounts.
2009Could not create Synthetic AccountThe count of this customer's active synthetic accounts in the general synthetic account category has reached the maximum.
2010Could not create Synthetic AccountThis customer already has an active or initiated synthetic account in the external or the
plaid_external synthetic account category.
2011Failed to retrieve synthetic accountsAn exception occurred while retrieving synthetic accounts.
2012Malformed Plaid processor tokenThe Plaid processor token provided is either malformed or unsupported.
2013Could not create Synthetic AccountThe unique external account limit for this customer has been reached.
2014Could not create Synthetic AccountAn external account has been created too recently.
2015Could not create Synthetic AccountThis external account has been associated with this customer too many times.
2016Could not create Synthetic AccountThis customer has reached the outbound ACH external account limit
2017Cannot archive Synthetic AccountSynthetic Account must be in 'active' status to archive
2018The synthetic account cannot be used with PinwheelPinwheel jobs can only be created for the master liability synthetic account if it is active and has a type of "general".
2019Synthetic account name is already takenSynthetic account names must be unique to a pool

Transfer Related Errors

CodeTitleDetail
3000Unknown transfer uidCould not find transfer. Invalid uid.
3001Could not initiate transferAn exception occurred while creating transfer.
3002Could not initiate transferRequested transfer amount in US dollars must be numeric.
3003Could not initiate transferRequested transfer amount in US dollars must be greater than 0.
3004Could not initiate transferSource has insufficient funds for transfer.
3005Same source and destination accountsThe source and destination accounts are identical.
3006Could not initiate transferRequested transfer between the chosen accounts is prohibited.
3007Source or Destination Account is discardedTransfers to or from a discarded account are not allowed.
3008Source or Destination Account is lockedTransfers to or from a locked account or an account that belongs to a locked customer are prohibited.
3010Customer daily external transfer request maximum has been reachedThe maximum number of daily external transfers defined in the Program configuration has been reached.
3011Customer daily external transfer amount has been reachedThis transfer request exceeds the customer's daily external transfer US dollar amount limit.
3012Transfer amount exceeds program maximumThis transfer exceeds the maximum dollar amount allowed in the Program configuration.
3013Transfer amount below program minimumThis transfer does not meet the minimum dollar amount required in the Program configuration.
3014Failed to retrieve transfersAn exception occurred while retrieving transfers.
3015Could not initiate transferAn exception occurred while creating the custodial transfer.
3016Source or Destination Account is inactiveTransfers to or from an account not in 'active' status are prohibited.
3017Transfer amount exceeds program limitTransfer amount exceeds program config limit for any transfer
3018Transfer amount would exceed the cumulative credit limitTransfer amount would exceed the cumulative credit amount limit.
3019Invalid usd_transfer_amount valueRequested transfer amount in US dollars cannot have more than 2 decimal places.
3020Transfers are not supported for secondary customersTransfers are only supported for primary (account-holding) customers.
3021Maximum customer balance has reachedThis transfer request would result in the customer's total balance exceeding the configured maximum allowed balance

Customer-Related Errors

CodeTitleDetail
4000Could not create customerAn exception occurred while creating a customer.
4001Could not update customerAn exception occurred while updating the customer.
4002Unknown customerCould not find customer. Invalid customer uid.
4003Locked customerNo activities regarding this customer are allowed at this time.
4004Could not archive customerAn exception occurred while archiving the customer.
4005Could not archive customerA customer with a non-zero balance cannot be archived.
4006Could not archive customerA customer with a pending transfer cannot be archived.
4007Could not lock customerAn exception occurred while locking the customer.
4008Could not lock customerlock_reason must be provided in order to lock the customer.
4009Could not unlock customerAn exception occurred while unlocking the customer.
4010Could not lock customer properlyAn 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.
4011Incomplete customer onboardingThe customer must complete the onboarding process or be enrolled in additional product(s) before proceeding.
4012Could not save customer detailsAn exception occurred when creating or updating customer details.
4013Could not initiate customer verificationAn exception occurred while initiating customer verification.
4014Could not initiate customer confirmationAn exception occurred while initiating customer confirmation.
4015Malformed update parameterOne or more parameters were not formatted correctly.
4016Customer already in useThe supplied Customer information is already associated with the Program.
4017Failed to retrieve customersAn exception occurred while retrieving customers.
4018PII FrozenCannot update PII once identity verification has begun.
4019PII MissingPII could not be obtained for the customer.
4020Service Offering Enrollment already existsService offering enrollments have already been created for this customer.
4021Identity Verification submittedThis customer has previously submitted identity verification.
4022Could not update customer profile responsesAn exception occurred while updating customer profile responses.
4023Unknown profile requirementCould not find profile requirement.
4024Profile Response formatted incorrectlyThere was an issue with the way the submitted response was formatted.
4025Customer has not been onboardedThe customer has not been onboarded and cannot have PII updated.
4026Details are lockedOne or more details provided cannot be updated once a customer is onboarded.
4027Customer InactivePII cannot be updated if customer is not in 'active' status.
4028Product Enrollment already existsAn enrollment has already been created for this customer and product.
4029PII Under ReviewPII under review; the customer status is under_review.
4030Cannot Create Secondary CustomerThe program is not fully configured to create secondary customers. Please contact Rize support.
4031Secondary Customer Maximum Reachedhe primary customer has the maximum amount of secondary customers allowed.
4032Secondary Customer AgeThe secondary customer does not meet the age requirements for the program.
4033Cannot Create CustomerThe program config does not allow creating any customers with the provided customer type.
4034Could not archive customerA customer with one or more active secondary customers cannot be archived.
4035Cannot Create Secondary CustomerThe primary customer must be enrolled in a checking product.
4036Invalid Customer TypeThe provided customer_type value is invalid.
4037Unable to find Synthetic Accounts for customerCustomer Synthetic Account setup is incomplete.
4038Secondary Customer Program Maximum ReachedThe maximum amount of secondary customers for the program has been reached.
4039Cannot Unlock Secondary CustomerThe secondary customer cannot be unlocked because the primary customer is locked.
4040Archived or Unknown customerCould not find customer. Customer archived or invalid customer uid.
4041Transfer not allowedTransfers between customers are not allowed for this program.
4042Cannot unlock Debit CardThe debit card cannot be unlocked because the customer is under review or their primary customer is under review.

Compliance Workflow Errors

CodeTitleDetail
4100Could not create compliance workflowAn exception occurred while creating a compliance workflow.
4101Could not update compliance workflowAn exception occurred while updating a compliance workflow.
4102Unknown compliance workflowCould not find compliance workflow.
4103External UID mismatchThe supplied external_uid does not match the customer's existing one.
4104Customer maximum reachedReached active customer limit for program.
4105Customer already existsThis customer has already been created.
4106Compliance workflow not ready for next stepThe current step of the Compliance Workflow must be completed before the next step can begin.
4107Compliance Workflow in progressA more recent compliance workflow is already in progress.
4108Compliance Workflow not in progressThe compliance workflow supplied in this request is expired or rejected and is no longer in progress.
4109Unknown Compliance DocumentCould not find Compliance Document.
4110Compliance Workflow not acceptedThis customer's compliance workflow is not in a status of 'accepted'.
4111Incomplete Customer detailsThis customer's PII is incomplete. Please see PUT customers/{uid}.
4112Unknown Product Compliance PlanCould not find Product Compliance Plan.
4113Outdated Product Compliance PlanThe product_compliance_plan_uid provided is for a Compliance Plan no longer in use.
4114Failed to retrieve compliance workflowsAn exception occurred while retrieving compliance workflows.
4115Customer maximum reachedReached the total active customer limit for program.

User Errors

CodeTitleDetail
5000Unknown userCould not find user. Invalid uid or discarded user.
5001Could not create userAn exception occurred while creating a new user.
5002Could not create userA user with the given email already exists.
5003Could not grant Custodial Partner accessAn 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.
5004Could not grant Partner accessAn 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.
5005Could not update userAn exception occurred while updating the user.
5006Could not resend invitationAn exception occurred while resending the invitation to the user.
5007Could not resend invitationThe user is already confirmed.
5008Could not revoke Custodial Partner or Partner accessThe user has additional permissions that you are not authorized to revoke.
5009Could not archive userAn exception occurred while archiving the user.
5010Could not reset User's MFAAn exception occurred while attempting to reset the user's MFA.
5011Forbidden Permission Group updateRequesting user cannot assign user to provided Permission Group.

Transaction Errors

CodeTitleDetail
6000Unknown transactionCould not find transaction.
6001Unknown transaction eventCould not find transaction event.
6002Unknown synthetic line itemCould not find synthetic line item.
6003Unknown custodial line itemCould not find custodial line item.
6004Failed to retrieve custodial line itemsAn exception occurred while retrieving custodial line items.
6005Failed to retrieve synthetic line itemsAn exception occurred while retrieving synthetic line items.
6006Failed to retrieve transaction eventsAn exception occurred while retrieving transaction events.
6007Failed to retrieve transactionsAn exception occurred while retrieving transactions.

Sandbox Transactions

CodeTitleDetail
6100Failed to mock transactionAn exception occurred while creating a mocked transaction.
6101Invalid us_dollar_amountus_dollar_amount must be numeric and cannot be 0.
6102Invalid denial_reasondenial_reason must be 'inactive_card', 'insufficient_funds', 'insufficient_funds_gas', 'invalid_pin', 'network_unavailable' or 'other'

KYC Document Errors

CodeTitleDetail
7000Unknown evaluationCould not find evaluation.
7001Unknown KYC documentCould not find KYC document.
7002Failed to retrieve documentFailed to retrieve document from our KYC partner.
7003Failed to retrieve documentsFailed to retrieve documents from our KYC partner.
7004Failed to post documentFailed to post document to our KYC partner.
7005Failed to retrieve evaluationsAn exception occurred while retrieving evaluations.
7006Could not create kyc documentAn exception occurred while creating a kyc document.
7007Could not create kyc documentThe provided filename is unexpectedly formatted.

Custodial Account Errors

CodeTitleDetail
8000Unknown custodial accountCould not find custodial account.
8001Failed to retrieve custodial accountsAn exception occurred while retrieving custodial accounts.

Custodial Transaction Errors

CodeTitleDetail
8100Unknown custodial transactionCould not find custodial transaction.
8101Failed to retrieve custodial transactionsAn exception occurred while retrieving custodial transactions.

Customer Activity Errors

CodeTitleDetail
9000Unknown Customer ActivityCould not find specified customer activity.
9001Failed to retrieve customer activitiesAn exception occurred while retrieving customer activities.

Pool Errors

CodeTitleDetail
10000Unknown poolCould not find pool.
10001Failed to retrieve poolsAn exception occurred while retrieving pools.

Synthetic Account Type Errors

CodeTitleDetail
11000Unknown synthetic account typeCould not find synthetic account type.
11001Failed to retrieve synthetic account typesAn exception occurred while retrieving synthetic account types.
11002Invalid routing or account number formatRouting and account numbers must be digits only.

Webhook Errors

CodeTitleDetail
12000Could not process webhookCould not process webhook.
12001Empty webhookWebhook was received with no parameters.

User Exports Errors

CodeTitleDetail
13000Unknown user exportCould not find user export.
13001Unsupported resource nameThe given resource_name is not supported.
13002Failed to initiate user exportAn exception occurred while recording or initiating a user export.
13003Failed to retrieve user exportAn exception occurred while retrieving the user export.
13004User export file not availableThe user export file is either not yet generated, or an error occurred during generation.
13005Failed to generate user exportAn exception occurred while generating a user export CSV file.
13006Failed to retrieve user exportsAn exception occurred while retrieving user exports.

Debit Card Errors

CodeTitleDetail
14000Unknown debit cardCould not find debit card.
14001Could not lock debit cardAn exception occurred while locking the debit card.
14002Could not lock debit cardlock_reason must be provided in order to lock the debit card.
14003Could not unlock debit cardAn exception occurred while unlocking the debit card.
14004Could not unlock debit cardThe 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.
14005Could not create debit cardAn exception occurred while creating a debit card.
14006Could not create debit cardThe customer or the pool has reached the maximum number of active debit cards.
14007Could not reissue debit cardAn error occurred when trying to initiate debit card reissuance.
14008Invalid reissue reasonDebit card reissue reason must be 'lost', 'stolen', or 'damaged'.
14009Card not lockableDebit card is not in a lockable status.
14010Failed to retrieve debit cardsAn exception occurred while retrieving debit cards.
14011Failed to activate debit cardAn error occurred when trying to activate a debit card.
14012Locked debit cardNo activities regarding this debit card or the owner customer are allowed at this time.
14013Failed to retrieve debit card PIN tokenAn exception occurred while retrieving debit card PIN token.
14014Failed to confirm debit card PIN setAn exception occurred while confirming debit card PIN set.
14015invalid debit card status for reissueDebit card status for reissue must be 'card_replacement_shipped', 'card_replacement_shipment_returned',
'damaged', 'issued', 'normal', 'shipment_returned', 'shipped', or 'usable_without_pin'.
14016Failed to retrieve debit card access tokenAn exception occurred while retrieving debit card access token.
14017Program not configured for physical debit cardsA physical debit card cannot be issued for this program.
14018No virtual debit card foundCould not find a virtual debit card for migration.
14019Could not migrate debit cardAn exception occurred while migrating the debit card.
14020Could not migrate debit cardOnly virtual cards can be migrated.
14021Error retrieving virtual card imageAn error occurred when retrieving the virtual card image.
14022Debit card reissue forbiddenDebit card reissue forbidden per program config.
14023Invalid debit card planCannot proceed due to invalid debit card plan.

Permission Group Errors

CodeTitleDetail
15000Unknown Permission GroupCould not find Permission Group
15001Failed to retrieve permission groupsAn exception occurred while retrieving permission groups.

Client Errors

CodeTitleDetail
16000Unknown ClientCould not find Client.

Custodial Partner Errors

CodeTitleDetail
17000Unknown Custodial PartnerCould not find Custodial Partner.
17001Failed to retrieve custodial partnersAn exception occurred while retrieving custodial partners.

Program Errors

CodeTitleDetail
18000Unknown ProgramCould not find Program.
18001Failed to retrieve programsAn exception occurred while retrieving programs.

Document Errors

CodeTitleDetail
19000Unknown DocumentCould not find Document.
19001Failed to retrieve documentsAn exception occurred while retrieving documents.
19002Failed to retrieve documentAn exception occurred while retrieving the document.
19003Unsupported Document Content-TypeFor monthly_statement document_type, application/pdf and application/html are supported. For other document_types, application/pdf is supported.

Role Errors

CodeTitleDetail
20000Unknown RoleCould not find Role.
20001Failed to retrieve rolesAn exception occurred while retrieving roles.

User Group Errors

CodeTitleDetail
21000Unknown User GroupCould not find User Group.
21001Failed to retrieve user groupsAn exception occurred while retrieving user groups.

Product Errors

CodeTitleDetail
22000Unknown ProductCould not find Product.
22001Failed to retrieve productsAn exception occurred while retrieving products.

Customer Product Errors

CodeTitleDetail
23000Unknown Customer ProductCould not find Customer Product.
23001Failed to retrieve customer productsAn exception occurred while retrieving customer products.
23002Could not create customer productAn exception occurred while creating a customer product.
23003PII ConfirmationPII must be confirmed before proceeding with customer product onboarding.
23004Customer InactiveCustomers not in 'active' status cannot be onboarded into additional Products.
23005Compliance Workflow not BegunA Compliance Workflow for this Customer and Product has not been created.
23006Profile Response VerificationOne or more of the Customer's Profile Responses do not meet requirements for onboarding into this Product.
23007Profile Responses IncompleteOne or more Profile Requirements have not been given a Profile Response.
23008Product Prerequisite RequiredCustomer must be onboarded into one or more Products before this one.
23009Customer Already in ProductCustomer already belongs to this Product.
23010Invalid Customer Product for Customer TypeThe specified Customer cannot be onboarded to the selected Product.

Adjustment Related Errors

CodeTitleDetail
24000Unknown adjustment request uidCould not find adjustment request. Invalid uid.
24001Could not initiate adjustment requestAn exception occurred while creating the adjustment request.
24002Failed to retrieve adjustment requestsAn exception occurred while retrieving adjustment requests.
24003Unknown adjustment type uidCould not find adjustment type. Invalid uid.
24004Failed to retrieve adjustment typesAn exception occurred while retrieving adjustment types.
24005Insufficient fundsInsufficient Customer Funds.
24006Adjustments forbiddenAdjustments forbidden per program config.
24007Adjustments forbiddenAdjustments forbidden for locked customers.

Sandbox Onboarding Related Errors

CodeTitleDetail
25000Failed to onboard sandbox programAn exception occurred while onboarding program.
25001Invalid Cognito tokenThe token provided is either outdated or not parseable.

Pinwheel Related Errors

CodeTitleDetail
26000Program not configured for Pinwheel integrationsA Pinwheel job cannot be created for this program.
26001Cannot create Pinwheel jobPinwheel job could not be created.
26002Failed to retrieve Pinwheel jobsAn exception occurred while retrieving Pinwheel jobs.
26003Unknown Pinwheel jobCould not find Pinwheel job.

Card Artwork Related Errors

CodeTitleDetail
26004Unknown card artworkCould not find card artwork.
26005Failed to retrieve card artworksAn exception occurred while retrieving card artworks.

IP and Device Tracking Errors

CodeTitleDetail
27000Header missingThe header 'customer_initiated' must be included
27001Headers missingThe headers 'reference_customer_uid', 'reference_customer_ip_address' and 'reference_customer_device_id' must be included when the request was initiated by a customer
27002Reference customer not foundThe customer referenced by the header 'reference_customer_uid' does not exist