> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/concepts/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).                                                   |

<Note>
  **Missing or malformed address fields**

  A 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.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Errors reference" icon="triangle-alert" href="/api-reference/errors">
    The error envelope shape, domain prefixes, and how to troubleshoot with request IDs.
  </Card>

  <Card title="Address formatting" icon="map-pin" href="/concepts/address-formatting-requirements">
    Formatting rules and worked examples for avoiding the address errors above.
  </Card>
</CardGroup>

**Want to learn more?** Contact us at [partnerships@fluz.app](mailto:partnerships@fluz.app). Speak with our experts for more info or to request a demo.