Rate this page:

Verify API

As part of Twilio's account security offerings, the Twilio Verify API makes it simple to add user verification to your web application. It supports codes sent via voice, SMS, and email.

Base URL

All URLs referenced in the documentation have the following base:

The Twilio REST API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.


HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation. In short, you will use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.

curl -XPOST \
    -d FriendlyName=MyServiceName \

You can find your account SID and auth token in your console.

User Verification Workflow

This guide shows the 3 steps to completing a basic verification. Follow the links for more documentation on advanced features such as service configuration, custom codes, rate limiting, PSD2 compliance, and more.


        Create a Service in one of two ways:

        1. In the Twilio Verify Console
        2. Using the API (code sample on this page)

        A Verification Service is the set of common configurations used to create and check verifications. This includes features like:

        • Friendly Name (used in the Verification message templates)
        • Code Length
        • ...and more

        One verification service can be used to send multiple verification tokens, it is not necessary to create a new service each time.


              This will send a token to the end user through the specified channel. Newly created verifications will show a status of pending. Supported channels are sms, call, and email.

              Learn more about how to turn phone number input into E.164 format.

              Verification documentation.


                    This will check whether the user-provided token is correct.

                    Token Status in response
                    Correct approved
                    Incorrect pending

                    VerificationCheck documentation.

                    You made it through the Verify API Overview. To protect your service against fraud, view our guidance on Preventing Toll Fraud when using Verify.

                    Rate this page:

                    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 by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


                          Thank you for your feedback!

                          We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

                          Sending your feedback...
                          🎉 Thank you for your feedback!
                          Something went wrong. Please try again.

                          Thanks for your feedback!

                          Refer us and get $10 in 3 simple steps!

                          Step 1

                          Get link

                          Get a free personal referral link here

                          Step 2

                          Give $10

                          Your user signs up and upgrade using link

                          Step 3

                          Get $10

                          1,250 free SMSes
                          OR 1,000 free voice mins
                          OR 12,000 chats
                          OR more