Version 2 of the Verify API is now available! V2 has an improved developer experience and new features. Some of the features of the V2 API include:
- PSD2 Secure Customer Authentication Support
- Improved Visibility and Insights
You are currently viewing Version 1. V1 of the API will be maintained for the time being, but any new features and development will be on Version 2. We encourage you to do any new development with API V2. Check out the migration guide or the API Reference for more information.
As part of Twilio's account security offerings, the Twilio Verify API makes it simple to add phone verification to your web application. It supports codes sent via voice and SMS. To start working with the API, first create an application in the console and get the API Key.
All URLs in the reference documentation use the following base URL:
All requests to the Verify REST API are served over HTTPS. Unencrypted HTTP is not supported.
HTTP requests to the Verify REST API
/protected endpoints are protected with an API Secret you pass as an HTTP header
curl -XPOST 'https://api.authy.com/protected/json/phones/verification/start' \ -H "X-Authy-API-Key: $VERIFY_API_KEY" \ -d via='sms' \ -d phone_number='987-654-3210' \ -d country_code=1
The Verify API Key can be found in the Verify section of the Twilio Console after clicking through to your application.
- Create a new Verify application in the Twilio Console.
- Send a Verification Token via SMS or Voice
- Check the Verification Token
Need help troubleshooting an error or understanding a response?
We maintain helper libraries to abstract phone verification API calls for all of our standard web languages.
We've built out a repository which includes cURL commands for various actions you can take through the API. We've also included Postman collection and environment examples as well.