Twilio - Voice API

by twilio.com

HTTP BasicHTTPSPhone

Overview

This is the public Twilio REST API.

Twilio - Voice is a phone API from twilio.com. Requests are authenticated with HTTP Basic auth. It is served over HTTPS. Its OpenAPI description documents 32 endpoints.

At a glance

Authentication: HTTP Basic
HTTPS: Yes
CORS: Unknown
Category: Phone
Base URL: https://voice.twilio.com
Version: 1.42.0
Endpoints: 32
OpenAPI: Specification ↗
Spec updated: 2023-04-20

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://voice.twilio.com/v1/ByocTrunks" \
  -H "Accept: application/json" \
  -H "Authorization: Basic BASE64_USER_PASSWORD"

JavaScript

const response = await fetch("https://voice.twilio.com/v1/ByocTrunks", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://voice.twilio.com/v1/ByocTrunks",
    headers={
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
DELETE	`/v1/Archives/{Date}/Calls/{Sid}`	Delete an archived call record from Bulk Export. Note: this does not also delete the record from the Voice API.
GET	`/v1/ByocTrunks`	ListByocTrunk
POST	`/v1/ByocTrunks`	CreateByocTrunk
GET	`/v1/ByocTrunks/{Sid}`	FetchByocTrunk
POST	`/v1/ByocTrunks/{Sid}`	UpdateByocTrunk
DELETE	`/v1/ByocTrunks/{Sid}`	DeleteByocTrunk
GET	`/v1/ConnectionPolicies`	ListConnectionPolicy
POST	`/v1/ConnectionPolicies`	CreateConnectionPolicy
GET	`/v1/ConnectionPolicies/{ConnectionPolicySid}/Targets`	ListConnectionPolicyTarget
POST	`/v1/ConnectionPolicies/{ConnectionPolicySid}/Targets`	CreateConnectionPolicyTarget
GET	`/v1/ConnectionPolicies/{ConnectionPolicySid}/Targets/{Sid}`	FetchConnectionPolicyTarget
POST	`/v1/ConnectionPolicies/{ConnectionPolicySid}/Targets/{Sid}`	UpdateConnectionPolicyTarget
DELETE	`/v1/ConnectionPolicies/{ConnectionPolicySid}/Targets/{Sid}`	DeleteConnectionPolicyTarget
GET	`/v1/ConnectionPolicies/{Sid}`	FetchConnectionPolicy
POST	`/v1/ConnectionPolicies/{Sid}`	UpdateConnectionPolicy
DELETE	`/v1/ConnectionPolicies/{Sid}`	DeleteConnectionPolicy
POST	`/v1/DialingPermissions/BulkCountryUpdates`	Create a bulk update request to change voice dialing country permissions of one or more countries identified by the corresponding [ISO country code](https://en.
GET	`/v1/DialingPermissions/Countries`	Retrieve all voice dialing country permissions for this account
GET	`/v1/DialingPermissions/Countries/{IsoCode}`	Retrieve voice dialing country permissions identified by the given ISO country code
GET	`/v1/DialingPermissions/Countries/{IsoCode}/HighRiskSpecialPrefixes`	Fetch the high-risk special services prefixes from the country resource corresponding to the [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
GET	`/v1/IpRecords`	ListIpRecord
POST	`/v1/IpRecords`	CreateIpRecord
GET	`/v1/IpRecords/{Sid}`	FetchIpRecord
POST	`/v1/IpRecords/{Sid}`	UpdateIpRecord
DELETE	`/v1/IpRecords/{Sid}`	DeleteIpRecord
GET	`/v1/Settings`	Retrieve voice dialing permissions inheritance for the sub-account
POST	`/v1/Settings`	Update voice dialing permissions inheritance for the sub-account
GET	`/v1/SourceIpMappings`	ListSourceIpMapping
POST	`/v1/SourceIpMappings`	CreateSourceIpMapping
GET	`/v1/SourceIpMappings/{Sid}`	FetchSourceIpMapping
POST	`/v1/SourceIpMappings/{Sid}`	UpdateSourceIpMapping
DELETE	`/v1/SourceIpMappings/{Sid}`	DeleteSourceIpMapping

Questions

Does the Twilio - Voice API need an API key?

Yes. The Twilio - Voice API uses HTTP Basic authentication; the documentation explains how to get credentials.

Does the Twilio - Voice API support HTTPS?

Yes, the Twilio - Voice API is served over HTTPS.

How many endpoints does the Twilio - Voice API have?

Its OpenAPI description lists 32 endpoints in version 1.42.0. All of them are shown on this page.

What are alternatives to the Twilio - Voice API?

Other Phone APIs include Twilio - Accounts, ETSI GS MEC 010-2 - Part 2: Application lifecycle, rules and requirements management, Twilio - Api, Mobility API, Telnyx API.

Compare alternatives →

Twilio - Accounts

Phone

This is the public Twilio REST API.

HTTP Basic13 endpoints

ETSI GS MEC 010-2 - Part 2: Application lifecycle, rules and requirements management

Phone

ETSI GS MEC 010-2 - Part 2: Application lifecycle, rules and requirements management described using OpenAPI.

No auth16 endpoints

Twilio - Api

Phone

This is the public Twilio REST API.

HTTP Basic199 endpoints

Mobility API

Phone

Transit API can be used to obtain time-aggregated data representing moving the people between various spatial points within the Czech Republic. Having A - 'from' and B - 'to' points, the API can return count of people traveling from A to B or people that are from A and traveling to B, etc. The mobility data is based on moving mobile stations in O2 mobile network.

No auth2 endpoints