Rate this page:

Our API: the basics

The Twilio REST API allows you to query metadata about your account, phone numbers, calls, text messages, and recordings. You can also do some fancy things like initiate outbound calls and send text messages.

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 -G \

You can find your Account SID and Auth Token on your dashboard.


Twilio Accounts have the following subresources. Click on a link to read the API documentation for accessing or modifying each resource:

Phone Numbers




Make calls with Twilio

Twilio’s Voice API makes it easy to make, retrieve, control and monitor calls. Using this REST API, you can make outgoing calls, modify calls in progress, and query metadata about calls. See the Voice API Documentation for guides, REST resources, and troubleshooting tips.

Connect with SIP

Programmable Voice SIP lets you route your voice calls with global reach to any landline phone, mobile phone, browser, mobile app, or any other SIP endpoint. Check out Twilio’s SIP Resources for Voice including SIP Domains, IP Access Control Lists, and Credential Lists.

Send messages with Twilio

Twilio's Messaging API makes it easy to send and receive SMS and MMS messages as well as query meta-data about text messages such as delivery status, associated media, and leverage tools like Copilot to manage your messages globally at scale. Check out our Messaging API Documentation for guides, REST resources, and debugging tips.

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 Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Loading Code Sample...

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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

        Thanks for your feedback!