Error codes
Error Codes Description
The table below lists common error codes associated with API endpoint interactions, detailing both a brief and an extended description for each.
| Code | Detail | Description |
|---|---|---|
| unable_to_authenticate | Unable to authenticate with provided email-password combination. | Indicates a failure to authenticate using the given email and password, suggesting incorrect or missing information. |
| user_not_found | User with provided credentials does not exist in the system. | Suggests the credentials used do not match any existing user in the system. |
| incorrect_credentials | Incorrect email or password. | The provided email or password does not match the user's details. |
| invalid_authentication_scheme | Invalid authentication scheme. | The authentication method attempted is not supported or incorrectly implemented. |
| invalid_email | Invalid email provided. | The email address format is incorrect or fails validation checks. |
| invalid_token | Invalid token provided. | The token used for authentication is invalid, possibly malformed or tampered. |
| invalid_token_or_expired_token | Invalid token or expired token. | The authentication token is either invalid or has expired and needs renewal. |
| invalid_authorization_code | Invalid authorization code. | The authorization code used for the transaction is invalid, suggesting a typo or misuse. |
| expired_verification_code | Verification code is expired. | The code provided for verification has passed its validity period and is no longer usable. |
| account_deactivated | User account is deactivated. Please contact customer support. | The user's account has been deactivated, likely due to policy violations or user request. Contact support for reactivation. |
| account_deleted | Your account is deleted. Please contact customer support. | The account in question has been deleted, potentially at the user's request or due to a policy violation. |
| account_blocked | The account is blocked. Please contact customer support. | The user's account is currently blocked from accessing the service, requiring intervention from support. |
| invalid_2fa_code | Invalid 2FA code. | The two-factor authentication code provided is incorrect or out of sequence. |
| two_factor_required | 2FA code required. | Access or transaction requires two-factor authentication for additional security. |
| invalid_user_agent_ip | Invalid user agent or IP address. | The request was made from an unrecognized device or IP address, suggesting potential security concerns. |
| already_verified_user | User already verified. | The user has already completed verification processes, indicating a redundant request. |
| password_already_in_use | Provided password already in use. | The chosen password is already associated with this account, suggesting a need for a more unique selection. |
| invalid_auth_code | Invalid auth code. | The authentication code provided is incorrect or not applicable for the current operation. |
| invalid_headers | Invalid headers provided. | The request headers are malformed or missing required entries, indicating a bad request structure. |
| invalid_host | Invalid host provided. | The host address is incorrect or not recognized, potentially due to a typo or configuration error. |
| too_weak_password | Password is too weak. | The chosen password does not meet the security standards, suggesting it is too simple or common. |
| user_with_email_and_whitelabel_exists | User with provided email and whitelabel already exists. | An attempt to create a new account with an email and whitelabel that are already in use, indicating a duplicate entry. |
| captcha_required | Captcha required. | The transaction requires a captcha verification to proceed, typically for security reasons. |
| captcha_failed | Captcha failed. | The captcha response provided was incorrect, suggesting a potential automated request or error in submission. |