OTP

Verify OTP

Confirm a one-time password submitted by a user. Submit the OTP alongside the destination number it was sent to — a Verified status in the response confirms a successful match.

POST

/v1/otp/verify

Authorization

Header

X-Emisri-Api-Key: your_secret_key

Required

yes

Request body

application/json

Field	Type	Required	Description
destination	string	yes	The phone number the OTP was originally sent to, in international format without the + sign (e.g. 2348012345678).
otp	string	yes	The one-time password entered by the user, as received via SMS.

Response · 200 OK

application/json

Field	Type	Required	Description
success	boolean	—	true when the OTP was verified successfully.
data	object	—	The response payload.
meta	object	—	Request metadata.

Request Samples

Request

const response = await fetch('https://BASE_URL/v1/otp/verify', {
  method: 'POST',
  headers: {
    'X-Emisri-Api-Key': 'your_secret_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    destination: '234812345689',
    otp: '12345678',
  }),
})
const data = await response.json()

Response Samples

Response · 200 OK

{
  "success": true,
  "data": {
    "otpId": "otp_7a187f9d6f44456490",
    "destination": "234812345689",
    "sender": "SENDERNAME",
    "channel": "sms",
    "codeLength": 8,
    "status": "Verified",
    "expiresAt": "2026-07-03T13:00:20.861Z",
    "verifiedAt": "2026-07-03T12:57:38.627Z",
    "revokedAt": null,
    "createdAt": "2026-07-03T12:55:20.876Z"
  },
  "meta": {
    "requestId": "req_4qSK9s-9V40g8ke7"
  }
}