Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Verify API V1 Reference



Verify v1 API has reached End of Sale. It is now closed to new customers and will be fully deprecated in the future.

For new development, we encourage you to use the Verify v2 API. v2 has an improved developer experience and new features, including:

  • Twilio helper libraries in multiple languages
  • PSD2 Secure Customer Authentication Support
  • Improved Visibility and Insights

Existing customers will not be impacted at this time until Verify v1 API has reached End of Life. For more information about migration, see Migrating from 1.x to 2.x.

As part of Twilio's Trusted Activation 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(link takes you to an external page) and get the API Key.

Base URL

base-url page anchor

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.

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 '' \
-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(link takes you to an external page) after clicking through to your application.

Verify Production API Key.

Phone Verification Workflow

phone-verification-workflow page anchor
  1. Create a new Verify application in the Twilio Console.
  2. Send a Verification Token via SMS or Voice
  3. Check the Verification Token

Need help troubleshooting an error or understanding a response?

Rate this page: