Send OTP

POST

/api/v1/auth/send-otp

auth

Last modified:2026-06-04 22:55:16

Sends a 6-digit OTP to the provided email address. OTP is valid for 5 minutes. Requires the device to be registered first. User is locked for 24 hours after 3 failed attempts.

Success: 200 - OTP sent

Errors: 401 - device not registered | 422 - invalid email
| 429 - rate limited or OTP locked

Request

Body Params application/jsonRequired

Example

{
    "device_id": "device_a1b2c3d4e5",
    "email": "user@example.com"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/send-otp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "device_a1b2c3d4e5",
    "email": "user@example.com"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "OTP sent successfully"
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

Modified at 2026-06-04 22:55:16

Verify OTP and login