API Errors

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 be archived. 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 the `plaid_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