Twilio Voice API

The Voice API from Twilio — 10 operation(s) for voice.

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/Voice/Settings Check Voice Insights settings · Fetch account settings #
Ask an LLM
“Is Voice Insights Advanced Features turned on for my account?”
“Can I see whether Voice Trace is enabled for one of my subaccounts?”
Tell an agent
Show my current Voice Insights settings.
Show the Voice Insights settings for subaccount {subaccount}.
POST /v1/Voice/Settings Change Voice Insights settings · Update account settings #
Ask an LLM
“How do I switch on Voice Insights Advanced Features?”
“Can I enable Voice Trace for just one subaccount?”
Tell an agent
Turn Voice Insights Advanced Features {advanced} for my account.
Set Voice Trace to {voice_trace} on subaccount {subaccount}.
POST /v1/Voice/{CallSid}/Annotation Annotate a call with feedback · Update annotation #
Ask an LLM
“How do I mark a call as spam in Voice Insights?”
“Can I give a call a 1 to 5 experience score and link it to a support ticket?”
Tell an agent
Score call {call} as {score} out of 5.
Flag call {call} as spam.
GET /v1/Voice/{CallSid}/Annotation Read the annotation on a call · Fetch annotation #
Ask an LLM
“What feedback did we record against a particular call, like its score or quality issues?”
“Was a given call already flagged as spam or tied to an incident?”
Tell an agent
Show the annotation recorded for call {call}.
Get the call score and comment we left on call {call}.
GET /v1/Voice/{Sid} Look up a call in Voice Insights · Fetch call #
Ask an LLM
“Can I pull up the Voice Insights record for a single call by its SID?”
“Where do I find the insights entry point for one specific call?”
Tell an agent
Fetch the Voice Insights call record {call}.
Open insights call {call} so I can see its links to events and metrics.
GET /v1/Voice/Summaries Search call summaries across my account · List call summaries #
Ask an LLM
“Which of my calls in the last day had dropped-call or echo problems?”
“Can I filter call summaries by carrier, country or whether SHAKEN/STIR verified the caller?”
Tell an agent
List call summaries from {from} to {to} over the last {start_time}.
Find calls with call state {state} and direction {direction}.
GET /v1/Voice/{CallSid}/Events List signaling events for a call · List event #
Ask an LLM
“What events happened during a call, step by step?”
“Can I see only the SIP edge events for a call?”
Tell an agent
List the insight events for call {call}.
Show the {edge} events for call {call}.
GET /v1/Voice/{CallSid}/Metrics List quality metrics for a call · List metric #
Ask an LLM
“Where do I get jitter and packet loss style metrics for a single call?”
“Can I split a call's metrics by inbound versus outbound direction?”
Tell an agent
List the call metrics for call {call}.
Show {direction} metrics on the {edge} for call {call}.
GET /v1/Voice/{CallSid}/Summary Get the summary of one call · Fetch summary #
Ask an LLM
“How did a specific call go overall, duration, parties and quality?”
“Can I get a partial summary for a call that just ended?”
Tell an agent
Get the call summary for call {call}.
Include only {processing_state} processing when summarizing call {call}.
GET /v2/Voice/Countries List countries with voice pricing · List voice country #
Ask an LLM
“Which countries have voice calling prices published?”
“What countries can I look up call rates for?”
Tell an agent
List all countries with voice pricing.
Show the voice pricing country list, {page_size} per page.
GET /v2/Voice/Countries/{IsoCountry} Get voice call prices for a country · Fetch voice country #
Ask an LLM
“What does it cost to make and receive calls in Germany?”
“Where can I see inbound and outbound voice rates for one country?”
Tell an agent
Show voice pricing for country {country}.
Get the per-minute call rates for {country}.
GET /v2/Voice/Numbers/{DestinationNumber} Price a call to a phone number · Fetch voice number #
Ask an LLM
“How much will it cost to call a specific phone number?”
“Does the price of a call change depending on which of my numbers I call from?”
Tell an agent
Get the voice price for calling {destination}.
Get the price of calling {destination} from {origination}.

Documentation

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/twilio-voice-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twilio-voice-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Twilio Voice API
  version: 1.52.0
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://www.twilio.com/legal/tos
  description: 'Operations tagged Voice across 2 of this provider''s published API definitions: insights-openapi-original.yml, pricing-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://insights.twilio.com
- url: https://pricing.twilio.com
tags:


# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-voice-api-openapi.yml