NairaSMS
/

Send SMS OTP

Generate and send one-time passwords over SMS.

POST/v1/otp/send

Request Body

OptionTypeRequiredDescription
tostringyesRecipient phone number.
fromstringyesApproved sender ID.
pin_typestringnonumeric or alphanumeric.
pin_lengthnumberno4 to 8 characters.
pin_time_to_livenumbernoExpiry in minutes, 1 to 60.
message_textstringnoMessage template containing the pin placeholder.
pin_placeholderstringnoDefaults to < 1234 >.
{
  "to": "08025671695",
  "from": "NairaSMS",
  "pin_type": "numeric",
  "pin_length": 6,
  "pin_time_to_live": 10,
  "message_text": "Your NairaSMS code is < 1234 >"
}

Sample Response

{
  "data": {
    "smsStatus": "Message Sent",
    "phone_number": "2348025671695",
    "pinId": "c8dcd048-5e7f-4347-8c89-4470c3af0b",
    "status": "200"
  }
}