Send OTP

POST

https://stageapi.partake.ng/api/v2/auth/otp/send

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Sends an OTP for email verification, phone verification, or password reset. Public (optional auth). Rate-limited to 5 requests per 10 minutes.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/auth/otp/send' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "purpose": "email_verification",
  "channel": "email",
  "actorType": "merchant",
  "email": "yourancestor.irritable069@slmail.me"
}

// purpose: email_verification | phone_verification | password_reset
// channel: email | sms | whatsapp
// actorType: merchant | user
// email: required when channel is '\''email'\''
// phoneNumber: required when channel is '\''sms'\'' or '\''whatsapp'\'' (E.164 format, e.g. +2348012345678)'

Response Example

200 - 200 OK

{
  "success": true,
  "data": {
    "retryAfter": 60
  },
  "message": "OTP sent."
}

Modified at 2026-07-10 13:15:30

Verify OTP