Twilio

Twilio Voice API

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

GitHub OpenAPI
Business capability
Voice & Telephony AE-150.50

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

📖
Documentation
https://www.twilio.com/docs/iam/api/account
📖
Documentation
https://www.twilio.com/en-us/blog/insights/ai/what-is-intelligent-virtual-assistant
📖
Documentation
https://www.twilio.com/docs
📖
Documentation
https://www.twilio.com/docs/conversations
📖
Documentation
https://www.twilio.com/docs/marketplace
📖
Documentation
https://www.twilio.com/en-us/messaging
📖
Documentation
https://www.twilio.com/en-us/user-authentication-identity/verify
📖
Documentation
https://www.twilio.com/docs/video
📖
Documentation
https://www.twilio.com/en-us/voice
📖
Documentation
https://www.twilio.com/docs/lookup
📖
Documentation
https://www.twilio.com/docs/flex
📖
Documentation
https://www.twilio.com/docs/sendgrid

Specifications

⚙
OpenAPI
https://artifacts.apis.io/twilio/openapi/twilio-voice-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/twilio/asyncapi/twilio-asyncapi.yml

Other Resources

🔗
Pricing
https://www.twilio.com/en-us/messaging/pricing/conversations-api
🔗
Pricing
https://www.twilio.com/en-us/sms/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/verify/pricing
🔗
Pricing
https://www.twilio.com/en-us/video/pricing
🔗
Pricing
https://www.twilio.com/en-us/voice/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/user-authentication-identity/pricing/lookup
🔗
Pricing
https://www.twilio.com/en-us/flex/pricing
🔗
Pricing
https://www.twilio.com/en-us/products/email-api/pricing

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:twilio-voice-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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://artifacts.apis.io/twilio/openapi/twilio-voice-api-openapi.yml