---
title: "Send OTP Verification"
method: POST
path: "/v2/verifications"
---

# Send OTP Verification

`POST /v2/verifications`

## Request

- Base URL: `https://apis.cequens.com/mfa`
- URL: `https://apis.cequens.com/mfa/v2/verifications`
- Auth: API key in header `Authorization`

Send an OTP code to the recipient’s phone number or email address to verify his identity, and that the given phone number or email is valid. OTP is sent through supported Channels.

The following channels are supported : SMS ,Voice, Email and Whatsapp.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `channel` string, required: Channel name which correspond to supported channels ; "SMS" or "Email" or "Whatsapp" or "Voice"
  - `recipientIdentifier` string, required: Recipient email address - for “Email” channel OR mobile number – for “SMS”| "Voice" | "Whatsapp" channels
  - `templateCode` string: Template code to use when sending OTP code. If not provided , API uses the value defined in account configuration
  - `otpCodeLength` string: OTP code length with range 4-10 . If not provided , API uses the value defined in account configuration
  - `otpCodeExpiry` string: Time in minutes after which the OTP code expires ; range 3-10 mins. If not provided , API uses the value defined in account configuration
  - `wabTemplateName` string: Whatsapp template name as defined in Whatsapp manager prefixed with "verify_" (Mandatory in case of Whatsapp channel)
  - `wabTemplateLanguage` string: The language of Whatsapp template as defined in Whatsapp manager (Mandatory in case of Whatsapp)
  - `templateVariables` object: Custom variables defined in the template (For SMS, Voice, and Email only)
    - `variable_1` string
    - `variable_2` string

## Response `201`

201

- object
  - `status` integer
  - `replyMessage` string
  - `requestId` string
  - `requestTime` string
  - `data` object
    - `checkCode` string

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404

---

[API](https://skmtc.dev/cequens/apis/cequens-mfa.md) - [All operations](https://skmtc.dev/cequens/apis/cequens-mfa/llms.txt) - [OpenAPI document](https://skmtc.dev/cequens/apis/cequens-mfa/revisions/2df2bc062948?raw)