Twilio Voice REST API

Our Twilio Voice REST API was written to give developers that use Twilio Voice the ability to utilize Least Cost Routing to immediately cuts down on calling costs by 30-50%.

Twilio Voice REST API

Our Twilio Voice REST API was written to help developers who use Twilio Voice add thinQ’s inbound and outbound functionality into the product, instantly saving 30-50% on calling costs.

 

How Does thinQ’s REST API Work?

Our REST API is based on basic HTTP methods, making it easy to write applications using any HTTP client in any programming language or even within your browser. Simple POST calls are used to access the API to place SIP calls. A single parameter can even be changed to switch your call between multiple vendors.

How Do I Get Started?

We don’t charge you to sign up. In fact, we won’t charge you at all for your first 500 minutes. Just register, set up your 3rd party vendor account, and pat yourself on the back all the way to the breakroom, because while everyone else is stuck waiting for downloads, you’ve saved yourself time and money.

Place a new Outbound SIP call

Parameters
Header Parameters

username

  • string Required
  • The username for your thinQ credentials. This needs to be
  • sent in Basic Authentication Base64 encoded format.

 

password

  • string Required
  • The password for your thinQ credentials. This needs to be
  • sent in Basic Authentication Base64 encoded format.

 

Content-Type

  • string Required
  • This should be set to application/json.

Request Body SIP call to a vendor

vendor

  • Array of string Required
  • Values: { “twilio” “plivo” }
  • This is the vendor you are using to place the call.

 

url_resource_twilio

  • string Required
  • This is the callback URL used by Twilio. This will point
    to the TwiML file that contains further instructions.

 

url_resource_plivo

  • string Required
  • This is the callback URL used by Plivo. This will point
    to a file that contains further instructions.

 

to_number

  • string Required
  • The TO phone number that you are calling.

 

from_number

  • string Required
  • The FROM phone number that you are calling.

 

twilio_id

  • string Required
  • The ID assigned to your Twilio account. If you do not use
    Twilio, you do not need this. NOTE: This is only required
    if you set the vendor to Twilio.

 

twilio_token

  • string Required
  • The Token assigned to your Twilio account. If you do not
    use Twilio, you do not need this. NOTE: This is only
    required if you set the vendor to twilio.

 

plivo_id

  • string Required
  • The ID assigned to your Plivo account. If you do not use
    Plivo, you do not need this. NOTE: This is only required
    if you set the vendor to Plivo.

 

plivo_token

  • string Required
  • The Token assigned to your Plivo account. If you do not use
    Plivo, you do not need this. NOTE: This is only required if
    you set the vendor to Plivo.

Definition POST http://rest.thinq.com/vendor/calls/outbound

Request Samples

{
“vendor”: [
“twilio”
],
“url_resource_twilio”: “string”,
“to_number”: “string”,
“from_number”: “string”,
“twilio_id”: “string”,
“twilio_token”: “string”
}

Response Samples 201 CREATED

{
“session_id”: “95d4b-07c6…”
}

Responses

201 CREATED

session_id – string
The session ID returned by the vendor for the call.

400 BAD REQUEST
401 UNAUTHORIZED
404 NOT FOUND
405 METHOD NOT ALLOWED
429 TOO MANY REQUESTS
500 SERVER ERROR

error – string
The error message returned.

503 SERVICE UNAVAILABLE