Error Codes

Error response structure

{
    "responseType": RESPONSE_TYPE_ENUM,
    "statusCode": INTEGER_STATUS_CODE,
    "response": {
        "errorCode": "ERROR_CODE",
        "errorMessage": "ERROR_MESSAGE"
    }
}

RESPONSE_TYPE_ENUM - The type of response for which the error occurred. It can be INITIATE, VERIFY, or FAILED.
INTEGER_STATUS_CODE - The HTTP status code or a status code curated by Otpless.
ERROR_CODE - The error code for the specific error curated by Otpless.
ERROR_MESSAGE - The error message that describes the error in detail.

Errors for different Response Types

INITIATE
VERIFY
FAILED

Bad requests:

Status Code	Error Code	Error Message	Explanation
400	7101	Request error: Invalid parameters values or Required parameters are missing.	Some required parameters are either missing or have invalid values.
400	7102	Request error: Invalid phone number.	The provided phone number format is incorrect or invalid.
400	7103	Request error: Invalid phone number delivery channel.	The selected delivery channel for the phone number is not supported.
400	7104	Request error: Invalid email.	The provided email address is incorrectly formatted or invalid.
400	7105	Request error: Invalid email channel.	The selected delivery channel for the email is not supported.
400	7106	Request error: Invalid phoneNumber or email.	Either the phone number or email provided is incorrect or missing.
400	7113	Request error: Invalid expiry.	The provided expiry time for OTP or request is invalid.
400	7116	Request error: OTP Length is invalid. 4 and 6 only allowed.	The OTP length must be either 4 or 6 digits.
400	7121	Request error: Invalid app hash.	The provided app hash does not match the expected format.
4000	4000	The request values are incorrect, See details.	The provided values do not match the expected format.
4001	4001	The Otpless SDK does not support 2FA as of now.	The requested authentication method (2FA) is not currently supported.
4003	4003	The request channel (CHANNEL) is incorrect.	The specified request channel is not enabled in the OTPLESS Dashboard.
5900	5900	The (FEATURE) is not supported because it requires iOS version (supportedFrom) and above.	The requested feature is only available on newer iOS versions.

Unauthorized requests:

Status Code	Error Code	Error Message	Explanation
401	401	UnAuthorized request! Please check your appId.	The provided appId is incorrect or missing authentication.
401	7025	SMS delivery to this country is not enabled. Contact OTPLESS team to activate.	The requested country is not supported for SMS delivery.

HTTP Status Code 429: Too Many Requests:

Status Code	Error Code	Error Message	Explanation
429	7020	Authentication Rate Limited reached. Please try again after some time.	Too many authentication attempts have been made in a short period. The user must wait before trying again.
429	7022	The identity associated with this request has exceeded the allowed number of authentication requests. Please wait until the rate limit resets.	The specific user or identity has hit the authentication request limit. Further attempts are blocked until the limit resets.
429	7023	The IP associated with this request has exceeded the allowed number of authentication requests. Please wait until the rate limit resets.	The IP address sending the request has surpassed the allowed authentication attempts. The user must wait before retrying.
429	7024	The application has exceeded the allowed number of authentication requests. Please wait until the rate limit resets.	The entire application has reached its authentication request threshold. No further requests can be made until the rate limit resets.

Network connectivity errors:

Status Code	Error Code	Error Message	Explanation
9100	9100	Request Timeout	The request took too long to complete and was aborted.
9101	9101	Network Connection Was Lost	The connection was interrupted before the request could complete.
9102	9102	DNS Lookup Failed	The domain name could not be resolved, possibly due to network issues.
9103	9103	Cannot Connect to Server	The server is unreachable, possibly due to downtime or incorrect configurations.
9104	9104	No Internet Connection	The device is not connected to the internet.
9105	9105	Secure Connection Failed (SSL issue)	A secure connection could not be established due to SSL/TLS issues.
9110	9110	Otpless authentication request cancelled	The authentication request was manually canceled by the user or the system.

Bad requests:

Status Code	Error Code	Error Message
400	7112	Request error: Empty OTP
400	7115	Request error: OTP is already verified
400	7118	Request error: Incorrect OTP!
400	7303	Request error: OTP expired

Internal server error:

Status Code	Error Message	Error Code
500	Something went wrong! Please try again.	500

Network connectivity errors:

Status Code	Error Code	Error Message	Explanation
9100	9100	Request Timeout	The request took too long to complete and was aborted.
9101	9101	Network Connection Was Lost	The connection was interrupted before the request could complete.
9102	9102	DNS Lookup Failed	The domain name could not be resolved, possibly due to network issues.
9103	9103	Cannot Connect to Server	The server is unreachable, possibly due to downtime or incorrect configurations.
9104	9104	No Internet Connection	The device is not connected to the internet.
9105	9105	Secure Connection Failed (SSL issue)	A secure connection could not be established due to SSL/TLS issues.
9110	9110	Otpless authentication request cancelled	The authentication request was manually canceled by the user or the system.

Web SDKs

Native/Mobile SDKs

References

Error response structure

Errors for different Response Types

Bad requests:

Unauthorized requests:

HTTP Status Code 429: Too Many Requests:

Network connectivity errors:

Bad requests:

Internal server error:

Network connectivity errors:

​Error response structure

​Errors for different Response Types

​Bad requests:

​Unauthorized requests:

​HTTP Status Code 429: Too Many Requests:

​Network connectivity errors:

​Bad requests:

​Internal server error:

​Network connectivity errors:

Error response structure

Errors for different Response Types

Bad requests:

Unauthorized requests:

HTTP Status Code 429: Too Many Requests:

Network connectivity errors:

Bad requests:

Internal server error:

Network connectivity errors: