OTP

Revoke OTP

Immediately invalidate an active one-time password. Use this when a user requests a new OTP, logs out, or you need to cancel an in-flight verification flow. A revoked OTP cannot be verified.

POST

/v1/otp/revoke

Authorization

Header

X-Emisri-Api-Key: your_secret_key

Required

yes

Request body

application/json

Field	Type	Required	Description
otpId	string	yes	The unique ID of the OTP to revoke. Returned in the response when the OTP was created via the Request OTP endpoint.

Response · 200 OK

application/json

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

Request Samples

Request

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

Response Samples

Response · 200 OK

{
  "success": true,
  "data": {
    "otpId": "otp_e244ba9b208c4dba81",
    "destination": "234812345689",
    "sender": "SENDERNAME",
    "channel": "sms",
    "codeLength": 5,
    "status": "Revoked",
    "expiresAt": "2026-07-03T13:06:22.331Z",
    "verifiedAt": null,
    "revokedAt": "2026-07-03T13:01:56.328Z",
    "createdAt": "2026-07-03T13:01:22.350Z"
  },
  "meta": {
    "requestId": "req_U0kuetfJNlYZ66vb"
  }
}