Twilio Verify API - Twilio
Register for SIGNAL by 8/31 for $250 off. Register now.

Verify API Reference

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.

Base URL

All URLs in the reference documentation use the following base URL:

https://api.authy.com

All requests to the Verify REST API are served over HTTPS. Unencrypted HTTP is not supported.

Authentication

All HTTP requests to the Verify REST API /protected endpoints are protected with an API Secret you pass as an HTTP header X-Authy-API-Key, e.g.:

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.

Verify Production API Key

We've created a version of the Verify API that works with your Twilio API Keys and Twilio endpoints. Contact Twilio Sales if you would like to be part of the beta.

Create a Verify Application

Before you can start the verification process, you need to create a Verify Application.

You can also leverage the REST API to query metadata and manage state for: 

Start a Phone Verification

There are two steps to verifying a user's device with the API: sending a code and checking the code.

Need help troubleshooting an error or understanding a response?

Verify Helper Libraries

We maintain helper libraries to abstract phone verification API calls for all of our standard web languages.

You can use the API directly inside of your iOS application.

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.

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.