The Verify API is a robust tool that enables you to send One-Time Passwords (OTP) to your customers via SMS through a simple API call.
The OTP codes are securely generated by our system, ensuring reliability and consistency in the verification process—ideal for use cases such as account registration, login validation, and transaction confirmations.
Activation
To start using our Verify API, please go to the left side menu and click on the Request Activation tab, under the Verify API menu item.
Manage Your Settings
Please fill in all the requested settings from the SMS.to application:
Application Name: choose a name for your new application, we suggest using your platform’s name.
To set the length of your Password format, you need to add:
Min Length: The password minimum length
Max Length: The password maximum length
Max Tries: The maximum number of tries that you will allow your clients to input for each OTP code.
Expiry (sec): The expiry time in seconds for the OTP code to no longer be valid.
Password Type: There are 3 available options that you can choose from: Numeric, Alpha Numeric and Characters.
Callback URL: We highly recommend that you provide a Callback URL to allow our system to notify your backend automatically with asynchronous updates about the verification request’s status —helping you maintain visibility and control over the verification flow. If not provided, results can also be viewed on the platform.
Click on the green submit icon when you’re done.
Make sure to have a balance in your account or proceed to make a payment for your Verify API to be activated by our support team.
Follow the link to access Viber API documentation: SMSto API Documentation
View Results
Once the new app is set up by our specialists, a new submenu item will appear under Verify API, called Verifications.
Here you’ll be able to find the results of your verifications as well as receive them via Callback URL.
The Monthly Volume and Cost Distribution section displays 4 graphs.
1. Monthly OTP Verifications by Statuses:
Displays the total number of OTP verification attempts (sent using our Verify API) each month, grouped by outcome: Verified, Unverified, and Total Attempts.
2. Monthly Verification Fees (Excludes Message Fees):
Shows the monthly cost associated with verification attempts only (sent using our Verify API). This includes successful and failed verifications, but does not include fees for message delivery.
3. Monthly OTP Messages (Excludes Rejected and Failed Messages):
Represents the number of OTP messages successfully sent (for SMS) and successfully delivered (for Viber). Rejected or failed message attempts are excluded from this chart.
4. Monthly OTP Message Fees (Excludes Verifications):
Shows the delivery costs for the successfully sent messages shown in the previous chart. This includes only message fees and excludes any verification-related charges.
In the Verifications area you’ll find all the verifications that you’ve sent to your recipients, and you’ll be able to sort by status or application (in case you have multiple). You can also find a specific one, by searching for a recipient.
You can view the details and export the list.
By clicking on Channel Details you’ll see the Channel, Message ID, Status, Message Cost and Expiry time.