Docs home

Verify OTP for Email

Checks the one-time code sent by "Signup OTP Send for Email" and returns a short-lived token that proves the email was verified. Step 2 of OTP signup.

POST/user/verify/otp
Verify OTP for Email
curl --request POST \
  --url 'https://<your-api-host>/nuSource/api/v1/user/verify/otp' \
  --form 'JSONString={"otp":"707710","email_only_otp":1,"email":"hemal+siji@edmingle.com"}'
{
  "code": 200,
  "message": "Success",
  "verify_token": "403f0f4eeb7feb24d5739fbe4f6cc3e0681d4fc45b1ac0b6bdf5165607c77529"
}

Access: Public, no API key needed.

Request body: form-data with one field, JSONString, containing this JSON:

BodyJSONString
otpstringrequired
The code the user received.
emailstringOne of email or contact_number
Email the code was sent to.
contact_numberstringOne of email or contact_number
Mobile number the code was sent to.
1 checks the code against email even when contact_number is also sent.
email_otpstring
When verifying a mobile number and an email together, the code sent to the email. Both codes must match.

If only email is sent, the code is checked against the email. Otherwise it is checked against contact_number.

Response200application/json
codeinteger
Example: 200
messagestring
Example: Success

Notes: Fails with "Invalid OTP. Please try again." for a wrong or expired code, and "Email or contact number is required." if both are missing. Rate limit: 30 requests per 1 minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI