latestOpenAPI 3.0.3MIT2026-08-10668106.0 KB

bbeffc72789a

Verifications start

Start verification

This method is used by the mobile and web Verification SDKs to start a verification. It can also be used to request a verification from your backend, by making an request.

post/verification/v1/verifications

Headers

Accept-Languagestring

In SMS Verification, value of Accept-Language header is used to determine the language of an SMS message.

Request body

OR
OR
OR
OR

Example request

{
  "identity": {
    "endpoint": "+11235551234"
  },
  "method": "sms"
}

Response

A success response, or an Error.

OR
OR
OR
OR

Example response

{
  "id": "1234567890",
  "method": "sms",
  "_links": [
    {
      "rel": "status",
      "method": "GET"
    }
  ],
  "sms": {
    "template": "Your verification code is {{CODE}}",
    "interceptionTimeout": 32
  }
}