General API Error Codes

These error codes are consistent across our API.

Error	Code	Error Message
INVALID_ACCOUNT	AUTH-0001	Your account does not have the right permission to login to this portal. Please Apply for an Enterprise Account.
INVALID_CREDENTIALS	AUTH-0002	Incorrect auth details.
PHONE_NUMBER_NOT_FOUND	AUTH-0003	Unable to find provided phone number or phone number it is not verified. Please select different method or contact customer support.
INVALID_PHONE_NUMBER	AUTH-0004	Invalid phone number.
INVALID_2FA_TOKEN	AUTH-0005	Access denied or expired.
INCORRECT_AUTH_CODE	AUTH-0006	Auth code provided is incorrect, please check and re-enter received code and try again.
UNABLE_TO_SEND_AUTH_CODE	AUTH-0007	Sorry, we were unable to send the auth code, please try again or contact customer support.
INVALID_USER_ACCESS	AUTH-0008	Invalid user access.
INVALID_PASSWORD	AUTH-0009	The provided password is not valid.
NO_PIN_EXISTS	AUTH-0010	There is no passcode set on the user, please create one instead.
PIN_ALREADY_SET	AUTH-0011	There is already a passcode set on the user, please reset instead.
INVALID_PIN_CODE	AUTH-0012	The provided passcode does not match our records, please try again or reset your passcode.
SOCIAL_UNABLE_TO_LOGIN	AUTH-0013	Unable to login with your social account. Please verify your credentials and try again or contact customer support.
UNABLE_TO_CREATE_PIN	AUTH-0014	Unable to create new pass-code, please try again or contact customer support.
UNABLE_TO_CHECK_PIN	AUTH-0015	Unable to check pass-code, please try again or contact customer support.
UNABLE_TO_UPDATE_PIN	AUTH-0016	Unable to update pass-code, please try again or contact customer support.
UNABLE_TO_RESET_PIN	AUTH-0017	Unable to reset pass-code, please try again or contact customer support.
TRADITIONAL_UNABLE_TO_LOGIN	AUTH-0018	Unable to login with your account. Please verify your credentials and try again or contact customer support.
INVALID_JWT	AUTH-0019	Invalid JWT Token!
UNABLE_TO_RESEND_2FA	AUTH-0020	Unable to re-send 2FA!
UNSUPPORTED_PHONE_NUMBER	AUTH-0021	Provided number is not a valid mobile phone number! Please contact support for more details.
REGISTRATION_NOT_ALLOWED	AUTH-0022	Registration not allowed, please contact customer support!
UNABLE_TO_CHANGE_PASSWORD	AUTH-0023	Unable to change password. Please try again or contact customer support.
UNVERIFIED_PHONE_NUMBER	AUTH-0024	Your phone number requires verification. Please contact support.
UNSUCCESSFUL_REGISTRATION	AUTH-0025	Please try again again or contact support.
REGISTRATION_PHONE_TAKEN	AUTH-0026	The phone number you chose is already in use.
REGISTRATION_EMAIL_TAKEN	AUTH-0027	The email address you chose is already in use.
UNABLE_TO_RESET_PASSWORD	AUTH-0028	Unable to reset password.
SECURITY_CODE_EXPIRED	AUTH-0029	Your 6-digit security code has expired. Please resend a new code.
APPLICATION_INACTIVE	AUTH-0030	Your application is not active.
INVALID_SCOPE	AUTH-0031	The requested scopes must be granted by the user first.

Address errors

Address fields are validated across several flows. Constraints differ by context (for example, virtual card and bank account addresses are US-only, while business legal addresses may be international). For formatting rules and worked examples, see Address Formatting Requirements.

Error	Code	Applies to	Error Message
INVALID_BILLING_ADDRESS	VC-0025	Virtual card issuance (billing address)	The billing address could not be verified. It must be a deliverable US address (no PO boxes) with a matching city, state, and ZIP.
InvalidBusinessLegalAddress	BS-0002	Business registration (KYB)	Business legal address is incorrect.
InvalidOwnerInformation	BS-0003	Business registration (KYB)	One or more owner details are incorrect (includes the owner’s US-based address).

Missing or malformed address fieldsA missing required field or an invalid value inside an address object is returned as a general argument error — ARG-0001 on virtual card calls, or AR-0001 / AR-0002 on business registration — rather than one of the address codes above.

Next steps

Errors reference

The error envelope shape, domain prefixes, and how to troubleshoot with request IDs.

Address formatting

Formatting rules and worked examples for avoiding the address errors above.

Want to learn more? Contact us at partnerships@fluz.app. Speak with our experts for more info or to request a demo.

Developers

Recipes

General API Error Codes

Address errors

Next steps

Errors reference

Address formatting

​Address errors

​Next steps

Errors reference

Address formatting

Address errors

Next steps